diff options
Diffstat (limited to 'documentation/content/en/books/handbook/ports')
| -rw-r--r-- | documentation/content/en/books/handbook/ports/_index.adoc | 33 | ||||
| -rw-r--r-- | documentation/content/en/books/handbook/ports/_index.po | 723 |
2 files changed, 440 insertions, 316 deletions
diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc index fe7001ab82..0aea47b7b5 100644 --- a/documentation/content/en/books/handbook/ports/_index.adoc +++ b/documentation/content/en/books/handbook/ports/_index.adoc @@ -57,7 +57,7 @@ In addition, FreeBSD provides two complementary technologies for installing thir for installing from source, and packages, for installing from pre-built binaries. Either method may be used to install software from local media or from the network. -After reading this chapter, you will know: +Read this chapter to learn: * The difference between binary packages and ports. * How to find third-party software that has been ported to FreeBSD. @@ -86,7 +86,7 @@ A FreeBSD package contains pre-compiled copies of all the commands for an applic A package can be manipulated with the man:pkg[8] commands, such as `pkg install`. While the two technologies are similar, packages and ports each have their own strengths. -Select the technology that meets your requirements for installing a particular application. +Select the technology that meets the needs for installing a particular application. .Package Benefits * A compressed package tarball is typically smaller than the compressed tarball containing the source code for the application. @@ -99,7 +99,7 @@ Select the technology that meets your requirements for installing a particular a + In some cases, multiple packages will exist for the same application with different settings. For example, NGINX(R) is available as a `nginx` package and a `nginx-lite` package, the former has many more options enabled, but this in turn requires many things to be installed as dependencies for it to work, thus increasing space consumption and attack surface. + -The transitive dependencies can grow quite large, for example the full `nginx` package will pull in several X libraries which can be quite surprising, so building from ports allow you to choose only the options you need without a "kitchen sink" approach. In some cases, multiple packages will exist for the same application to specify certain settings. +The transitive dependencies can grow quite large, for example the full `nginx` package will pull in several X libraries which can be quite surprising, so building from ports allows to choose only the options needed without a "kitchen sink" approach. In some cases, multiple packages will exist for the same application to specify certain settings. * The licensing conditions of some software forbid binary distribution. Such software must be distributed as source code which must be compiled by the end-user. * Some people do not trust binary distributions or prefer to read through source code in order to look for potential problems. * Source code is needed in order to apply custom patches. @@ -165,7 +165,7 @@ The package management tool is not yet installed on your system. Do you want to fetch and install it now? [y/N] .... -man:pkg[7] will intercept the command, and if you confirm that is your intention, download the man:pkg[8] tarball, install man:pkg[8] from it, bootstrap the local package database and then proceed to run the command you originally requested. +man:pkg[7] will intercept the command, and when confirmed, downloads the man:pkg[8] tarball, installs man:pkg[8] from it, bootstraps the local package database and then proceeds to run the command originally requested. More recent versions of man:pkg[7] understand `pkg -N` as a test to see if man:pkg[8] is installed without triggering the installation, and conversely, pkg bootstrap[-f] to install man:pkg[8] (or force it to be reinstalled) without performing any other actions. @@ -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: @@ -695,7 +695,7 @@ By default, the Ports Collection itself is stored as a subdirectory of `/usr/por Before installing and using the Ports Collection, please be aware that it is generally ill-advised to use the Ports Collection in conjunction with the binary packages provided via pkg to install software. pkg, by default, tracks quarterly branch-releases of the ports tree and not HEAD. Dependencies could be different for a port in HEAD compared to its counterpart in a quarterly branch release and this could result in conflicts between dependencies installed by pkg and those from the Ports Collection. -If the Ports Collection and pkg must be used in conjunction, then be sure that your Ports Collection and pkg are on the same branch release of the ports tree. +If the Ports Collection and pkg must be used in conjunction, then be sure that the Ports Collection and pkg are on the same branch release of the ports tree. ==== The Ports Collection contains directories for software categories. @@ -730,8 +730,8 @@ If more control over the ports tree is needed or if local changes need to be mai Git can be used to obtain the Ports Collection. Refer to extref:{committers-guide}[the Git Primer, git-primer] for a detailed description of Git. -We add --depth 1 to the git command line to clone the tree without obtaining the commit history, which saves time and is acceptable for most users. -If you have your own changes to the ports tree, or need the history for any reason, omit the --depth 1 argument below. +We add `--depth 1` to the git command line to clone the tree without obtaining the commit history, which saves time and is acceptable for most users. +When maintaining custom changes to the ports tree, or need the history for any reason, omit the `--depth 1` argument below. . Git must be installed before it can be used to check out the ports tree. If a copy of the ports tree is already present, install Git like this: + @@ -773,7 +773,8 @@ If the ports tree is not available, or pkg is being used to manage packages, Git + [source,shell] .... -# git -C /usr/ports switch 2023Q1 +# git -C /usr/ports fetch --depth 1 origin 2023Q2:2023Q2 +# git -C /usr/ports switch 2023Q2 .... **** @@ -875,7 +876,7 @@ and ports options screens no longer appear, to be certain that all dependency op There are several ways to revisit a port's build options menu in order to add, remove, or change these options after a port has been built. One method is to `cd` into the directory containing the port and type `make config`. Another option is to use `make showconfig`. -Another option is to execute `make rmconfig` which will remove all selected options and allow you to start over. +Another option is to execute `make rmconfig` which will remove all selected options and allows to start over. All of these options, and others, are explained in great detail in man:ports[7]. The ports system uses man:fetch[1] to download the source files, which supports various environment variables. @@ -921,7 +922,7 @@ will compile the port in `/usr/ports` and install it in `/usr/home/example/local will combine the two. These can also be set as environmental variables. -Refer to the manual page for your shell for instructions on how to set an environmental variable. +Refer to the manual page for the shell for instructions on how to set an environmental variable. [[ports-removing]] === Removing Installed Ports @@ -983,7 +984,7 @@ Synth is a newer alternative. [NOTE] ==== The choice of which tool is best for a particular system is up to the system administrator. -It is recommended practice to back up your data before using any of these tools. +It is recommended practice to back up data before using any of these tools. ==== [[portmaster]] @@ -1302,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, } .... @@ -1361,5 +1362,5 @@ Instead, any fixes and support come from the general community who subscribe to ==== + If there is no response to the email, use Bugzilla to submit a bug report using the instructions in extref:{problem-reports}[Writing FreeBSD Problem Reports]. -. Fix it! The extref:{porters-handbook}[Porter's Handbook] includes detailed information on the ports infrastructure so that you can fix the occasional broken port or even submit your own! -. Install the package instead of the port using the instructions in crossref:ports[pkgng-intro, Using pkg for Binary Package Management]. + +. Fix it! The extref:{porters-handbook}[Porter's Handbook] includes detailed information on the ports infrastructure, enabling the fixing of occasional broken ports or the submission of new ones. Install the package instead of the port using the instructions in crossref:ports[pkgng-intro, Using pkg for Binary Package Management]. diff --git a/documentation/content/en/books/handbook/ports/_index.po b/documentation/content/en/books/handbook/ports/_index.po index 3d9fe0088e..47edb30f58 100644 --- a/documentation/content/en/books/handbook/ports/_index.po +++ b/documentation/content/en/books/handbook/ports/_index.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2025-05-01 19:56-0300\n" +"POT-Creation-Date: 2025-11-08 16:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -59,7 +59,7 @@ msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ports/_index.adoc:61 -msgid "After reading this chapter, you will know:" +msgid "Read this chapter to learn:" msgstr "" #. type: Plain text @@ -152,8 +152,8 @@ msgstr "" #: documentation/content/en/books/handbook/ports/_index.adoc:90 msgid "" "While the two technologies are similar, packages and ports each have their " -"own strengths. Select the technology that meets your requirements for " -"installing a particular application." +"own strengths. Select the technology that meets the needs for installing a " +"particular application." msgstr "" #. type: Block title @@ -220,9 +220,9 @@ msgstr "" msgid "" "The transitive dependencies can grow quite large, for example the full " "`nginx` package will pull in several X libraries which can be quite " -"surprising, so building from ports allow you to choose only the options you " -"need without a \"kitchen sink\" approach.In some cases, multiple packages " -"will exist for the same application to specify certain settings." +"surprising, so building from ports allows to choose only the options needed " +"without a \"kitchen sink\" approach. In some cases, multiple packages will " +"exist for the same application to specify certain settings." msgstr "" #. type: Plain text @@ -390,16 +390,16 @@ msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ports/_index.adoc:161 -#: documentation/content/en/books/handbook/ports/_index.adoc:246 -#: documentation/content/en/books/handbook/ports/_index.adoc:278 -#: documentation/content/en/books/handbook/ports/_index.adoc:313 -#: documentation/content/en/books/handbook/ports/_index.adoc:340 -#: documentation/content/en/books/handbook/ports/_index.adoc:385 -#: documentation/content/en/books/handbook/ports/_index.adoc:440 -#: documentation/content/en/books/handbook/ports/_index.adoc:467 -#: documentation/content/en/books/handbook/ports/_index.adoc:497 -#: documentation/content/en/books/handbook/ports/_index.adoc:522 -#: documentation/content/en/books/handbook/ports/_index.adoc:540 +#: documentation/content/en/books/handbook/ports/_index.adoc:292 +#: documentation/content/en/books/handbook/ports/_index.adoc:324 +#: documentation/content/en/books/handbook/ports/_index.adoc:359 +#: documentation/content/en/books/handbook/ports/_index.adoc:386 +#: documentation/content/en/books/handbook/ports/_index.adoc:431 +#: documentation/content/en/books/handbook/ports/_index.adoc:486 +#: documentation/content/en/books/handbook/ports/_index.adoc:513 +#: documentation/content/en/books/handbook/ports/_index.adoc:543 +#: documentation/content/en/books/handbook/ports/_index.adoc:568 +#: documentation/content/en/books/handbook/ports/_index.adoc:586 msgid "The output should be similar to the following:" msgstr "" @@ -414,10 +414,9 @@ msgstr "" #. type: Plain text #: documentation/content/en/books/handbook/ports/_index.adoc:169 msgid "" -"man:pkg[7] will intercept the command, and if you confirm that is your " -"intention, download the man:pkg[8] tarball, install man:pkg[8] from it, " -"bootstrap the local package database and then proceed to run the command you " -"originally requested." +"man:pkg[7] will intercept the command, and when confirmed, downloads the " +"man:pkg[8] tarball, installs man:pkg[8] from it, bootstraps the local " +"package database and then proceeds to run the command originally requested." msgstr "" #. type: Plain text @@ -496,7 +495,7 @@ msgstr "" #, no-wrap msgid "" "# mkdir -p /usr/local/etc/pkg/repos\n" -"# echo 'FreeBSD: { url: \"pkg+http://pkg.FreeBSD.org/${ABI}/latest\" }' > /usr/local/etc/pkg/repos/FreeBSD.conf\n" +"# echo 'FreeBSD: { url: \"pkg+https://pkg.FreeBSD.org/${ABI}/latest\" }' > /usr/local/etc/pkg/repos/FreeBSD.conf\n" msgstr "" #. type: Plain text @@ -515,18 +514,145 @@ msgstr "" #. type: Title === #: documentation/content/en/books/handbook/ports/_index.adoc:215 #, no-wrap +msgid "Kernel modules repositories" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/ports/_index.adoc:222 +msgid "" +"The kernel module repositories allow users to install ready to use kernel " +"modules like the ones used for graphic drivers and specific hardware. " +"Starting with FreeBSD 14.3, the FreeBSD Project provides kernel modules " +"built for every supported version. To create such a repository configuration " +"if it does not exist, add the following to [.filename]#/usr/local/etc/pkg/" +"repos/kmods.conf#:" +msgstr "" + +#. type: delimited block . 4 +#: documentation/content/en/books/handbook/ports/_index.adoc:231 +#, no-wrap +msgid "" +"FreeBSD-kmods: {\n" +" url: \"pkg+https://pkg.FreeBSD.org/${ABI}/KMODSFLAVOR\",\n" +" mirror_type: \"srv\",\n" +" signature_type: \"fingerprints\",\n" +" fingerprints: \"/usr/share/keys/pkg\",\n" +" enabled: yes\n" +"}\n" +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/ports/_index.adoc:234 +msgid "" +"`KMODSFLAVOR` respects the following pattern: " +"`kmods_PORTBRANCH_MINORRELEASE`." +msgstr "" + +#. type: Plain text +#: documentation/content/en/books/handbook/ports/_index.adoc:236 +msgid "For instance:" +msgstr "" + +#. type: Block title +#: documentation/content/en/books/handbook/ports/_index.adoc:237 +#, no-wrap +msgid "Kmodsflavor" +msgstr "" + +#. type: Table +#: documentation/content/en/books/handbook/ports/_index.adoc:241 +#, no-wrap +msgid "FreeBSD Release" +msgstr "" + +#. type: Table +#: documentation/content/en/books/handbook/ports/_index.adoc:241 +#, no-wrap +msgid "ports main" +msgstr "" + +#. type: Table +#: documentation/content/en/books/handbook/ports/_index.adoc:243 +#, no-wrap +msgid "ports quarterly" +msgstr "" + +#. type: Table +#: documentation/content/en/books/handbook/ports/_index.adoc:244 +#, no-wrap +msgid "FreeBSD 14.2-RELEASE" +msgstr "" + +#. type: Table +#: documentation/content/en/books/handbook/ports/_index.adoc:245 +#, no-wrap +msgid "kmods_latest_2" +msgstr "" + +#. type: Table +#: documentation/content/en/books/handbook/ports/_index.adoc:247 +#, no-wrap +msgid "kmods_quarterly_2" +msgstr "" + +#. type: Table +#: documentation/content/en/books/handbook/ports/_index.adoc:248 +#, no-wrap +msgid "FreeBSD 14.3-RELEASE" +msgstr "" + +#. type: Table +#: documentation/content/en/books/handbook/ports/_index.adoc:249 +#, no-wrap +msgid "kmods_latest_3" +msgstr "" + +#. type: Table +#: documentation/content/en/books/handbook/ports/_index.adoc:251 +#, no-wrap +msgid "kmods_quarterly_3" +msgstr "" + +#. type: Table +#: documentation/content/en/books/handbook/ports/_index.adoc:252 +#, no-wrap +msgid "FreeBSD 14.3-STABLE" +msgstr "" + +#. type: Table +#: documentation/content/en/books/handbook/ports/_index.adoc:253 +#: documentation/content/en/books/handbook/ports/_index.adoc:257 +#, no-wrap +msgid "kmods_latest" +msgstr "" + +#. type: Table +#: documentation/content/en/books/handbook/ports/_index.adoc:255 +#, no-wrap +msgid "kmods_quarterly" +msgstr "" + +#. type: Table +#: documentation/content/en/books/handbook/ports/_index.adoc:256 +#, no-wrap +msgid "FreeBSD 15.0-CURRENT" +msgstr "" + +#. type: Title === +#: documentation/content/en/books/handbook/ports/_index.adoc:261 +#, no-wrap msgid "Configure pkg" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:219 +#: documentation/content/en/books/handbook/ports/_index.adoc:265 msgid "" "man:pkg.conf[5] is the system-wide configuration file used by the man:pkg[8] " "tools. The default location of this file is `/usr/local/etc/pkg.conf`." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:224 +#: documentation/content/en/books/handbook/ports/_index.adoc:270 msgid "" "FreeBSD does not need to have a `pkg.conf` file. Many installations will " "work well with no `pkg.conf` at all or with an empty `pkg.conf` (other than " @@ -534,12 +660,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:227 +#: documentation/content/en/books/handbook/ports/_index.adoc:273 msgid "Lines in the file beginning with a \"#\" are\tcomments and are ignored." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:230 +#: documentation/content/en/books/handbook/ports/_index.adoc:276 msgid "" "The file is in UCL format. For more information on the syntax of " "man:libucl[3], please visit the link:https://github.com/vstakhov/" @@ -547,38 +673,38 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:232 +#: documentation/content/en/books/handbook/ports/_index.adoc:278 msgid "" "The following types of options are recognized - boolean, string and list " "options." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:234 +#: documentation/content/en/books/handbook/ports/_index.adoc:280 msgid "" "A boolean option is marked as enabled if one of the following values is " "specified in the configuration file - YES, TRUE and ON." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:236 +#: documentation/content/en/books/handbook/ports/_index.adoc:282 #, no-wrap msgid "Searching Packages" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:239 +#: documentation/content/en/books/handbook/ports/_index.adoc:285 msgid "To search a package man:pkg-search[8] can be used:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:243 +#: documentation/content/en/books/handbook/ports/_index.adoc:289 #, no-wrap msgid "# pkg search nginx\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:263 +#: documentation/content/en/books/handbook/ports/_index.adoc:309 #, no-wrap msgid "" "modsecurity3-nginx-1.0.3 Instruction detection and prevention engine / nginx Wrapper\n" @@ -598,13 +724,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:266 +#: documentation/content/en/books/handbook/ports/_index.adoc:312 #, no-wrap msgid "Installing and Fetching Packages" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:271 +#: documentation/content/en/books/handbook/ports/_index.adoc:317 msgid "" "To install a binary package man:pkg-install[8] can be used. This command " "uses repository data to determine which version of the software to install " @@ -612,13 +738,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:275 +#: documentation/content/en/books/handbook/ports/_index.adoc:321 #, no-wrap msgid "# pkg install curl\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:285 +#: documentation/content/en/books/handbook/ports/_index.adoc:331 #, no-wrap msgid "" "Updating FreeBSD repository catalogue...\n" @@ -628,7 +754,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:296 +#: documentation/content/en/books/handbook/ports/_index.adoc:342 #, no-wrap msgid "" "New packages to be INSTALLED:\n" @@ -644,13 +770,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:298 +#: documentation/content/en/books/handbook/ports/_index.adoc:344 #, no-wrap msgid "Number of packages to be installed: 9\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:301 +#: documentation/content/en/books/handbook/ports/_index.adoc:347 #, no-wrap msgid "" "The process will require 11 MiB more space.\n" @@ -658,26 +784,26 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:303 +#: documentation/content/en/books/handbook/ports/_index.adoc:349 #, no-wrap msgid "Proceed with this action? [y/N]\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:306 +#: documentation/content/en/books/handbook/ports/_index.adoc:352 msgid "" "The new package and any additional packages that were installed as " "dependencies can be seen in the installed packages list:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:310 +#: documentation/content/en/books/handbook/ports/_index.adoc:356 #, no-wrap msgid "# pkg info\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:326 +#: documentation/content/en/books/handbook/ports/_index.adoc:372 #, no-wrap msgid "" "ca_root_nss-3.83 Root certificate bundle from the Mozilla Project\n" @@ -693,30 +819,30 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:330 +#: documentation/content/en/books/handbook/ports/_index.adoc:376 msgid "" "To fetch a package and install it later or in another place use man:pkg-" "fetch[8]. For example, to download `nginx-lite`:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:334 +#: documentation/content/en/books/handbook/ports/_index.adoc:380 #, no-wrap msgid "# pkg fetch -d -o /usr/home/user/packages/ nginx-lite\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:337 +#: documentation/content/en/books/handbook/ports/_index.adoc:383 msgid "`-d`: used to fetch all the dependencies" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:338 +#: documentation/content/en/books/handbook/ports/_index.adoc:384 msgid "`-o`: used to specify the download directory" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:347 +#: documentation/content/en/books/handbook/ports/_index.adoc:393 #, no-wrap msgid "" "Updating FreeBSD repository catalogue...\n" @@ -726,7 +852,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:351 +#: documentation/content/en/books/handbook/ports/_index.adoc:397 #, no-wrap msgid "" "New packages to be FETCHED:\n" @@ -735,13 +861,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:353 +#: documentation/content/en/books/handbook/ports/_index.adoc:399 #, no-wrap msgid "Number of packages to be fetched: 2\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:356 +#: documentation/content/en/books/handbook/ports/_index.adoc:402 #, no-wrap msgid "" "The process will require 2 MiB more space.\n" @@ -749,37 +875,37 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:358 +#: documentation/content/en/books/handbook/ports/_index.adoc:404 #, no-wrap msgid "Proceed with fetching packages? [y/N]:\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:361 +#: documentation/content/en/books/handbook/ports/_index.adoc:407 msgid "" "To install the downloaded packages man:pkg-install[8] can be used as follows:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:365 +#: documentation/content/en/books/handbook/ports/_index.adoc:411 #, no-wrap msgid "# cd /usr/home/user/packages/\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:370 +#: documentation/content/en/books/handbook/ports/_index.adoc:416 #, no-wrap msgid "# pkg install nginx-lite-1.22.1,3.pkg\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:373 +#: documentation/content/en/books/handbook/ports/_index.adoc:419 #, no-wrap msgid "Obtaining Information About Installed Packages" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:376 +#: documentation/content/en/books/handbook/ports/_index.adoc:422 msgid "" "Information about the packages installed on a system can be viewed by " "running man:pkg-info[8] which, when run without any switches, will list the " @@ -787,18 +913,18 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:378 +#: documentation/content/en/books/handbook/ports/_index.adoc:424 msgid "For example, to see which version of pkg is installed, run:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:382 +#: documentation/content/en/books/handbook/ports/_index.adoc:428 #, no-wrap msgid "# pkg info pkg\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:411 +#: documentation/content/en/books/handbook/ports/_index.adoc:457 #, no-wrap msgid "" "pkg-1.19.0\n" @@ -827,45 +953,45 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:413 +#: documentation/content/en/books/handbook/ports/_index.adoc:459 #, no-wrap msgid "WWW: https://github.com/freebsd/pkg\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:416 +#: documentation/content/en/books/handbook/ports/_index.adoc:462 #, no-wrap msgid "Upgrading Installed Packages" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:419 +#: documentation/content/en/books/handbook/ports/_index.adoc:465 msgid "" "Installed packages can be upgraded to their latest versions using man:pkg-" "upgrade[8]:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:423 +#: documentation/content/en/books/handbook/ports/_index.adoc:469 #, no-wrap msgid "# pkg upgrade\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:426 +#: documentation/content/en/books/handbook/ports/_index.adoc:472 msgid "" "This command will compare the installed versions with those available in the " "repository catalogue and upgrade them from the repository." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:428 +#: documentation/content/en/books/handbook/ports/_index.adoc:474 #, no-wrap msgid "Auditing Installed Packages" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:433 +#: documentation/content/en/books/handbook/ports/_index.adoc:479 msgid "" "Software vulnerabilities are regularly discovered in third-party " "applications. To address this, pkg includes a built-in auditing mechanism. " @@ -874,13 +1000,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:437 +#: documentation/content/en/books/handbook/ports/_index.adoc:483 #, no-wrap msgid "# pkg audit -F\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:452 +#: documentation/content/en/books/handbook/ports/_index.adoc:498 #, no-wrap msgid "" "Fetching vuln.xml.xz: 100% 976 KiB 499.5kB/s 00:02\n" @@ -895,30 +1021,30 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:455 +#: documentation/content/en/books/handbook/ports/_index.adoc:501 #, no-wrap msgid "Removing Packages" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:458 +#: documentation/content/en/books/handbook/ports/_index.adoc:504 msgid "" "Packages that are no longer needed can be removed with man:pkg-delete[8]." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:460 +#: documentation/content/en/books/handbook/ports/_index.adoc:506 msgid "For example:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:464 +#: documentation/content/en/books/handbook/ports/_index.adoc:510 #, no-wrap msgid "# pkg delete curl\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:472 +#: documentation/content/en/books/handbook/ports/_index.adoc:518 #, no-wrap msgid "" "Checking integrity... done (0 conflicting)\n" @@ -926,7 +1052,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:475 +#: documentation/content/en/books/handbook/ports/_index.adoc:521 #, no-wrap msgid "" "Installed packages to be REMOVED:\n" @@ -934,20 +1060,20 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:477 -#: documentation/content/en/books/handbook/ports/_index.adoc:507 +#: documentation/content/en/books/handbook/ports/_index.adoc:523 +#: documentation/content/en/books/handbook/ports/_index.adoc:553 #, no-wrap msgid "Number of packages to be removed: 1\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:479 +#: documentation/content/en/books/handbook/ports/_index.adoc:525 #, no-wrap msgid "The operation will free 4 MiB.\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:483 +#: documentation/content/en/books/handbook/ports/_index.adoc:529 #, no-wrap msgid "" "Proceed with deinstallation packages? [y/N]: y\n" @@ -956,13 +1082,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:486 +#: documentation/content/en/books/handbook/ports/_index.adoc:532 #, no-wrap msgid "Automatically Removing Unused Packages" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:490 +#: documentation/content/en/books/handbook/ports/_index.adoc:536 msgid "" "Removing a package may leave behind dependencies which are no longer " "required. Unneeded packages that were installed as dependencies (leaf " @@ -971,13 +1097,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:494 +#: documentation/content/en/books/handbook/ports/_index.adoc:540 #, no-wrap msgid "# pkg autoremove\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:502 +#: documentation/content/en/books/handbook/ports/_index.adoc:548 #, no-wrap msgid "" "Checking integrity... done (0 conflicting)\n" @@ -985,7 +1111,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:505 +#: documentation/content/en/books/handbook/ports/_index.adoc:551 #, no-wrap msgid "" "Installed packages to be REMOVED:\n" @@ -993,19 +1119,19 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:509 +#: documentation/content/en/books/handbook/ports/_index.adoc:555 #, no-wrap msgid "The operation will free 723 KiB.\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:511 +#: documentation/content/en/books/handbook/ports/_index.adoc:557 #, no-wrap msgid "Proceed with deinstalling packages? [y/N]:\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:515 +#: documentation/content/en/books/handbook/ports/_index.adoc:561 msgid "" "Packages installed as dependencies are called _automatic_ packages. Non-" "automatic packages, i.e the packages that were explicitly installed not as a " @@ -1013,13 +1139,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:519 +#: documentation/content/en/books/handbook/ports/_index.adoc:565 #, no-wrap msgid "# pkg prime-list\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:528 +#: documentation/content/en/books/handbook/ports/_index.adoc:574 #, no-wrap msgid "" "nginx\n" @@ -1028,7 +1154,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:533 +#: documentation/content/en/books/handbook/ports/_index.adoc:579 msgid "" "`pkg prime-list` is an alias command declared in `/usr/local/etc/pkg.conf`. " "There are many others that can be used to query the package database of the " @@ -1037,13 +1163,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:537 +#: documentation/content/en/books/handbook/ports/_index.adoc:583 #, no-wrap msgid "# pkg prime-origins\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:546 +#: documentation/content/en/books/handbook/ports/_index.adoc:592 #, no-wrap msgid "" "www/nginx\n" @@ -1052,7 +1178,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:549 +#: documentation/content/en/books/handbook/ports/_index.adoc:595 msgid "" "This list can be used to rebuild all packages installed on a system using " "build tools such as package:ports-mgmt/poudriere[] or package:ports-mgmt/" @@ -1060,42 +1186,42 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:551 +#: documentation/content/en/books/handbook/ports/_index.adoc:597 msgid "Marking an installed package as automatic can be done using:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:555 +#: documentation/content/en/books/handbook/ports/_index.adoc:601 #, no-wrap msgid "# pkg set -A 1 devel/cmake\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:558 +#: documentation/content/en/books/handbook/ports/_index.adoc:604 msgid "" "Once a package is a leaf package and is marked as automatic, it gets " "selected by `pkg autoremove`." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:560 +#: documentation/content/en/books/handbook/ports/_index.adoc:606 msgid "Marking an installed package as _not_ automatic can be done using:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:564 +#: documentation/content/en/books/handbook/ports/_index.adoc:610 #, no-wrap msgid "# pkg set -A 0 devel/cmake\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:567 +#: documentation/content/en/books/handbook/ports/_index.adoc:613 #, no-wrap msgid "Removing Stale Packages" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:572 +#: documentation/content/en/books/handbook/ports/_index.adoc:618 msgid "" "By default, pkg stores binary packages in a cache directory defined by " "`PKG_CACHEDIR` in man:pkg.conf[5]. Only copies of the latest installed " @@ -1104,30 +1230,30 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:576 +#: documentation/content/en/books/handbook/ports/_index.adoc:622 #, no-wrap msgid "# pkg clean\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:579 +#: documentation/content/en/books/handbook/ports/_index.adoc:625 msgid "The entire cache may be cleared by running:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:583 +#: documentation/content/en/books/handbook/ports/_index.adoc:629 #, no-wrap msgid "# pkg clean -a\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:586 +#: documentation/content/en/books/handbook/ports/_index.adoc:632 #, no-wrap msgid "Locking and Unlocking Packages" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:592 +#: documentation/content/en/books/handbook/ports/_index.adoc:638 msgid "" "man:pkg-lock[8] is used to lock packages against reinstallation, " "modification or deletion. man:pkg-unlock[8] unlocks the named packages. " @@ -1138,35 +1264,35 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:594 +#: documentation/content/en/books/handbook/ports/_index.adoc:640 msgid "For example, to lock `nginx-lite`:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:598 +#: documentation/content/en/books/handbook/ports/_index.adoc:644 #, no-wrap msgid "# pkg lock nginx-lite\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:601 +#: documentation/content/en/books/handbook/ports/_index.adoc:647 msgid "And to unlock `nginx-lite`:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:605 +#: documentation/content/en/books/handbook/ports/_index.adoc:651 #, no-wrap msgid "# pkg unlock nginx-lite\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:608 +#: documentation/content/en/books/handbook/ports/_index.adoc:654 #, no-wrap msgid "Modifying Package Metadata" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:613 +#: documentation/content/en/books/handbook/ports/_index.adoc:659 msgid "" "Software within the FreeBSD Ports Collection can undergo major version " "number changes. To address this, pkg has a built-in command to update " @@ -1176,31 +1302,31 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:615 +#: documentation/content/en/books/handbook/ports/_index.adoc:661 msgid "To change the package origin for the above example, run:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:619 +#: documentation/content/en/books/handbook/ports/_index.adoc:665 #, no-wrap msgid "# pkg set -o lang/python3:lang/python311\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:622 +#: documentation/content/en/books/handbook/ports/_index.adoc:668 msgid "" "As another example, to update package:lang/ruby31[] to package:lang/" "ruby32[], run:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:626 +#: documentation/content/en/books/handbook/ports/_index.adoc:672 #, no-wrap msgid "# pkg set -o lang/ruby31:lang/ruby32\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:632 +#: documentation/content/en/books/handbook/ports/_index.adoc:678 msgid "" "When changing package origins, it is important to reinstall packages that " "are dependent on the package with the modified origin. To force a " @@ -1208,19 +1334,19 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:636 +#: documentation/content/en/books/handbook/ports/_index.adoc:682 #, no-wrap msgid "# pkg install -Rf lang/ruby32\n" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/ports/_index.adoc:640 +#: documentation/content/en/books/handbook/ports/_index.adoc:686 #, no-wrap msgid "Using the Ports Collection" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:644 +#: documentation/content/en/books/handbook/ports/_index.adoc:690 msgid "" "The Ports Collection is a set of `Makefiles`, patches, and description " "files. Each set of these files is used to compile and install an individual " @@ -1228,14 +1354,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:646 +#: documentation/content/en/books/handbook/ports/_index.adoc:692 msgid "" "By default, the Ports Collection itself is stored as a subdirectory of `/usr/" "ports`." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:653 +#: documentation/content/en/books/handbook/ports/_index.adoc:699 msgid "" "Before installing and using the Ports Collection, please be aware that it is " "generally ill-advised to use the Ports Collection in conjunction with the " @@ -1245,12 +1371,12 @@ msgid "" "counterpart in a quarterly branch release and this could result in conflicts " "between dependencies installed by pkg and those from the Ports Collection. " "If the Ports Collection and pkg must be used in conjunction, then be sure " -"that your Ports Collection and pkg are on the same branch release of the " +"that the Ports Collection and pkg are on the same branch release of the " "ports tree." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:659 +#: documentation/content/en/books/handbook/ports/_index.adoc:705 msgid "" "The Ports Collection contains directories for software categories. Inside " "each category are subdirectories for individual applications. Each " @@ -1260,37 +1386,37 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:661 +#: documentation/content/en/books/handbook/ports/_index.adoc:707 #, no-wrap msgid "*Makefile*: contains statements that specify how the application should be compiled and where its components should be installed.\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:662 +#: documentation/content/en/books/handbook/ports/_index.adoc:708 #, no-wrap msgid "*distinfo*: contains the names and checksums of the files that must be downloaded to build the port.\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:663 +#: documentation/content/en/books/handbook/ports/_index.adoc:709 #, no-wrap msgid "*files/*: this directory contains any patches needed for the program to compile and install on FreeBSD. This directory may also contain other files used to build the port.\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:664 +#: documentation/content/en/books/handbook/ports/_index.adoc:710 #, no-wrap msgid "*pkg-descr*: provides a more detailed description of the program.\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:665 +#: documentation/content/en/books/handbook/ports/_index.adoc:711 #, no-wrap msgid "*pkg-plist*: a list of all the files that will be installed by the port. It also tells the ports system which files to remove upon deinstallation.\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:668 +#: documentation/content/en/books/handbook/ports/_index.adoc:714 msgid "" "Some ports include `pkg-message` or other files to handle special " "situations. For more details on these files, and on ports in general, refer " @@ -1298,7 +1424,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:671 +#: documentation/content/en/books/handbook/ports/_index.adoc:717 msgid "" "The port does not include the actual source code, also known as a " "`distfile`. The extract portion of building a port will automatically save " @@ -1306,13 +1432,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:673 +#: documentation/content/en/books/handbook/ports/_index.adoc:719 #, no-wrap msgid "Installing the Ports Collection" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:677 +#: documentation/content/en/books/handbook/ports/_index.adoc:723 msgid "" "Before an application can be compiled using a port, the Ports Collection " "must first be installed. If it was not installed during the installation of " @@ -1320,13 +1446,13 @@ msgid "" msgstr "" #. type: delimited block * 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:682 +#: documentation/content/en/books/handbook/ports/_index.adoc:728 #, no-wrap msgid "*Procedure: Git Method*\n" msgstr "" #. type: delimited block * 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:686 +#: documentation/content/en/books/handbook/ports/_index.adoc:732 msgid "" "If more control over the ports tree is needed or if local changes need to be " "maintained, or if running FreeBSD-CURRENT, Git can be used to obtain the " @@ -1335,23 +1461,23 @@ msgid "" msgstr "" #. type: delimited block * 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:689 +#: documentation/content/en/books/handbook/ports/_index.adoc:735 msgid "" -"We add --depth 1 to the git command line to clone the tree without obtaining " -"the commit history, which saves time and is acceptable for most users. If " -"you have your own changes to the ports tree, or need the history for any " -"reason, omit the --depth 1 argument below." +"We add `--depth 1` to the git command line to clone the tree without " +"obtaining the commit history, which saves time and is acceptable for most " +"users. When maintaining custom changes to the ports tree, or need the " +"history for any reason, omit the `--depth 1` argument below." msgstr "" #. type: delimited block * 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:691 +#: documentation/content/en/books/handbook/ports/_index.adoc:737 msgid "" "Git must be installed before it can be used to check out the ports tree. If " "a copy of the ports tree is already present, install Git like this:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:696 +#: documentation/content/en/books/handbook/ports/_index.adoc:742 #, no-wrap msgid "" "# cd /usr/ports/devel/git\n" @@ -1359,70 +1485,72 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:699 +#: documentation/content/en/books/handbook/ports/_index.adoc:745 msgid "" "If the ports tree is not available, or pkg is being used to manage packages, " "Git can be installed as a package:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:703 +#: documentation/content/en/books/handbook/ports/_index.adoc:749 #, no-wrap msgid "# pkg install git\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:706 +#: documentation/content/en/books/handbook/ports/_index.adoc:752 msgid "Check out a copy of the HEAD branch of the ports tree:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:710 +#: documentation/content/en/books/handbook/ports/_index.adoc:756 #, no-wrap msgid "# git clone --depth 1 https://git.FreeBSD.org/ports.git /usr/ports\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:713 +#: documentation/content/en/books/handbook/ports/_index.adoc:759 msgid "Or, check out a copy of a quarterly branch:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:717 +#: documentation/content/en/books/handbook/ports/_index.adoc:763 #, no-wrap msgid "# git clone --depth 1 https://git.FreeBSD.org/ports.git -b 2023Q1 /usr/ports\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:720 +#: documentation/content/en/books/handbook/ports/_index.adoc:766 msgid "As needed, update `/usr/ports` after the initial Git checkout:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:724 +#: documentation/content/en/books/handbook/ports/_index.adoc:770 #, no-wrap msgid "# git -C /usr/ports pull\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:727 +#: documentation/content/en/books/handbook/ports/_index.adoc:773 msgid "As needed, switch `/usr/ports` to a different quarterly branch:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:731 +#: documentation/content/en/books/handbook/ports/_index.adoc:778 #, no-wrap -msgid "# git -C /usr/ports switch 2023Q1\n" +msgid "" +"# git -C /usr/ports fetch --depth 1 origin 2023Q2:2023Q2\n" +"# git -C /usr/ports switch 2023Q2\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:734 +#: documentation/content/en/books/handbook/ports/_index.adoc:781 #, no-wrap msgid "Installing Ports" msgstr "" #. type: delimited block * 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:738 +#: documentation/content/en/books/handbook/ports/_index.adoc:785 msgid "" "This section provides basic instructions on using the Ports Collection to " "install or remove software. The detailed description of available `make` " @@ -1430,7 +1558,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:746 +#: documentation/content/en/books/handbook/ports/_index.adoc:793 msgid "" "Before compiling any port, be sure to update the Ports Collection as " "described in the previous section. Since the installation of any third-" @@ -1444,14 +1572,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:750 +#: documentation/content/en/books/handbook/ports/_index.adoc:797 msgid "" "Using the Ports Collection assumes a working Internet connection. It also " "requires superuser privilege." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:753 +#: documentation/content/en/books/handbook/ports/_index.adoc:800 msgid "" "To compile and install the port, change to the directory of the port to be " "installed, then type `make install` at the prompt. Messages will indicate " @@ -1459,7 +1587,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:775 +#: documentation/content/en/books/handbook/ports/_index.adoc:822 #, no-wrap msgid "" "# cd /usr/ports/sysutils/lsof\n" @@ -1484,7 +1612,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:788 +#: documentation/content/en/books/handbook/ports/_index.adoc:835 #, no-wrap msgid "" "===> Installing for lsof-4.88.d,8\n" @@ -1502,7 +1630,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:792 +#: documentation/content/en/books/handbook/ports/_index.adoc:839 msgid "" "Since `lsof` is a program that runs with increased privileges, a security " "warning is displayed as it is installed. Once the installation is complete, " @@ -1510,7 +1638,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:797 +#: documentation/content/en/books/handbook/ports/_index.adoc:844 msgid "" "Some shells keep a cache of the commands that are available in the " "directories listed in the `PATH` environment variable, to speed up lookup " @@ -1521,7 +1649,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:800 +#: documentation/content/en/books/handbook/ports/_index.adoc:847 msgid "" "During installation, a working subdirectory is created which contains all " "the temporary files used during compilation. Removing this directory saves " @@ -1530,7 +1658,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:806 +#: documentation/content/en/books/handbook/ports/_index.adoc:853 #, no-wrap msgid "" "# make clean\n" @@ -1539,20 +1667,20 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:811 +#: documentation/content/en/books/handbook/ports/_index.adoc:858 msgid "" "To save this extra step, instead use `make install clean` when compiling the " "port." msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/ports/_index.adoc:813 +#: documentation/content/en/books/handbook/ports/_index.adoc:860 #, no-wrap msgid "Customizing Ports Installation" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:821 +#: documentation/content/en/books/handbook/ports/_index.adoc:868 msgid "" "Some ports provide build options which can be used to enable or disable " "application components, provide security options, or allow for other " @@ -1566,7 +1694,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:827 +#: documentation/content/en/books/handbook/ports/_index.adoc:874 msgid "" "When using `config-recursive`, the list of ports to configure are gathered " "by the `all-depends-list` target. It is recommended to run `make config-" @@ -1576,19 +1704,19 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:834 +#: documentation/content/en/books/handbook/ports/_index.adoc:881 msgid "" "There are several ways to revisit a port's build options menu in order to " "add, remove, or change these options after a port has been built. One " "method is to `cd` into the directory containing the port and type `make " "config`. Another option is to use `make showconfig`. Another option is to " -"execute `make rmconfig` which will remove all selected options and allow you " -"to start over. All of these options, and others, are explained in great " -"detail in man:ports[7]." +"execute `make rmconfig` which will remove all selected options and allows to " +"start over. All of these options, and others, are explained in great detail " +"in man:ports[7]." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:838 +#: documentation/content/en/books/handbook/ports/_index.adoc:885 msgid "" "The ports system uses man:fetch[1] to download the source files, which " "supports various environment variables. The `FTP_PASSIVE_MODE`, " @@ -1598,7 +1726,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:843 +#: documentation/content/en/books/handbook/ports/_index.adoc:890 msgid "" "For users who cannot be connected to the Internet all the time, `make fetch` " "can be run within `/usr/ports`, to fetch all distfiles, or within a " @@ -1610,7 +1738,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:846 +#: documentation/content/en/books/handbook/ports/_index.adoc:893 msgid "" "In rare cases, such as when an organization has a local distfiles " "repository, the `MASTER_SITES` variable can be used to override the download " @@ -1619,7 +1747,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:852 +#: documentation/content/en/books/handbook/ports/_index.adoc:899 #, no-wrap msgid "" "# cd /usr/ports/directory\n" @@ -1628,76 +1756,76 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:855 +#: documentation/content/en/books/handbook/ports/_index.adoc:902 msgid "" "The `WRKDIRPREFIX` and `PREFIX` variables can override the default working " "and target directories. For example:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:859 +#: documentation/content/en/books/handbook/ports/_index.adoc:906 #, no-wrap msgid "# make WRKDIRPREFIX=/usr/home/example/ports install\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:862 +#: documentation/content/en/books/handbook/ports/_index.adoc:909 msgid "" "will compile the port in `/usr/home/example/ports` and install everything " "under `/usr/local`." msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:866 +#: documentation/content/en/books/handbook/ports/_index.adoc:913 #, no-wrap msgid "# make PREFIX=/usr/home/example/local install\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:869 +#: documentation/content/en/books/handbook/ports/_index.adoc:916 msgid "" "will compile the port in `/usr/ports` and install it in `/usr/home/example/" "local`. And:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:873 +#: documentation/content/en/books/handbook/ports/_index.adoc:920 #, no-wrap msgid "# make WRKDIRPREFIX=../ports PREFIX=../local install\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:876 +#: documentation/content/en/books/handbook/ports/_index.adoc:923 msgid "will combine the two." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:879 +#: documentation/content/en/books/handbook/ports/_index.adoc:926 msgid "" "These can also be set as environmental variables. Refer to the manual page " -"for your shell for instructions on how to set an environmental variable." +"for the shell for instructions on how to set an environmental variable." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:881 +#: documentation/content/en/books/handbook/ports/_index.adoc:928 #, no-wrap msgid "Removing Installed Ports" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:885 +#: documentation/content/en/books/handbook/ports/_index.adoc:932 msgid "" "Installed ports can be uninstalled using `pkg delete`. Examples for using " "this command can be found in the man:pkg-delete[8] manual page." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:887 +#: documentation/content/en/books/handbook/ports/_index.adoc:934 msgid "Alternately, `make deinstall` can be run in the port\\'s directory:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:895 +#: documentation/content/en/books/handbook/ports/_index.adoc:942 #, no-wrap msgid "" "# cd /usr/ports/sysutils/lsof\n" @@ -1708,13 +1836,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:897 +#: documentation/content/en/books/handbook/ports/_index.adoc:944 #, no-wrap msgid "\tlsof-4.88.d,8\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:900 +#: documentation/content/en/books/handbook/ports/_index.adoc:947 #, no-wrap msgid "" "The deinstallation will free 229 kB\n" @@ -1722,7 +1850,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:905 +#: documentation/content/en/books/handbook/ports/_index.adoc:952 msgid "" "It is recommended to read the messages as the port is uninstalled. If the " "port has any applications that depend upon it, this information will be " @@ -1731,13 +1859,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:907 +#: documentation/content/en/books/handbook/ports/_index.adoc:954 #, no-wrap msgid "Upgrading Ports" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:911 +#: documentation/content/en/books/handbook/ports/_index.adoc:958 msgid "" "Over time, newer versions of software become available in the Ports " "Collection. This section describes how to determine which software can be " @@ -1745,7 +1873,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:915 +#: documentation/content/en/books/handbook/ports/_index.adoc:962 msgid "" "To determine if newer versions of installed ports are available, ensure that " "the latest version of the ports tree is installed, using the updating " @@ -1755,13 +1883,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:919 +#: documentation/content/en/books/handbook/ports/_index.adoc:966 #, no-wrap msgid "# pkg version -l \"<\"\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:926 +#: documentation/content/en/books/handbook/ports/_index.adoc:973 msgid "" "Before attempting an upgrade, read `/usr/ports/UPDATING` from the top of the " "file to the date closest to the last time ports were upgraded or the system " @@ -1774,41 +1902,41 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/ports/_index.adoc:929 +#: documentation/content/en/books/handbook/ports/_index.adoc:976 #, no-wrap msgid "Tools to Upgrade and Manage Ports" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:933 +#: documentation/content/en/books/handbook/ports/_index.adoc:980 msgid "" "The Ports Collection contains several utilities to perform the actual " "upgrade. Each has its strengths and weaknesses." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:936 +#: documentation/content/en/books/handbook/ports/_index.adoc:983 msgid "" "Historically, most installations used either Portmaster or Portupgrade. " "Synth is a newer alternative." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:941 +#: documentation/content/en/books/handbook/ports/_index.adoc:988 msgid "" "The choice of which tool is best for a particular system is up to the system " -"administrator. It is recommended practice to back up your data before using " -"any of these tools." +"administrator. It is recommended practice to back up data before using any " +"of these tools." msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/ports/_index.adoc:944 +#: documentation/content/en/books/handbook/ports/_index.adoc:991 #, no-wrap msgid "Upgrading Ports Using Portmaster" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:949 +#: documentation/content/en/books/handbook/ports/_index.adoc:996 msgid "" "package:ports-mgmt/portmaster[] is a very small utility for upgrading " "installed ports. It is designed to use the tools installed with the FreeBSD " @@ -1817,7 +1945,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:954 +#: documentation/content/en/books/handbook/ports/_index.adoc:1001 #, no-wrap msgid "" "# cd /usr/ports/ports-mgmt/portmaster\n" @@ -1825,38 +1953,38 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:957 +#: documentation/content/en/books/handbook/ports/_index.adoc:1004 msgid "Portmaster defines four categories of ports:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:959 +#: documentation/content/en/books/handbook/ports/_index.adoc:1006 msgid "" "Root port: has no dependencies and is not a dependency of any other ports." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:960 +#: documentation/content/en/books/handbook/ports/_index.adoc:1007 msgid "Trunk port: has no dependencies, but other ports depend upon it." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:961 +#: documentation/content/en/books/handbook/ports/_index.adoc:1008 msgid "Branch port: has dependencies and other ports depend upon it." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:962 +#: documentation/content/en/books/handbook/ports/_index.adoc:1009 msgid "Leaf port: has dependencies but no other ports depend upon it." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:964 +#: documentation/content/en/books/handbook/ports/_index.adoc:1011 msgid "To list these categories and search for updates:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:985 +#: documentation/content/en/books/handbook/ports/_index.adoc:1032 #, no-wrap msgid "" "# portmaster -L\n" @@ -1880,7 +2008,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:988 +#: documentation/content/en/books/handbook/ports/_index.adoc:1035 #, no-wrap msgid "" "===>>> 137 total installed ports\n" @@ -1888,18 +2016,18 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:991 +#: documentation/content/en/books/handbook/ports/_index.adoc:1038 msgid "This command is used to upgrade all outdated ports:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:995 +#: documentation/content/en/books/handbook/ports/_index.adoc:1042 #, no-wrap msgid "# portmaster -a\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1005 +#: documentation/content/en/books/handbook/ports/_index.adoc:1052 msgid "" "By default, Portmaster makes a backup package before deleting the existing " "port. If the installation of the new version is successful, Portmaster " @@ -1911,20 +2039,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1008 +#: documentation/content/en/books/handbook/ports/_index.adoc:1055 msgid "" "If errors are encountered during the upgrade process, add `-f` to upgrade " "and rebuild all ports:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1012 +#: documentation/content/en/books/handbook/ports/_index.adoc:1059 #, no-wrap msgid "# portmaster -af\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1016 +#: documentation/content/en/books/handbook/ports/_index.adoc:1063 msgid "" "Portmaster can also be used to install new ports on the system, upgrading " "all dependencies before building and installing the new port. To use this " @@ -1932,31 +2060,31 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1020 +#: documentation/content/en/books/handbook/ports/_index.adoc:1067 #, no-wrap msgid "# portmaster shells/bash\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1023 +#: documentation/content/en/books/handbook/ports/_index.adoc:1070 msgid "" "More information about package:ports-mgmt/portmaster[] may be found in its " "`pkg-descr`." msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/ports/_index.adoc:1025 +#: documentation/content/en/books/handbook/ports/_index.adoc:1072 #, no-wrap msgid "Upgrading Ports Using Portupgrade" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1030 +#: documentation/content/en/books/handbook/ports/_index.adoc:1077 msgid "Portupgrade is deprecated and will be removed in the near future." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1036 +#: documentation/content/en/books/handbook/ports/_index.adoc:1083 msgid "" "package:ports-mgmt/portupgrade[] is another utility that can be used to " "upgrade ports. It installs a suite of applications which can be used to " @@ -1964,7 +2092,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1041 +#: documentation/content/en/books/handbook/ports/_index.adoc:1088 #, no-wrap msgid "" "# cd /usr/ports/ports-mgmt/portupgrade\n" @@ -1972,7 +2100,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1044 +#: documentation/content/en/books/handbook/ports/_index.adoc:1091 msgid "" "Before performing an upgrade using this utility, it is recommended to scan " "the list of installed ports using `pkgdb -F` and to fix all the " @@ -1980,7 +2108,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1047 +#: documentation/content/en/books/handbook/ports/_index.adoc:1094 msgid "" "To upgrade all the outdated ports installed on the system, use `portupgrade " "-a`. Alternately, include `-i` to be asked for confirmation of every " @@ -1988,13 +2116,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1051 +#: documentation/content/en/books/handbook/ports/_index.adoc:1098 #, no-wrap msgid "# portupgrade -ai\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1055 +#: documentation/content/en/books/handbook/ports/_index.adoc:1102 msgid "" "To upgrade only a specified application instead of all available ports, use " "`portupgrade _pkgname_`. It is very important to include `-R` to first " @@ -2002,13 +2130,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1059 +#: documentation/content/en/books/handbook/ports/_index.adoc:1106 #, no-wrap msgid "# portupgrade -R firefox\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1066 +#: documentation/content/en/books/handbook/ports/_index.adoc:1113 msgid "" "If `-P` is included, Portupgrade searches for available packages in the " "local directories listed in `PKG_PATH`. If none are available locally, it " @@ -2019,13 +2147,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1070 +#: documentation/content/en/books/handbook/ports/_index.adoc:1117 #, no-wrap msgid "# portupgrade -PP gnome3\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1074 +#: documentation/content/en/books/handbook/ports/_index.adoc:1121 msgid "" "To just fetch the port distfiles, or packages, if `-P` is specified, without " "building or installing anything, use `-F`. For further information on all " @@ -2033,20 +2161,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1076 +#: documentation/content/en/books/handbook/ports/_index.adoc:1123 msgid "" "More information about package:ports-mgmt/portupgrade[] may be found in its " "`pkg-descr`." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:1078 +#: documentation/content/en/books/handbook/ports/_index.adoc:1125 #, no-wrap msgid "Ports and Disk Space" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1084 +#: documentation/content/en/books/handbook/ports/_index.adoc:1131 msgid "" "Using the Ports Collection will use up disk space over time. After building " "and installing a port, running `make clean` within the ports skeleton will " @@ -2057,13 +2185,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1088 +#: documentation/content/en/books/handbook/ports/_index.adoc:1135 #, no-wrap msgid "# portsclean -C\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1092 +#: documentation/content/en/books/handbook/ports/_index.adoc:1139 msgid "" "In addition, outdated source distribution files accumulate in `/usr/ports/" "distfiles` over time. To use Portupgrade to delete all the distfiles that " @@ -2071,57 +2199,57 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1096 +#: documentation/content/en/books/handbook/ports/_index.adoc:1143 #, no-wrap msgid "# portsclean -D\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1099 +#: documentation/content/en/books/handbook/ports/_index.adoc:1146 msgid "" "Portupgrade can remove all distfiles not referenced by any port currently " "installed on the system:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1103 +#: documentation/content/en/books/handbook/ports/_index.adoc:1150 #, no-wrap msgid "# portsclean -DD\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1106 +#: documentation/content/en/books/handbook/ports/_index.adoc:1153 msgid "If Portmaster is installed, use:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1110 +#: documentation/content/en/books/handbook/ports/_index.adoc:1157 #, no-wrap msgid "# portmaster --clean-distfiles\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1113 +#: documentation/content/en/books/handbook/ports/_index.adoc:1160 msgid "" "By default, this command is interactive and prompts the user to confirm if a " "distfile should be deleted." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1115 +#: documentation/content/en/books/handbook/ports/_index.adoc:1162 msgid "" "In addition to these commands, package:ports-mgmt/pkg_cutleaves[] automates " "the task of removing installed ports that are no longer needed." msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/ports/_index.adoc:1117 +#: documentation/content/en/books/handbook/ports/_index.adoc:1164 #, no-wrap msgid "Building Packages with poudriere" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1124 +#: documentation/content/en/books/handbook/ports/_index.adoc:1171 msgid "" "poudriere is a `BSD`-licensed utility for creating and testing FreeBSD " "packages. It uses FreeBSD jails to set up isolated compilation " @@ -2133,7 +2261,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1129 +#: documentation/content/en/books/handbook/ports/_index.adoc:1176 msgid "" "poudriere is installed using the package:ports-mgmt/poudriere[] package or " "port. The installation includes a sample configuration file `/usr/local/etc/" @@ -2142,7 +2270,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1135 +#: documentation/content/en/books/handbook/ports/_index.adoc:1182 msgid "" "While `ZFS` is not required on the system running poudriere, it is " "beneficial. When `ZFS` is used, `ZPOOL` must be specified in `/usr/local/" @@ -2154,7 +2282,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1139 +#: documentation/content/en/books/handbook/ports/_index.adoc:1186 msgid "" "The number of processor cores detected is used to define how many builds " "will run in parallel. Supply enough virtual memory, either with `RAM` or " @@ -2163,13 +2291,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:1141 +#: documentation/content/en/books/handbook/ports/_index.adoc:1188 #, no-wrap msgid "Initialize Jails and Port Trees" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1147 +#: documentation/content/en/books/handbook/ports/_index.adoc:1194 msgid "" "After configuration, initialize poudriere so that it installs a jail with " "the required FreeBSD tree and a ports tree. Specify a name for the jail " @@ -2179,7 +2307,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1194 +#: documentation/content/en/books/handbook/ports/_index.adoc:1241 #, no-wrap msgid "" "# poudriere jail -c -j 13amd64 -v 13.1-RELEASE\n" @@ -2229,7 +2357,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1201 +#: documentation/content/en/books/handbook/ports/_index.adoc:1248 #, no-wrap msgid "" "# poudriere ports -c -p local -m git+https\n" @@ -2238,7 +2366,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1206 +#: documentation/content/en/books/handbook/ports/_index.adoc:1253 msgid "" "On a single computer, poudriere can build ports with multiple " "configurations, in multiple jails, and from different port trees. Custom " @@ -2248,7 +2376,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1210 +#: documentation/content/en/books/handbook/ports/_index.adoc:1257 msgid "" "The basic configuration shown here puts a single jail-, port-, and set-" "specific `make.conf` in `/usr/local/etc/poudriere.d`. The filename in this " @@ -2259,7 +2387,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1212 +#: documentation/content/en/books/handbook/ports/_index.adoc:1259 msgid "" "Packages to be built are entered in `13amd64-local-workstation-pkglist` " "(ports with extref:{porters-handbook}flavors[FLAVORS] can be defined with " @@ -2267,7 +2395,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1220 +#: documentation/content/en/books/handbook/ports/_index.adoc:1267 #, no-wrap msgid "" "editors/emacs\n" @@ -2278,29 +2406,29 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1223 +#: documentation/content/en/books/handbook/ports/_index.adoc:1270 msgid "Options and dependencies for the specified ports are configured:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1227 +#: documentation/content/en/books/handbook/ports/_index.adoc:1274 #, no-wrap msgid "# poudriere options -j 13amd64 -p local -z workstation -f 13amd64-local-workstation-pkglist\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1230 +#: documentation/content/en/books/handbook/ports/_index.adoc:1277 msgid "Finally, packages are built and a package repository is created:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1234 +#: documentation/content/en/books/handbook/ports/_index.adoc:1281 #, no-wrap msgid "# poudriere bulk -j 13amd64 -p local -z workstation -f 13amd64-local-workstation-pkglist\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1238 +#: documentation/content/en/books/handbook/ports/_index.adoc:1285 msgid "" "While running, pressing kbd:[Ctrl+t] displays the current state of the " "build. poudriere also builds files in `/poudriere/logs/bulk/jailname` that " @@ -2308,27 +2436,27 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1240 +#: documentation/content/en/books/handbook/ports/_index.adoc:1287 msgid "" "After completion, the new packages are now available for installation from " "the poudriere repository." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1242 +#: documentation/content/en/books/handbook/ports/_index.adoc:1289 msgid "" "For more information on using poudriere, see man:poudriere[8] and the main " "web site, https://github.com/freebsd/poudriere/wiki[]." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/ports/_index.adoc:1243 +#: documentation/content/en/books/handbook/ports/_index.adoc:1290 #, no-wrap msgid "Configuring pkg Clients to Use a poudriere Repository" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1248 +#: documentation/content/en/books/handbook/ports/_index.adoc:1295 msgid "" "While it is possible to use both a custom repository along side of the " "official repository, sometimes it is useful to disable the official " @@ -2338,7 +2466,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1254 +#: documentation/content/en/books/handbook/ports/_index.adoc:1301 #, no-wrap msgid "" "FreeBSD: {\n" @@ -2347,7 +2475,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1258 +#: documentation/content/en/books/handbook/ports/_index.adoc:1305 msgid "" "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 " @@ -2356,32 +2484,32 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1261 +#: documentation/content/en/books/handbook/ports/_index.adoc:1308 msgid "" -"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:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1268 +#: documentation/content/en/books/handbook/ports/_index.adoc:1315 #, no-wrap msgid "" "custom: {\n" -"\turl: \"http://pkg.example.com/13amd64\",\n" +"\turl: \"https://pkg.example.com/13amd64\",\n" "\tenabled: yes,\n" "}\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1271 +#: documentation/content/en/books/handbook/ports/_index.adoc:1318 msgid "" "If exposing the package repository to the internet is not desired, the " "`file://` protocol can be used to point to the repository directly:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1278 +#: documentation/content/en/books/handbook/ports/_index.adoc:1325 #, no-wrap msgid "" "custom: {\n" @@ -2391,13 +2519,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/ports/_index.adoc:1281 +#: documentation/content/en/books/handbook/ports/_index.adoc:1328 #, no-wrap msgid "Post-Installation Considerations" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1285 +#: documentation/content/en/books/handbook/ports/_index.adoc:1332 msgid "" "Regardless of whether the software was installed from a binary package or " "port, most third-party applications require some level of configuration " @@ -2406,7 +2534,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1287 +#: documentation/content/en/books/handbook/ports/_index.adoc:1334 msgid "" "Most applications install at least one default configuration file in `/usr/" "local/etc`. In cases where an application has a large number of " @@ -2418,7 +2546,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1288 +#: documentation/content/en/books/handbook/ports/_index.adoc:1335 msgid "" "Applications which provide documentation will install it into `/usr/local/" "share/doc` and many applications also install manual pages. This " @@ -2426,7 +2554,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1289 +#: documentation/content/en/books/handbook/ports/_index.adoc:1336 msgid "" "Some applications run services which must be added to `/etc/rc.conf` before " "starting the application. These applications usually install a startup " @@ -2435,7 +2563,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1294 +#: documentation/content/en/books/handbook/ports/_index.adoc:1341 msgid "" "By design, applications do not run their startup script upon installation, " "nor do they run their stop script upon deinstallation or upgrade. This " @@ -2443,32 +2571,32 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1297 +#: documentation/content/en/books/handbook/ports/_index.adoc:1344 msgid "" "Users of man:csh[1] should run `rehash` to rebuild the known binary list in " "the shells `PATH`." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1298 +#: documentation/content/en/books/handbook/ports/_index.adoc:1345 msgid "" "Use `pkg info` to determine which files, man pages, and binaries were " "installed with the application." msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/ports/_index.adoc:1300 +#: documentation/content/en/books/handbook/ports/_index.adoc:1347 #, no-wrap msgid "Dealing with Broken Ports" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1303 +#: documentation/content/en/books/handbook/ports/_index.adoc:1350 msgid "When a port does not build or install, try the following:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1305 +#: documentation/content/en/books/handbook/ports/_index.adoc:1352 msgid "" "Search to see if there is a fix pending for the port in the link:https://" "www.FreeBSD.org/support/[Problem Report database]. If so, implementing the " @@ -2476,7 +2604,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1306 +#: documentation/content/en/books/handbook/ports/_index.adoc:1353 msgid "" "Ask the maintainer of the port for help. Type `make maintainer` in the ports " "skeleton or read the port's `Makefile` to find the maintainer's email " @@ -2485,7 +2613,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1312 +#: documentation/content/en/books/handbook/ports/_index.adoc:1359 msgid "" "Some ports are not maintained by an individual but instead by a group " "maintainer represented by a extref:{mailing-list-faq}[mailing list]. Many, " @@ -2495,7 +2623,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/ports/_index.adoc:1315 +#: documentation/content/en/books/handbook/ports/_index.adoc:1362 msgid "" "In particular, ports maintained by " "mailto:ports@FreeBSD.org[ports@FreeBSD.org] are not maintained by a specific " @@ -2504,7 +2632,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1318 +#: documentation/content/en/books/handbook/ports/_index.adoc:1365 msgid "" "If there is no response to the email, use Bugzilla to submit a bug report " "using the instructions in extref:{problem-reports}[Writing FreeBSD Problem " @@ -2512,16 +2640,11 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1319 +#: documentation/content/en/books/handbook/ports/_index.adoc:1366 msgid "" "Fix it! The extref:{porters-handbook}[Porter's Handbook] includes detailed " -"information on the ports infrastructure so that you can fix the occasional " -"broken port or even submit your own!" -msgstr "" - -#. type: Plain text -#: documentation/content/en/books/handbook/ports/_index.adoc:1319 -msgid "" -"Install the package instead of the port using the instructions in " -"crossref:ports[pkgng-intro, Using pkg for Binary Package Management]." +"information on the ports infrastructure, enabling the fixing of occasional " +"broken ports or the submission of new ones. Install the package instead of " +"the port using the instructions in crossref:ports[pkgng-intro, Using pkg for " +"Binary Package Management]." msgstr "" |