diff options
Diffstat (limited to 'documentation/content/en')
23 files changed, 130 insertions, 126 deletions
diff --git a/documentation/content/en/articles/pgpkeys/_index.adoc b/documentation/content/en/articles/pgpkeys/_index.adoc index 51469defd9..ad012a5140 100644 --- a/documentation/content/en/articles/pgpkeys/_index.adoc +++ b/documentation/content/en/articles/pgpkeys/_index.adoc @@ -474,6 +474,9 @@ include::{include-path}kgalazka.key[] === `{avg}` include::{include-path}avg.key[] +=== `{tiga}` +include::{include-path}tiga.key[] + === `{beat}` include::{include-path}beat.key[] diff --git a/documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc b/documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc index ac4afa350c..cdd9147acb 100644 --- a/documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc +++ b/documentation/content/en/books/fdp-primer/asciidoctor-primer/_index.adoc @@ -309,13 +309,9 @@ We are going to use as an example the header of the extref:{freebsd-releng}[Free :images-path: articles/freebsd-releng/ <1> -ifdef::env-beastie[] -ifdef::backend-html5[] - [...] :imagesdir: ../../../images/{images-path} <2> -endif::[] [...] diff --git a/documentation/content/en/books/handbook/audit/_index.adoc b/documentation/content/en/books/handbook/audit/_index.adoc index 0c25670f22..e76b9b6b36 100644 --- a/documentation/content/en/books/handbook/audit/_index.adoc +++ b/documentation/content/en/books/handbook/audit/_index.adoc @@ -60,13 +60,13 @@ FreeBSD implements Sun(TM)'s published Basic Security Module (BSM) Application P This chapter focuses on the installation and configuration of event auditing. It explains audit policies and provides an example audit configuration. -After reading this chapter, you will know: +Read this chapter to learn: * What event auditing is and how it works. * How to configure event auditing on FreeBSD for users and processes. * How to review the audit trail using the audit reduction and review tools. -Before reading this chapter, you should: +Before reading this chapter: * Understand UNIX(R) and FreeBSD basics (crossref:basics[basics,FreeBSD Basics]). * Be familiar with the basics of kernel configuration/compilation (crossref:kernelconfig[kernelconfig,Configuring the FreeBSD Kernel]). diff --git a/documentation/content/en/books/handbook/boot/_index.adoc b/documentation/content/en/books/handbook/boot/_index.adoc index 92a300d167..b8fe0c7e7c 100644 --- a/documentation/content/en/books/handbook/boot/_index.adoc +++ b/documentation/content/en/books/handbook/boot/_index.adoc @@ -59,7 +59,7 @@ This chapter details the configuration options that can be set. It demonstrates how to customize the FreeBSD boot process, including everything that happens until the FreeBSD kernel has started, probed for devices, and started man:init[8]. This occurs when the text color of the boot messages changes from bright white to grey. -After reading this chapter, you will recognize: +Read this chapter to learn: * The components of the FreeBSD bootstrap system and how they interact. * The options that can be passed to the components in the FreeBSD bootstrap in order to control the boot process. diff --git a/documentation/content/en/books/handbook/config/_index.adoc b/documentation/content/en/books/handbook/config/_index.adoc index 7675b13762..6089cf402d 100644 --- a/documentation/content/en/books/handbook/config/_index.adoc +++ b/documentation/content/en/books/handbook/config/_index.adoc @@ -55,11 +55,11 @@ endif::[] One of the important aspects of FreeBSD is proper system configuration. This chapter explains much of the FreeBSD configuration process, including some of the parameters which can be set to tune a FreeBSD system. -Before reading this chapter, you should: +Before reading this chapter: * Understand UNIX(R) and FreeBSD basics (crossref:basics[basics,FreeBSD Basics]). -After reading this chapter, you will know: +Read this chapter to learn: * How to use the various configuration files in [.filename]#/etc#. * The basics of [.filename]#rc.conf# configuration and [.filename]#/usr/local/etc/rc.d# startup scripts. diff --git a/documentation/content/en/books/handbook/cutting-edge/_index.adoc b/documentation/content/en/books/handbook/cutting-edge/_index.adoc index 59e38e2bc9..04f7e9d37d 100644 --- a/documentation/content/en/books/handbook/cutting-edge/_index.adoc +++ b/documentation/content/en/books/handbook/cutting-edge/_index.adoc @@ -58,7 +58,7 @@ However, even official releases are often updated with security and other critic Regardless of the version used, FreeBSD provides all the necessary tools to keep the system updated, and allows for easy upgrades between versions. This chapter describes how to track the development system and the basic tools for keeping a FreeBSD system up-to-date. -After reading this chapter, you will know: +Read this chapter to learn: * How to keep a FreeBSD system up-to-date with freebsd-update or Git. * How to compare the state of an installed system against a known pristine copy. @@ -66,7 +66,7 @@ After reading this chapter, you will know: * The difference between the two development branches: FreeBSD-STABLE and FreeBSD-CURRENT. * How to rebuild and reinstall the entire base system. -Before reading this chapter, you should: +Before reading this chapter: * Properly set up the network connection (crossref:advanced-networking[advanced-networking,Advanced Networking]). * Know how to install additional third-party software (crossref:ports[ports,Installing Applications: Packages and Ports]). @@ -269,7 +269,7 @@ For example: * a kernel module that is built on 13.1 might *not* be suitable for 13.2. -So, with any minor or major OS upgrade, if your package requirements include any kernel module: +So, with any minor or major OS upgrade, if the package requirements include any kernel module: * *be prepared to build the module from source*. @@ -687,8 +687,8 @@ For example: Usually this number is not all that important. However, when bug fixes are committed, this number makes it easy to quickly determine whether the fix is present in the currently running system. Developers will often refer to the hash of the commit (or provide a URL which has that hash), but not the n-number since the hash is the easily visible identifier for a change while the n-number is not. -Security advisories and errata notices will also note an n-number, which can be directly compared against your system. -When you need to use shallow Git clones, you cannot compare n-numbers reliably as the `git rev-list` command counts all the revisions in the repository which a shallow clone omits. +Security advisories and errata notices will also note an n-number, which can be directly compared against the system. +When shallow Git clones are used, n-numbers cannot be compared reliably, as the git rev-list command counts all revisions in the repository, which a shallow clone omits. [[makeworld]] == Updating FreeBSD from Source @@ -1235,7 +1235,7 @@ To create a new boot environment using the man:bectl[8] tool run: Use this boot environment to start the system as it was before the update if something goes wrong. -Save a list of your non-base packages in case you need that later: +Save a list of the non-base packages in case they are needed later: [source,shell] .... @@ -1255,22 +1255,22 @@ FreeBSD-base { } .... -The next step will upgrade your system to the specified version. +The next step will upgrade the system to the specified version. [WARNING] ==== -This step might remove non-base packages, which could include your running desktop environment. +This step might remove non-base packages, which could include the running desktop environment. Be careful. ==== -Set the environment variable ABI to upgrade the major version (replace amd64 with your architecture and 15 with your targeted version). +Set the environment variable ABI to upgrade the major version (replace amd64 with the architecture and 15 with the targeted version). [source,shell] .... # env ABI=FreeBSD:15:amd64 pkg-static upgrade -r FreeBSD-base .... -There will be a prompt to ask if you want to ignore the version mismatch looking like this: +There will be a prompt to ask about ignoring the version mismatch looking like this: [source,shell] .... @@ -1303,12 +1303,12 @@ If something broke, go back and activate the backup boot environment created bef .... Reboot, and the system will be back to the state before upgrading. -If you haven't created a boot environment, you might want to consider getting help from link:https://www.freebsd.org/support/[FreeBSD Support]. +If no boot environment was created before, consider getting help from link:https://www.freebsd.org/support/[FreeBSD Support]. [[build-pkgbase-packages-locally]] === Manually building pkgbase and publishing it to the local network -If you want to start building your own pkgbase packages clone the FreeBSD source tree: +When building custom pkgbase packages clone the FreeBSD source tree: [source,shell] .... diff --git a/documentation/content/en/books/handbook/desktop/_index.adoc b/documentation/content/en/books/handbook/desktop/_index.adoc index 829a63d77c..fd6e26e695 100644 --- a/documentation/content/en/books/handbook/desktop/_index.adoc +++ b/documentation/content/en/books/handbook/desktop/_index.adoc @@ -813,7 +813,7 @@ Functionalities included with Qt Creator are: * code editor with C++, QML and ECMAscript support; * rapid code navigation tools; -* static code checking and style hints as you type; +* static code checking and style hints when typing; * context sensitive help; * visual debugger; * integrated GUI layout and forms designer. diff --git a/documentation/content/en/books/handbook/dtrace/_index.adoc b/documentation/content/en/books/handbook/dtrace/_index.adoc index 755a21404e..b2a8fb93b1 100644 --- a/documentation/content/en/books/handbook/dtrace/_index.adoc +++ b/documentation/content/en/books/handbook/dtrace/_index.adoc @@ -65,13 +65,13 @@ Some ports, such as package:databases/postgresql12-server[] and package:lang/php The official guide to DTrace is maintained by the illumos project at https://illumos.org/books/dtrace/bookinfo.html[illumos Dynamic Tracing Guide]. -After reading this chapter, you will know: +Read this chapter to learn: * What DTrace is and what features it provides. * Differences between the Solaris(TM) DTrace implementation and the one provided by FreeBSD. * How to enable and use DTrace on FreeBSD. -Before reading this chapter, you should: +Before reading this chapter: * Understand UNIX(R) and FreeBSD basics (crossref:basics[basics,FreeBSD Basics]). * Have some familiarity with security and how it pertains to FreeBSD (crossref:security[security,Security]). diff --git a/documentation/content/en/books/handbook/eresources/_index.adoc b/documentation/content/en/books/handbook/eresources/_index.adoc index d237a62b71..b63222c1af 100644 --- a/documentation/content/en/books/handbook/eresources/_index.adoc +++ b/documentation/content/en/books/handbook/eresources/_index.adoc @@ -96,10 +96,10 @@ When in doubt about what list to post a question to, see extref:{freebsd-questio Before posting to any list, please: * learn about how to best use the mailing lists, such as how to help avoid frequently-repeated discussions, by reading the extref:{mailing-list-faq}[Mailing List Frequently Asked Questions] (FAQ) document -* search the archives, to tell whether someone else has already posted what you intend to post. +* search the archives, to tell whether someone else has already posted the same. + +Archive search interfaces include: -Archive search interfaces include: - - https://lists.freebsd.org/search[] (FreeBSD, experimental) - https://www.freebsd.org/search/[] (DuckDuckGo) diff --git a/documentation/content/en/books/handbook/filesystems/_index.adoc b/documentation/content/en/books/handbook/filesystems/_index.adoc index 5e15895838..85652391bc 100644 --- a/documentation/content/en/books/handbook/filesystems/_index.adoc +++ b/documentation/content/en/books/handbook/filesystems/_index.adoc @@ -63,13 +63,13 @@ See crossref:zfs[zfs,The Z File System (ZFS)] for more details. In addition to its native file systems, FreeBSD supports a broad range of file systems from other operating systems. Support for these file systems varies, some require loading kernel modules, while others need additional userland tools. -Before reading this chapter, you should: +Before reading this chapter: * Be familiar with UNIX(R) concepts and crossref:basics[basics,FreeBSD basics]. * Feel comfortable crossref:ports[ports,installing software] in FreeBSD. * Have some understanding of crossref:disks[disks,disks], storage devices, and FreeBSD's naming conventions for devices. -After reading this chapter, you will: +Read this chapter to: * Understand the differences between native and supported file systems. * Know which file systems are supported by FreeBSD and the level of support available. diff --git a/documentation/content/en/books/handbook/firewalls/_index.adoc b/documentation/content/en/books/handbook/firewalls/_index.adoc index 00e7f7688d..399eb35317 100644 --- a/documentation/content/en/books/handbook/firewalls/_index.adoc +++ b/documentation/content/en/books/handbook/firewalls/_index.adoc @@ -71,7 +71,7 @@ Each firewall uses rules to control the access of packets to and from a FreeBSD FreeBSD provides multiple firewalls in order to meet the different requirements and preferences for a wide variety of users. Each user should evaluate which firewall best meets their needs. -After reading this chapter, you will know: +Read this chapter to learn: * How to define packet filtering rules. * The differences between the firewalls built into FreeBSD. @@ -79,7 +79,7 @@ After reading this chapter, you will know: * How to use and configure the IPFW firewall. * How to use and configure the IPFILTER firewall. -Before reading this chapter, you should: +Before reading this chapter: * Understand basic FreeBSD and Internet concepts. diff --git a/documentation/content/en/books/handbook/geom/_index.adoc b/documentation/content/en/books/handbook/geom/_index.adoc index a13b1d626c..47fc93b6e4 100644 --- a/documentation/content/en/books/handbook/geom/_index.adoc +++ b/documentation/content/en/books/handbook/geom/_index.adoc @@ -59,14 +59,14 @@ This chapter covers the use of disks under the GEOM framework in FreeBSD. This includes the major RAID control utilities which use the framework for configuration. This chapter is not a definitive guide to RAID configurations and only GEOM-supported RAID classifications are discussed. -After reading this chapter, you will know: +Read this chapter to learn: * What type of RAID support is available through GEOM. * How to use the base utilities to configure, maintain, and manipulate the various RAID levels. * How to mirror, stripe, encrypt, and remotely connect disk devices through GEOM. * How to troubleshoot disks attached to the GEOM framework. -Before reading this chapter, you should: +Before reading this chapter: * Understand how FreeBSD treats disk devices (crossref:disks[disks,Storage]). * Know how to configure and install a new kernel (crossref:kernelconfig[kernelconfig,Configuring the FreeBSD Kernel]). diff --git a/documentation/content/en/books/handbook/jails/_index.adoc b/documentation/content/en/books/handbook/jails/_index.adoc index fd652694cc..ecc10a1a79 100644 --- a/documentation/content/en/books/handbook/jails/_index.adoc +++ b/documentation/content/en/books/handbook/jails/_index.adoc @@ -361,19 +361,19 @@ The userland for the jail can be obtained from the official FreeBSD download ser Execute the following command to download the userland: -[source,shell] +[source,shell,subs=attributes] .... -# fetch https://download.freebsd.org/ftp/releases/amd64/amd64/14.2-RELEASE/base.txz -o /usr/local/jails/media/14.2-RELEASE-base.txz +# fetch https://download.freebsd.org/ftp/releases/amd64/amd64/{betarel-current}-RELEASE/base.txz -o /usr/local/jails/media/{betarel-current}-RELEASE-base.txz .... Once the download is complete, it will be necessary to extract the contents into the jail directory. Execute the following commands to extract the userland into the jail's directory: -[source,shell] +[source,shell,subs=attributes] .... # mkdir -p /usr/local/jails/containers/classic -# tar -xf /usr/local/jails/media/14.2-RELEASE-base.txz -C /usr/local/jails/containers/classic --unlink +# tar -xf /usr/local/jails/media/{betarel-current}-RELEASE-base.txz -C /usr/local/jails/containers/classic --unlink .... With the userland extracted in the jail directory, it will be necessary to copy the timezone and DNS server files: @@ -449,56 +449,56 @@ For this reason they are created in "read-only" mode so that jails are created w To create the dataset for the template, execute the following command: -[source,shell] +[source,shell,subs=attributes] .... -# zfs create -p zroot/jails/templates/14.2-RELEASE +# zfs create -p zroot/jails/templates/{betarel-current}-RELEASE .... Then execute the following command to download the userland: -[source,shell] +[source,shell,subs=attributes] .... -# fetch https://download.freebsd.org/ftp/releases/amd64/amd64/14.2-RELEASE/base.txz -o /usr/local/jails/media/14.2-RELEASE-base.txz +# fetch https://download.freebsd.org/ftp/releases/amd64/amd64/{betarel-current}-RELEASE/base.txz -o /usr/local/jails/media/{betarel-current}-RELEASE-base.txz .... Once the download is complete, it will be necessary to extract the contents in the template directory by executing the following command: -[source,shell] +[source,shell,subs=attributes] .... -# tar -xf /usr/local/jails/media/14.2-RELEASE-base.txz -C /usr/local/jails/templates/14.2-RELEASE --unlink +# tar -xf /usr/local/jails/media/{betarel-current}-RELEASE-base.txz -C /usr/local/jails/templates/{betarel-current}-RELEASE --unlink .... With the userland extracted in the templates directory, it will be necessary to copy the timezone and DNS server files to the template directory by executing the following command: -[source,shell] +[source,shell,subs=attributes] .... -# cp /etc/resolv.conf /usr/local/jails/templates/14.2-RELEASE/etc/resolv.conf -# cp /etc/localtime /usr/local/jails/templates/14.2-RELEASE/etc/localtime +# cp /etc/resolv.conf /usr/local/jails/templates/{betarel-current}-RELEASE/etc/resolv.conf +# cp /etc/localtime /usr/local/jails/templates/{betarel-current}-RELEASE/etc/localtime .... The next thing to do is update to the latest patch level by executing the following command: -[source,shell] +[source,shell,subs=attributes] .... -# freebsd-update -b /usr/local/jails/templates/14.2-RELEASE/ fetch install +# freebsd-update -b /usr/local/jails/templates/{betarel-current}-RELEASE/ fetch install .... Once the update is finished, the template is ready. To create an OpenZFS Snapshot from the template, execute the following command: -[source,shell] +[source,shell,subs=attributes] .... -# zfs snapshot zroot/jails/templates/14.2-RELEASE@base +# zfs snapshot zroot/jails/templates/{betarel-current}-RELEASE@base .... Once the OpenZFS Snapshot has been created, infinite jails can be created using the OpenZFS clone function. To create a Thin Jail named `thinjail`, execute the following command: -[source,shell] +[source,shell,subs=attributes] .... -# zfs clone zroot/jails/templates/14.2-RELEASE@base zroot/jails/containers/thinjail +# zfs clone zroot/jails/templates/{betarel-current}-RELEASE@base zroot/jails/containers/thinjail .... The last step is to configure the jail. @@ -546,45 +546,45 @@ A jail can be created with reduced duplication of system files by using the Thin The first step is to create the dataset to save the template, execute the following command if using OpenZFS: -[source,shell] +[source,shell,subs=attributes] .... -# zfs create -p zroot/jails/templates/14.2-RELEASE-base +# zfs create -p zroot/jails/templates/{betarel-current}-RELEASE-base .... Or this one if using UFS: -[source,shell] +[source,shell,subs=attributes] .... -# mkdir /usr/local/jails/templates/14.2-RELEASE-base +# mkdir /usr/local/jails/templates/{betarel-current}-RELEASE-base .... Then execute the following command to download the userland: -[source,shell] +[source,shell,subs=attributes] .... -# fetch https://download.freebsd.org/ftp/releases/amd64/amd64/14.2-RELEASE/base.txz -o /usr/local/jails/media/14.2-RELEASE-base.txz +# fetch https://download.freebsd.org/ftp/releases/amd64/amd64/{betarel-current}-RELEASE/base.txz -o /usr/local/jails/media/{betarel-current}-RELEASE-base.txz .... Once the download is complete, it will be necessary to extract the contents in the template directory by executing the following command: -[source,shell] +[source,shell,subs=attributes] .... -# tar -xf /usr/local/jails/media/14.2-RELEASE-base.txz -C /usr/local/jails/templates/14.2-RELEASE-base --unlink +# tar -xf /usr/local/jails/media/{betarel-current}-RELEASE-base.txz -C /usr/local/jails/templates/{betarel-current}-RELEASE-base --unlink .... Once the userland is extracted in the templates directory, it will be necessary to copy the timezone and DNS server files to the template directory by executing the following command: -[source,shell] +[source,shell,subs=attributes] .... -# cp /etc/resolv.conf /usr/local/jails/templates/14.2-RELEASE-base/etc/resolv.conf -# cp /etc/localtime /usr/local/jails/templates/14.2-RELEASE-base/etc/localtime +# cp /etc/resolv.conf /usr/local/jails/templates/{betarel-current}-RELEASE-base/etc/resolv.conf +# cp /etc/localtime /usr/local/jails/templates/{betarel-current}-RELEASE-base/etc/localtime .... With the files moved to the template, the next thing to do is update to the latest patch level by executing the following command: -[source,shell] +[source,shell,subs=attributes] .... -# freebsd-update -b /usr/local/jails/templates/14.2-RELEASE-base/ fetch install +# freebsd-update -b /usr/local/jails/templates/{betarel-current}-RELEASE-base/ fetch install .... In addition to the base template, it is also necessary to create a directory where the `skeleton` will be located. @@ -592,16 +592,16 @@ Some directories will be copied from the template to the `skeleton`. Execute the following command to create the dataset for the `skeleton` in case of using OpenZFS: -[source,shell] +[source,shell,subs=attributes] .... -# zfs create -p zroot/jails/templates/14.2-RELEASE-skeleton +# zfs create -p zroot/jails/templates/{betarel-current}-RELEASE-skeleton .... Or this one in case of using UFS: -[source,shell] +[source,shell,subs=attributes] .... -# mkdir /usr/local/jails/templates/14.2-RELEASE-skeleton +# mkdir /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton .... Then create the `skeleton` directories. @@ -609,22 +609,22 @@ The `skeleton` directories will hold the local directories of the jails. Execute the following commands to create the directories: -[source,shell] +[source,shell,subs=attributes] .... -# mkdir -p /usr/local/jails/templates/14.2-RELEASE-skeleton/home -# mkdir -p /usr/local/jails/templates/14.2-RELEASE-skeleton/usr -# mv /usr/local/jails/templates/14.2-RELEASE-base/etc /usr/local/jails/templates/14.2-RELEASE-skeleton/etc -# mv /usr/local/jails/templates/14.2-RELEASE-base/usr/local /usr/local/jails/templates/14.2-RELEASE-skeleton/usr/local -# mv /usr/local/jails/templates/14.2-RELEASE-base/tmp /usr/local/jails/templates/14.2-RELEASE-skeleton/tmp -# mv /usr/local/jails/templates/14.2-RELEASE-base/var /usr/local/jails/templates/14.2-RELEASE-skeleton/var -# mv /usr/local/jails/templates/14.2-RELEASE-base/root /usr/local/jails/templates/14.2-RELEASE-skeleton/root +# mkdir -p /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton/home +# mkdir -p /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton/usr +# mv /usr/local/jails/templates/{betarel-current}-RELEASE-base/etc /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton/etc +# mv /usr/local/jails/templates/{betarel-current}-RELEASE-base/usr/local /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton/usr/local +# mv /usr/local/jails/templates/{betarel-current}-RELEASE-base/tmp /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton/tmp +# mv /usr/local/jails/templates/{betarel-current}-RELEASE-base/var /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton/var +# mv /usr/local/jails/templates/{betarel-current}-RELEASE-base/root /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton/root .... The next step is to create the symlinks to the `skeleton` by executing the following commands: -[source,shell] +[source,shell,subs=attributes] .... -# cd /usr/local/jails/templates/14.2-RELEASE-base/ +# cd /usr/local/jails/templates/{betarel-current}-RELEASE-base/ # mkdir skeleton # ln -s skeleton/etc etc # ln -s skeleton/home home @@ -638,17 +638,17 @@ With the `skeleton` ready, it will be necessary to copy the data to the jail dir In case of using OpenZFS, OpenZFS snapshots can be used to easily create as many jails as necessary by executing the following commands: -[source,shell] +[source,shell,subs=attributes] .... -# zfs snapshot zroot/jails/templates/14.2-RELEASE-skeleton@base -# zfs clone zroot/jails/templates/14.2-RELEASE-skeleton@base zroot/jails/containers/thinjail +# zfs snapshot zroot/jails/templates/{betarel-current}-RELEASE-skeleton@base +# zfs clone zroot/jails/templates/{betarel-current}-RELEASE-skeleton@base zroot/jails/containers/thinjail .... In case of using UFS the man:cp[1] program can be used by executing the following command: -[source,shell] +[source,shell,subs=attributes] .... -# cp -R /usr/local/jails/templates/14.2-RELEASE-skeleton /usr/local/jails/containers/thinjail +# cp -R /usr/local/jails/templates/{betarel-current}-RELEASE-skeleton /usr/local/jails/containers/thinjail .... Then create the directory in which the base template and the skeleton will be mounted: @@ -688,9 +688,9 @@ thinjail { Then the create the [.filename]#/usr/local/jails/thinjail-nullfs-base.fstab# file as follows: -[.programlisting] +[.programlisting,subs=attributes] .... -/usr/local/jails/templates/14.2-RELEASE-base /usr/local/jails/thinjail-nullfs-base/ nullfs ro 0 0 +/usr/local/jails/templates/{betarel-current}-RELEASE-base /usr/local/jails/thinjail-nullfs-base/ nullfs ro 0 0 /usr/local/jails/containers/thinjail /usr/local/jails/thinjail-nullfs-base/skeleton nullfs rw 0 0 .... diff --git a/documentation/content/en/books/handbook/kernelconfig/_index.adoc b/documentation/content/en/books/handbook/kernelconfig/_index.adoc index 5e035105b6..9769a57018 100644 --- a/documentation/content/en/books/handbook/kernelconfig/_index.adoc +++ b/documentation/content/en/books/handbook/kernelconfig/_index.adoc @@ -56,7 +56,7 @@ The kernel is the core of the FreeBSD operating system. It is responsible for managing memory, enforcing security controls, networking, disk access, and much more. While much of FreeBSD is dynamically configurable, some users may wish to configure and compile a custom kernel. -After reading this chapter, you will know: +Read this chapter to learn: * When to build a custom kernel. * How to take a hardware inventory. @@ -204,7 +204,7 @@ The format of the kernel configuration file is simple. Each line contains a keyword that represents a device or subsystem, an argument, and a brief description. Any text after a `+#+` is considered a comment and ignored. To remove kernel support for a device or subsystem, put a `+#+` at the beginning of the line representing that device or subsystem. -Do not add or remove a `+#+` for any line that you do not understand. +Do not add or remove a `+#+` for any line that is not understand. [WARNING] ==== diff --git a/documentation/content/en/books/handbook/l10n/_index.adoc b/documentation/content/en/books/handbook/l10n/_index.adoc index 83ce371621..73d5f3cd99 100644 --- a/documentation/content/en/books/handbook/l10n/_index.adoc +++ b/documentation/content/en/books/handbook/l10n/_index.adoc @@ -61,7 +61,8 @@ L10n uses the same naming scheme, but from `localization`. The i18n/L10n methods, protocols, and applications allow users to use languages of their choice. This chapter discusses the internationalization and localization features of FreeBSD. -After reading this chapter, you will know: + +Read this chapter to learn: * How locale names are constructed. * How to set the locale for a login shell. @@ -70,7 +71,7 @@ After reading this chapter, you will know: * How to find i18n-compliant applications. * Where to find more information for configuring specific languages. -Before reading this chapter, you should: +Before reading this chapter: * Know how to crossref:ports[ports,install additional third-party applications]. diff --git a/documentation/content/en/books/handbook/linuxemu/_index.adoc b/documentation/content/en/books/handbook/linuxemu/_index.adoc index 1f0c07c540..292af09e70 100644 --- a/documentation/content/en/books/handbook/linuxemu/_index.adoc +++ b/documentation/content/en/books/handbook/linuxemu/_index.adoc @@ -56,11 +56,11 @@ FreeBSD provides *optional* binary compatibility with Linux(R), commonly referre It is available for the x86 (both 32 and 64 bit) and AArch64 architectures. Some Linux-specific operating system features are not yet supported; this mostly happens with functionality specific to hardware or related to system management, such as cgroups or namespaces. -Before reading this chapter, you should: +Before reading this chapter: * Know how to install crossref:ports[ports,additional third-party software]. -After reading this chapter, you will know: +Read this chapter to learn: * How to enable Linux binary compatibility on a FreeBSD system. * How to install additional Linux shared libraries. diff --git a/documentation/content/en/books/handbook/mac/_index.adoc b/documentation/content/en/books/handbook/mac/_index.adoc index 8a99185537..79745411de 100644 --- a/documentation/content/en/books/handbook/mac/_index.adoc +++ b/documentation/content/en/books/handbook/mac/_index.adoc @@ -62,7 +62,7 @@ This is in contrast to the default security mechanism of Discretionary Access Co This chapter focuses on the MAC framework and the set of pluggable security policy modules FreeBSD provides for enabling various security mechanisms. -After reading this chapter, you will know: +Read this chapter to learn: * The terminology associated with the MAC framework. * The capabilities of MAC security policy modules as well as the difference between a labeled and non-labeled policy. @@ -71,7 +71,7 @@ After reading this chapter, you will know: * How to implement a more secure environment using the MAC framework. * How to test the MAC configuration to ensure the framework has been properly implemented. -Before reading this chapter, you should: +Before reading this chapter: * Understand UNIX(R) and FreeBSD basics (crossref:basics[basics,FreeBSD Basics]). * Have some familiarity with security and how it pertains to FreeBSD (crossref:security[security,Security]). diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc index a6e68a7137..0aea47b7b5 100644 --- a/documentation/content/en/books/handbook/ports/_index.adoc +++ b/documentation/content/en/books/handbook/ports/_index.adoc @@ -201,7 +201,7 @@ To switch man:pkg[8] from Quarterly to Latest run the following commands: [source,shell] .... # mkdir -p /usr/local/etc/pkg/repos -# echo 'FreeBSD: { url: "pkg+http://pkg.FreeBSD.org/${ABI}/latest" }' > /usr/local/etc/pkg/repos/FreeBSD.conf +# echo 'FreeBSD: { url: "pkg+https://pkg.FreeBSD.org/${ABI}/latest" }' > /usr/local/etc/pkg/repos/FreeBSD.conf .... Then run this command to update the local package repositories catalogues for the Latest branch: @@ -1303,13 +1303,13 @@ FreeBSD: { Usually it is easiest to serve a poudriere repository to the client machines via HTTP. Set up a webserver to serve up the package directory, for instance: `/usr/local/poudriere/data/packages/13amd64`, where `13amd64` is the name of the build. -If the URL to the package repository is: `http://pkg.example.com/13amd64`, +If the URL to the package repository is: `https://pkg.example.com/13amd64`, then the repository configuration file in `/usr/local/etc/pkg/repos/custom.conf` would look like: [.programlisting] .... custom: { - url: "http://pkg.example.com/13amd64", + url: "https://pkg.example.com/13amd64", enabled: yes, } .... diff --git a/documentation/content/en/books/handbook/wayland/_index.adoc b/documentation/content/en/books/handbook/wayland/_index.adoc index aa402971ff..4d57d605c7 100644 --- a/documentation/content/en/books/handbook/wayland/_index.adoc +++ b/documentation/content/en/books/handbook/wayland/_index.adoc @@ -55,13 +55,13 @@ endif::[] An installation of FreeBSD using bsdinstall does not automatically install a graphical user interface. This chapter describes how to select, install, and configure a Wayland compositor, which provides a graphical environment. -Before reading this chapter, you should: +Before reading this chapter: * Know how to install crossref:ports[ports,additional third-party software]. -* How to identify and configure crossref:x11[x-graphic-card-drivers,drivers for your graphics hardware]. +* Know how to identify and configure crossref:x11[x-graphic-card-drivers,drivers for the graphics hardware]. -After reading this chapter, you will know: +Read this chapter to learn: * How to configure FreeBSD to host a Wayland graphical environment. @@ -376,7 +376,7 @@ The Sway compositor is a tiling compositor that attempts to replace the i3 windo It should work with the user's current i3 configuration; however, new features may require some additional setup. Before starting the Sway installation, ensure that a graphics card (GPU) is installed and configured correctly. -Refer to the section crossref:x11[x-graphic-card-drivers,drivers for your graphics hardware] for guidance. +Refer to the section crossref:x11[x-graphic-card-drivers,drivers for the graphics hardware] for guidance. This step is essential for the Sway compositor to function properly. In the forthcoming examples, a fresh installation without migrating any i3 configuration will be assumed. @@ -403,7 +403,7 @@ Several important changes should be made like the following: # Logo key. Use Mod1 for Alt. input * xkb_rules evdev set $mod Mod4 -# Your preferred terminal emulator +# The preferred terminal emulator set $term alacritty set $lock swaylock -f -c 000000 output "My Workstation" mode 1366x768@60Hz position 1366 0 diff --git a/documentation/content/en/books/handbook/x11/_index.adoc b/documentation/content/en/books/handbook/x11/_index.adoc index 0cefe7bbcd..46d9c3caad 100644 --- a/documentation/content/en/books/handbook/x11/_index.adoc +++ b/documentation/content/en/books/handbook/x11/_index.adoc @@ -59,14 +59,14 @@ This chapter describes how to install and configure the man:Xorg[1] server, which provides the open source X Window System (colloquially X11) used to provide a graphical environment. -Before reading this chapter, you should: +Before reading this chapter: * Know how to install additional third-party software as described in crossref:ports[ports,Installing Applications: Packages and Ports]. -After reading this chapter, you will know: +Read this chapter to learn: -* How to select and install drivers for your graphics processor (GPU). +* How to select and install drivers for the graphics processor (GPU). * The various components of the X Window System, and how they interoperate. * How to install and configure the X.org server. @@ -75,7 +75,7 @@ and how they interoperate. [[x-graphic-card-drivers]] == Graphics Drivers -_**abstract**: Identify your GPU, the port providing a driver for it, +_**abstract**: Identify the GPU, the port providing a driver for it, install it, then enable it to run at subsequent boot with man:sysrc[8]._ Before FreeBSD can render a graphical environment, @@ -403,7 +403,7 @@ Some applications require these additional components to function. [[x-config]] == X.org Configuration -_**abstract**: If the defaults for your monitor or input devices, +_**abstract**: If the defaults for the monitor or input devices, are not satisfactory, crossref:desktop[desktop-synopsis,desktops] include GUIs for configuring them, or they can be configured manually._ @@ -701,7 +701,7 @@ library, a cross-platform effort to support all touch, pointing, and keyboard devices under a unified library. Unless specified otherwise, this is loaded automatically. -Individual device settings for man:libinput[4] can be tuned in your +Individual device settings for man:libinput[4] can be tuned in the crossref:desktop[desktop-synopsis,desktop's] GUI, or manually with package:x11/xinput[xinput] and package:x11/setxkbmap[setxkbmap]. @@ -716,7 +716,7 @@ Both are described in this subsection. ==== Using Atomic Input Configuration Devices supported by man:libinput[4] can be configured -with graphical utilities included with your +with graphical utilities included with the crossref:desktop[desktop-synopsis,desktop] of choice, or manually and atomically at runtime with package:x11/xinput[] and package:x11/setxkbmap[]. @@ -751,9 +751,9 @@ All settings supported by these devices are provided as properties, which can be listed and set atomically. Pointing devices have many configurable properties, keyboards usually need none. -To customize your keyboard, take a look at man:setxkbmap[1]. +To customize the keyboard, take a look at man:setxkbmap[1]. -Once satisfied with your configuration, simply add the lines to your +Once satisfied with the configuration, simply add the lines to the X initialization script such as [.filename]#~/.Xsession# or [.filename]#~/.xinitrc#. [[x-config-input-file]] diff --git a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc index e98d2ff336..bf37987160 100644 --- a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc +++ b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc @@ -1073,7 +1073,11 @@ In addition, proposed category changes just naturally seem to attract controvers Here is the procedure: [.procedure] -. Propose the new category on {freebsd-ports}. Include a detailed rationale for the new category, including why the existing categories are not sufficient, and the list of existing ports proposed to move. (If there are new ports pending in Bugzilla that would fit this category, list them too.) If you are the maintainer and/or submitter, respectively, mention that as it may help the case. +. Propose the new category on {freebsd-ports}. Include a detailed rationale + for the new category, including why the existing categories are not + sufficient, and the list of existing ports proposed to move. (If there are + new ports pending in Bugzilla that would fit this category, list them + too.) Indicating that the updater is also the maintainer or submitter may be helpful to the case. . Participate in the discussion. . If it seems that there is support for the idea, file a PR which includes both the rationale and the list of existing ports that need to be moved. Ideally, this PR would also include these patches: @@ -1121,7 +1125,7 @@ If `DISTVERSION` does not derive a correct `PORTVERSION`, do not use `DISTVERSIO ==== If the upstream version scheme can be derived into a ports-compatible version scheme, set some variable to the upstream version, _do not_ use `DISTVERSION` as the variable name. -Set `PORTVERSION` to the computed version based on the variable you created, and set `DISTNAME` accordingly. +Set `PORTVERSION` to the computed version based on the created variable and set `DISTNAME` accordingly. If the upstream version scheme cannot easily be coerced into a ports-compatible value, set `PORTVERSION` to a sensible value, and set `DISTNAME` with `PORTNAME` with the verbatim upstream version. @@ -2202,7 +2206,7 @@ This is a very interesting feature which can decrease that endless search for th Just picture 2 files in `DISTFILES` and 20 sites in `MASTER_SITES`, the sites slow as hell where [.filename]#beta# is carried by all sites in `MASTER_SITES`, and [.filename]#alpha# can only be found in the 20th site. It would be such a waste to check all of them if the maintainer knew this beforehand, would it not? Not a good start for that lovely weekend! -Now that you have the idea, just imagine more `DISTFILES` and more `MASTER_SITES`. +Once the concept is clear, just imagine more `DISTFILES` and more `MASTER_SITES`. Surely our "distfiles survey meister" would appreciate the relief to network strain that this would bring. In the next sections, information will follow on the FreeBSD implementation of this idea. @@ -2527,7 +2531,7 @@ This does not affect `MASTER_SITES` defined in the [.filename]#Makefile#. [[makefile-maintainer]] == `MAINTAINER` -Set your mail-address here. Please. _:-)_ +Set the mail-address here. Please. _:-)_ Only a single address without the comment part is allowed as a `MAINTAINER` value. The format used is `user@hostname.domain`. diff --git a/documentation/content/en/books/porters-handbook/upgrading/_index.adoc b/documentation/content/en/books/porters-handbook/upgrading/_index.adoc index e61a88dbaf..3da3d330c5 100644 --- a/documentation/content/en/books/porters-handbook/upgrading/_index.adoc +++ b/documentation/content/en/books/porters-handbook/upgrading/_index.adoc @@ -64,7 +64,7 @@ If there is no pending PR, the next step is to send an email to the port's maint That person may already be working on an upgrade, or have a reason to not upgrade the port right now (because of, for example, stability problems of the new version), and there is no need to duplicate their work. Note that unmaintained ports are listed with a maintainer of `ports@FreeBSD.org`, which is just the general ports mailing list, so sending mail there probably will not help in this case. -If the maintainer asks you to do the upgrade or there is no maintainer, then help out FreeBSD by preparing the update! Please do this by using the man:diff[1] command in the base system. +If the maintainer requests to do the upgrade or there is no maintainer, then help out FreeBSD by preparing the update! Please do this by using the man:diff[1] command in the base system. To create a suitable `diff` for a single patch, copy the file that needs patching to [.filename]#something.orig#, save the changes to [.filename]#something# and then create the patch: @@ -88,7 +88,7 @@ To simplify common operations with patch files, use `make makepatch` as describe Other tools exists, like [.filename]#/usr/ports/Tools/scripts/patchtool.py#. Before using it, please read [.filename]#/usr/ports/Tools/scripts/README.patchtool#. -If the port is unmaintained, and you are actively using it, please consider volunteering to become its maintainer. +If the port is unmaintained, and it is actively being used, please consider volunteering to become its maintainer. FreeBSD has over 4000 ports without maintainers, and this is an area where more volunteers are always needed. (For a detailed description of the responsibilities of maintainers, refer to the section in the extref:{developers-handbook}[Developer's Handbook, POLICIES-MAINTAINER].) @@ -125,8 +125,8 @@ They are easier to handle than diffs between "new and old" directories. It is easier to see what has changed, and to update the diff if something was modified in the Ports Collection since the work on it began, or if the committer asks for something to be fixed. Also, a patch generated with man:git-format-patch[1] or man:git-diff[1] can be easily applied with man:git-am[1] or man:git-apply[1] and will save some time for the committer. -Finally, the git patch generated by man:git-format-patch[1] includes your author information and commit messages. -These will be recorded in the log of the repository and this is the recommended way to submit your changes. +Finally, the git patch generated by man:git-format-patch[1] includes the author information and commit messages. +These will be recorded in the log of the repository and this is the recommended way to submit the changes. [source,shell] .... @@ -154,7 +154,7 @@ Also, update the checksum reference in distinfo with `make makesum`. Before making the patch, fetch the latest repository and rebase the changes on top of it. Watch and follow the output carefully. -If any of the files failed to rebase, it means that the upstream files changed while you were editing the same file, and the conflicts need to be resolved manually. +If any of the files failed to rebase, it means that the upstream files changed while local changes happened in the same file, and the conflicts need to be resolved manually. [source,shell] .... @@ -182,7 +182,7 @@ To generate a patch with man:git-format-patch[1]: This will generate a patch named like `0001-foo.patch`. This is the preferred way as it would include author identity, -and it is also easier when you are making a series of changes that +and it is also easier when making a series of changes that are not meant to be squashed together. Alternatively, to generate an unified diff with man:git-diff[1]: @@ -193,13 +193,13 @@ Alternatively, to generate an unified diff with man:git-diff[1]: This will generate a diff named like `foo-1.2.3.diff`. Where `foo` is replaced with the first line of the commit message, i.e., the subject of the commit message. -After patch has been created, you can switch to the main branch for starting other developments. +After patch has been created, switch to the main branch for starting other developments. [source,shell] .... % git checkout main .... -Once the patch is accepted and merged, you can delete the local development branch if you want: +Once the patch is accepted and merged, delete the local development branch if desired: [source,shell] .... % git branch -D my_branch @@ -227,7 +227,7 @@ The format of an entry in this file is: .... YYYYMMDD: AFFECTS: users of portcategory/portname - AUTHOR: Your name <Your email address> + AUTHOR: the name <the email address> Special instructions .... diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc index fbdb346372..84c6123b80 100644 --- a/documentation/content/en/books/porters-handbook/uses/_index.adoc +++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc @@ -1331,7 +1331,7 @@ The framework provides the following variables to be set by the port: `JAVA_VERSION`:: List of space-separated suitable java versions for the port. An optional `\+` -allows you to specify a range of versions. (allowed values `8[+]`, `11[\+]`, +allows specifying a range of versions. (allowed values `8[+]`, `11[\+]`, `17[+]`, `18[\+]`, `19[+]`, `20[\+]`, `21[+]`, `22[\+]`, `22[+]`) `JAVA_OS`:: @@ -1984,7 +1984,7 @@ If the `findplist` argument is provided then contents of the `findlib` target di If the `ldconfig` argument is provided then OCaml's [.filename]#ld.conf# file will be automatically processed. When `dune` is used Dune may install stublibs in site-lib package directory(ies) or in a single directory below `DUNE_LIBDIR` site-lib directory. -Set if your port installs shared libraries into ocaml +Set if the port installs shared libraries into ocaml If the `run` argument is provided add ocamlc to `RUN_DEPENDS`. |