diff options
Diffstat (limited to 'documentation/content/en/books/porters-handbook/testing/_index.po')
| -rw-r--r-- | documentation/content/en/books/porters-handbook/testing/_index.po | 320 |
1 files changed, 159 insertions, 161 deletions
diff --git a/documentation/content/en/books/porters-handbook/testing/_index.po b/documentation/content/en/books/porters-handbook/testing/_index.po index ee935a57cc..1c727e765d 100644 --- a/documentation/content/en/books/porters-handbook/testing/_index.po +++ b/documentation/content/en/books/porters-handbook/testing/_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-08-17 20:54+0100\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" @@ -176,30 +176,29 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:119 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:117 msgid "" "Since `portlint` uses heuristics to try to figure out errors, it can produce " "false positive warnings. In addition, occasionally something that is " "flagged as a problem really cannot be done in any other way due to " -"limitations in the ports framework. pass:[<!-- vale Vale.Terms = NO -->] " -"When in doubt, the best thing to do is ask on {freebsd-ports}. pass:[<!-- " -"vale Vale.Terms = YES -->]" +"limitations in the ports framework. When in doubt, the best thing to do is " +"ask on {freebsd-ports}." msgstr "" #. type: Title == -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:121 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:119 #, no-wrap msgid "Port Tools" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:124 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:122 msgid "" "The package:ports-mgmt/porttools[] program is part of the Ports Collection." msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:130 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:128 msgid "" "`port` is the front-end script, which can help simplify the testing job. " "Whenever a new port or an update to an existing one needs testing, use `port " @@ -209,19 +208,19 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:134 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:132 #, no-wrap msgid "# port test /usr/ports/net/csup\n" msgstr "" #. type: Title == -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:137 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:135 #, no-wrap msgid "`PREFIX` and `DESTDIR`" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:142 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:140 msgid "" "`PREFIX` determines where the port will be installed. It defaults to " "[.filename]#/usr/local#, but can be set by the user to a custom path like " @@ -229,7 +228,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:147 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:145 msgid "" "`DESTDIR`, if set by the user, determines the complete alternative " "environment, usually a jail or an installed system mounted somewhere other " @@ -241,7 +240,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:150 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:148 msgid "" "The value of `PREFIX` will be set to `LOCALBASE` (defaulting to [.filename]#/" "usr/local#). If `USE_LINUX_PREFIX` is set, `PREFIX` will be `LINUXBASE` " @@ -249,7 +248,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:154 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:152 msgid "" "Avoiding hard-coded [.filename]#/usr/local# paths in the source makes the " "port much more flexible and able to cater to the needs of other sites. " @@ -260,54 +259,54 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:157 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:155 msgid "" "Make sure the application is not installing things in [.filename]#/usr/" "local# instead of `PREFIX`. A quick test for such hard-coded paths is:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:161 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:159 #, no-wrap msgid "% make clean; make package PREFIX=/var/tmp/`make -V PORTNAME`\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:164 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:162 msgid "" "If anything is installed outside of `PREFIX`, the package creation process " "will complain that it cannot find the files." msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:166 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:164 msgid "" "In addition, it is worth checking the same with the stage directory support " "(see crossref:special[staging,Staging]):" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:170 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:168 #, no-wrap msgid "% make stage && make check-plist && make stage-qa && make package\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:173 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:171 msgid "" "`check-plist` checks for files missing from the plist, and files in the " "plist that are not installed by the port." msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:174 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:172 msgid "" "`stage-qa` checks for common problems like bad shebang, symlinks pointing " "outside the stage directory, setuid files, and non-stripped libraries..." msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:177 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:175 msgid "" "These tests will not find hard-coded paths inside the port's files, nor will " "it verify that `LOCALBASE` is being used to correctly refer to files from " @@ -317,7 +316,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:180 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:178 msgid "" "`PREFIX` must not be set explicitly in a port's [.filename]#Makefile#. " "Users installing the port may have set `PREFIX` to a custom location, and " @@ -325,7 +324,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:184 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:182 msgid "" "Refer to programs and files from other ports with the variables mentioned " "above, not explicit pathnames. For instance, if the port requires a macro " @@ -334,13 +333,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:188 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:186 #, no-wrap msgid "-DPAGER=\\\"${LOCALBASE}/bin/less\\\"\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:191 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:189 msgid "" "The path with `LOCALBASE` is more likely to still work if the system " "administrator has moved the whole [.filename]#/usr/local# tree somewhere " @@ -348,7 +347,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:197 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:195 msgid "" "All these tests are done automatically when running `poudriere testport` or " "`poudriere bulk -t`. It is highly recommended that every ports contributor " @@ -357,54 +356,54 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:200 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:198 #, no-wrap msgid "poudriere" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:204 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:202 msgid "" "For a ports contributor, poudriere is one of the most important and helpful " "testing and build tools. Its main features include:" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:206 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:204 msgid "" "Bulk building of the entire ports tree, specific subsets of the ports tree, " "or a single port including its dependencies" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:207 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:205 msgid "Automatic packaging of build results" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:208 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:206 msgid "Generation of build log files per port" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:209 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:207 msgid "Providing a signed man:pkg[8] repository" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:210 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:208 msgid "" "Testing of port builds before submitting a patch to the FreeBSD bug tracker " "or committing to the ports tree" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:211 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:209 msgid "Testing for successful ports builds using different options" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:214 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:212 msgid "" "Because poudriere performs its building in a clean man:jail[8] environment " "and uses man:zfs[8] features, it has several advantages over traditional " @@ -412,19 +411,19 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:216 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:214 msgid "" "No pollution of the host environment: No leftover files, no accidental " "removals, no changes of existing configuration files." msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:217 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:215 msgid "Verify [.filename]#pkg-plist# for missing or superfluous entries" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:218 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:216 msgid "" "Ports committers sometimes ask for a poudriere log alongside a patch " "submission to assess whether the patch is ready for integration into the " @@ -432,7 +431,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:221 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:219 msgid "" "It is also quite straightforward to set up and use, has no dependencies, and " "will run on any supported FreeBSD release. This section shows how to " @@ -441,7 +440,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:226 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:224 msgid "" "The examples in this section show a default file layout, as standard in " "FreeBSD. Substitute any local changes accordingly. The ports tree, " @@ -450,37 +449,37 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:228 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:226 #, no-wrap msgid "Installing poudriere" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:232 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:230 msgid "" "poudriere is available in the ports tree in package:ports-mgmt/poudriere[]. " "It can be installed using man:pkg[8] or from ports:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:236 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:234 #, no-wrap msgid "# pkg install poudriere\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:239 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:237 msgid "or" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:243 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:241 #, no-wrap msgid "# make -C /usr/ports/ports-mgmt/poudriere install clean\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:254 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:252 msgid "" "There is also a work-in-progress version of poudriere which will eventually " "become the next release. It is available in package:ports-mgmt/poudriere-" @@ -498,25 +497,25 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:256 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:254 #, no-wrap msgid "Setting Up poudriere" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:260 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:258 msgid "" "The port installs a default configuration file, [.filename]#/usr/local/etc/" "poudriere.conf#. Each parameter is documented in the configuration file." msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:262 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:260 msgid "Here is a minimal example config file:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:269 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:267 #, no-wrap msgid "" "ZPOOL=zroot\n" @@ -526,39 +525,39 @@ msgid "" msgstr "" #. type: Labeled list -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:271 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:269 #, no-wrap msgid "`ZPOOL`" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:274 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:272 msgid "" "The name of the ZFS storage pool which poudriere shall use. Must be listed " "in the output of `zpool status`." msgstr "" #. type: Labeled list -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:275 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:273 #, no-wrap msgid "`BASEFS`" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:278 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:276 msgid "" "The root mount point for poudriere file systems. This entry will cause " "poudriere to mount `tank/poudriere` to `/poudriere`." msgstr "" #. type: Labeled list -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:279 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:277 #, no-wrap msgid "`DISTFILES_CACHE`" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:284 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:282 msgid "" "Defines where distfiles are stored. In this example, poudriere and the host " "share the distfiles storage directory. This avoids downloading tarballs " @@ -567,13 +566,13 @@ msgid "" msgstr "" #. type: Labeled list -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:285 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:283 #, no-wrap msgid "`RESOLV_CONF`" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:290 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:288 msgid "" "Use the host [.filename]#/etc/resolv.conf# inside jails for DNS. This is " "needed so jails can resolve the URLs of distfiles when downloading. It is " @@ -582,24 +581,24 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:292 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:290 #, no-wrap msgid "Creating poudriere Jails" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:295 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:293 msgid "Create the base jails which poudriere will use for building:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:299 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:297 #, no-wrap msgid "# poudriere jail -c -j 131Ramd64 -v 13.1-RELEASE -a amd64\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:304 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:302 msgid "" "Fetch a `13.1-RELEASE` for `amd64` from the FTP server given by " "`FREEBSD_HOST` in [.filename]#poudriere.conf#, create the zfs file system " @@ -608,13 +607,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:308 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:306 #, no-wrap msgid "# poudriere jail -c -j 12i386 -v stable/12 -a i386 -m git+https\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:313 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:311 msgid "" "Create `tank/poudriere/jails/12i386`, mount it on [.filename]#/poudriere/" "jails/12i386#, then check out the tip of the Git branch of `FreeBSD-12-" @@ -625,7 +624,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:319 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:317 msgid "" "While it is possible to build a newer version of FreeBSD on an older " "version, most of the time it will not run. For example, if a `stable/13` " @@ -634,18 +633,18 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:324 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:322 msgid "To create a poudriere jail for `14.0-CURRENT`:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:328 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:326 #, no-wrap msgid "# poudriere jail -c -j 14amd64 -v main -a amd64 -m git+https\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:333 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:331 msgid "" "In order to run a `14.0-CURRENT` poudriere jail the host must be running " "`14.0-CURRENT`. In general, newer kernels can build and run older jails. " @@ -655,14 +654,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:336 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:334 msgid "" "A list of jails currently known to poudriere can be shown with `poudriere " "jail -l`:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:343 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:341 #, no-wrap msgid "" "# poudriere jail -l\n" @@ -672,34 +671,33 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:346 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:344 #, no-wrap msgid "Keeping poudriere Jails Updated" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:350 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:348 msgid "Managing updates is very straightforward. The command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:354 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:352 #, no-wrap msgid "# poudriere jail -u -j JAILNAME\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:361 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:357 msgid "" -"updates the specified jail to the latest version available. pass:[<!-- vale " -"Vale.Terms = NO -->] For FreeBSD releases, update to the latest patchlevel " -"with man:freebsd-update[8]. pass:[<!-- vale Vale.Terms = YES -->] For " +"updates the specified jail to the latest version available. For FreeBSD " +"releases, update to the latest patchlevel with man:freebsd-update[8]. For " "FreeBSD versions built from source, update to the latest git revision in the " "branch." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:366 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:362 msgid "" "For jails employing a `git+*` method, it is helpful to add `-J " "_NumberOfParallelBuildJobs_` to speed up the build by increasing the number " @@ -708,19 +706,19 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:370 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:366 #, no-wrap msgid "# poudriere jail -u -J 6 -j JAILNAME\n" msgstr "" #. type: Title === -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:375 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:371 #, no-wrap msgid "Setting Up Ports Trees for Use with poudriere" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:379 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:375 msgid "" "There are multiple ways to use ports trees in poudriere. The most " "straightforward way is to have poudriere create a default ports tree for " @@ -728,13 +726,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:383 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:379 #, no-wrap msgid "# poudriere ports -c -m git+https -B main\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:387 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:383 msgid "" "These commands create `tank/poudriere/ports/default`, mount it on " "[.filename]#/poudriere/ports/default#, and populate it using Git. Afterward " @@ -742,7 +740,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:393 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:389 #, no-wrap msgid "" "# poudriere ports -l\n" @@ -751,7 +749,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:400 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:396 msgid "" "Note that the \"default\" ports tree is special. Each of the build commands " "explained later will implicitly use this ports tree unless specifically " @@ -760,7 +758,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:405 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:401 msgid "" "The best way to deal with local modifications for a ports contributor is to " "use link:{handbook}mirrors/#git[Git]. As with the creation of jails, it is " @@ -770,13 +768,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:407 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:403 #, no-wrap msgid "Using Manually Managed Ports Trees with poudriere" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:411 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:407 msgid "" "Depending on the workflow, it can be extremely helpful to use ports trees " "which are maintained manually. For instance, if there is a local copy of " @@ -784,18 +782,18 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:415 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:411 #, no-wrap msgid "# poudriere ports -c -m null -M /work/ports -p development\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:418 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:414 msgid "This will be listed in the table of known trees:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:424 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:420 #, no-wrap msgid "" "# poudriere ports -l\n" @@ -804,7 +802,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:430 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:426 msgid "" "The dash or `null` in the `METHOD` column means that poudriere will not " "update or change this ports tree, ever. It is completely up to the user to " @@ -813,31 +811,31 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:433 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:429 #, no-wrap msgid "Keeping poudriere Ports Trees Updated" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:436 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:432 msgid "As straightforward as with jails described earlier:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:440 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:436 #, no-wrap msgid "# poudriere ports -u -p PORTSTREE\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:443 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:439 msgid "" "Will update the given _PORTSTREE_, one tree given by the output of " "`poudriere -l`, to the latest revision available on the official servers." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:448 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:444 msgid "" "Ports trees without a method, see crossref:testing[testing-poudriere-ports-" "tree-manual, Using Manually Managed Ports Trees with poudriere], cannot be " @@ -845,20 +843,20 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:451 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:447 #, no-wrap msgid "Testing Ports" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:454 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:450 msgid "" "After jails and ports trees have been set up, the result of a contributor's " "modifications to the ports tree can be tested." msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:456 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:452 msgid "" "For example, local modifications to the package:www/firefox[] port located " "in [.filename]#/work/ports/www/firefox# can be tested in the previously " @@ -866,13 +864,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:460 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:456 #, no-wrap msgid "# poudriere testport -j 131Ramd64 -p development -o www/firefox\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:466 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:462 msgid "" "This will build all dependencies of Firefox. If a dependency has been built " "previously and is still up-to-date, the pre-built package is installed. If " @@ -881,14 +879,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:468 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:464 msgid "" "The complete build of every port is logged to [.filename]#/poudriere/data/" "logs/bulk/131Ri386-development/build-time/logs#." msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:473 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:469 msgid "" "The directory name `131Ri386-development` is derived from the arguments to `-" "j` and `-p`, respectively. For convenience, a symbolic link [.filename]#/" @@ -899,7 +897,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:476 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:472 msgid "" "By default, poudriere cleans up the jails and leaves log files in the " "directories mentioned above. To ease investigation, jails can be kept " @@ -907,13 +905,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:480 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:476 #, no-wrap msgid "# poudriere testport -j 131Ramd64 -p development -i -o www/firefox\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:487 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:483 msgid "" "After the build completes, and regardless of whether it was successful, a " "shell is provided within the jail. The shell is used to investigate " @@ -923,7 +921,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:501 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:497 #, no-wrap msgid "" "# poudriere testport -j 131Ramd64 -p development -I -o www/firefox\n" @@ -940,7 +938,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:506 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:502 msgid "" "An integral part of the FreeBSD ports build infrastructure is the ability to " "tweak ports to personal preferences with options. These can be tested with " @@ -948,13 +946,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:510 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:506 #, no-wrap msgid "# poudriere testport -j 131Ramd64 -c -o www/firefox\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:516 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:512 msgid "" "Presents the port configuration dialog before the port is built. The ports " "given after `-o` in the format `_category_/_portname_` will use the " @@ -964,7 +962,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:521 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:517 msgid "" "When testing ports where [.filename]#pkg-plist# is altered during build " "depending on the selected options, it is recommended to perform a test run " @@ -972,13 +970,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:524 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:520 #, no-wrap msgid "Using Sets" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:529 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:525 msgid "" "For all actions involving builds, a so-called _set_ can be specified using `-" "z _setname_`. A set refers to a fully independent build. This allows, for " @@ -987,7 +985,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:535 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:531 msgid "" "To use sets, poudriere expects an existing directory structure similar to " "`PORT_DBDIR`, defaults to [.filename]#/var/db/ports# in its configuration " @@ -1001,55 +999,55 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:539 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:583 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:535 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:579 #, no-wrap msgid "# poudriere testport -j 131Ramd64 -p development -z devset -o www/firefox\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:542 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:538 msgid "This will look for the existence of these directories in this order:" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:544 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:540 msgid "" "[.filename]#/usr/local/etc/poudriere.d/131Ramd64-development-devset-options#" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:545 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:541 msgid "[.filename]#/usr/local/etc/poudriere.d/131Ramd64-devset-options#" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:546 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:542 msgid "[.filename]#/usr/local/etc/poudriere.d/131Ramd64-development-options#" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:547 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:543 msgid "[.filename]#/usr/local/etc/poudriere.d/devset-options#" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:548 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:544 msgid "[.filename]#/usr/local/etc/poudriere.d/development-options#" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:549 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:545 msgid "[.filename]#/usr/local/etc/poudriere.d/131Ramd64-options#" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:550 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:546 msgid "[.filename]#/usr/local/etc/poudriere.d/options#" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:553 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:549 msgid "" "From this list, poudriere man:nullfs[5]-mounts the _first existing_ " "directory tree into the [.filename]#/var/db/ports# directory of the build " @@ -1058,27 +1056,27 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:556 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:552 msgid "" "After the directory structure for a set is provided, the options for a " "particular port can be altered. For example:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:560 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:556 #, no-wrap msgid "# poudriere options -c www/firefox -z devset\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:564 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:560 msgid "" "The configuration dialog for package:www/firefox[] is shown, and options can " "be edited. The selected options are saved to the `devset` set." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:570 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:566 msgid "" "poudriere is very flexible in the option configuration. poudriere can be " "set for particular jails, ports trees, and for multiple ports by one " @@ -1086,13 +1084,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:573 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:569 #, no-wrap msgid "Providing a Custom [.filename]#make.conf# File" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:579 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:575 msgid "" "Similar to using sets, poudriere will also use a custom " "[.filename]#make.conf# if it is provided. No special command line argument " @@ -1101,50 +1099,50 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:586 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:582 msgid "" "causes poudriere to check for the existence of these files in this order:" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:588 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:584 msgid "[.filename]#/usr/local/etc/poudriere.d/make.conf#" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:589 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:585 msgid "[.filename]#/usr/local/etc/poudriere.d/devset-make.conf#" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:590 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:586 msgid "[.filename]#/usr/local/etc/poudriere.d/development-make.conf#" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:591 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:587 msgid "[.filename]#/usr/local/etc/poudriere.d/131Ramd64-make.conf#" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:592 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:588 msgid "[.filename]#/usr/local/etc/poudriere.d/131Ramd64-development-make.conf#" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:593 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:589 msgid "[.filename]#/usr/local/etc/poudriere.d/131Ramd64-devset-make.conf#" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:594 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:590 msgid "" "[.filename]#/usr/local/etc/poudriere.d/131Ramd64-development-devset-" "make.conf#" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:598 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:594 msgid "" "Unlike with sets, all of the found files will be appended, _in that order_, " "into one [.filename]#make.conf# inside the build jails. It is hence " @@ -1156,13 +1154,13 @@ msgid "" msgstr "" #. type: Block title -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:600 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:596 #, no-wrap msgid "Using [.filename]#make.conf# to Change Default Perl" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:605 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:601 msgid "" "To build a set with a non default Perl version, for example, `5.20`, using a " "set named `perl5-20`, create a [.filename]#perl5-20-make.conf# with this " @@ -1170,39 +1168,39 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:609 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:605 #, no-wrap msgid "DEFAULT_VERSIONS+= perl=5.20\n" msgstr "" #. type: delimited block * 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:613 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:609 msgid "" "Note the use of `+=` so that if the variable is already set in the default " "[.filename]#make.conf# its content will not be overwritten." msgstr "" #. type: Title === -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:618 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:614 #, no-wrap msgid "Pruning no Longer Needed Distfiles" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:622 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:618 msgid "" "poudriere comes with a built-in mechanism to remove outdated distfiles that " "are no longer used by any port of a given tree. The command" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:626 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:622 #, no-wrap msgid "# poudriere distclean -p portstree\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:631 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:627 msgid "" "will scan the distfiles folder, `DISTFILES_CACHE` in " "[.filename]#poudriere.conf#, versus the ports tree given by the `-p " @@ -1212,19 +1210,19 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:635 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:631 #, no-wrap msgid "# poudriere distclean -p portstree -y\n" msgstr "" #. type: Title == -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:638 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:634 #, no-wrap msgid "Debugging ports" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:645 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:641 msgid "" "Sometimes things go wrong and the port fails at run time. The framework " "provides some facilities to help in debugging ports. These helpers are " @@ -1233,46 +1231,46 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:647 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:643 msgid "`WITH_DEBUG`. If set, ports are built with debugging symbols." msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:648 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:644 msgid "" "`WITH_DEBUG_PORTS`. Specifies a list of ports to be built with `WITH_DEBUG` " "set." msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:649 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:645 msgid "" "`DEBUG_FLAGS`. Used to specify additional flags to `CFLAGS`. Defaults to `-" "g`." msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:652 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:648 msgid "" "When `WITH_DEBUG` is set, either globally or for a list of ports, the " "resulting binaries are not stripped." msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:655 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:651 msgid "" "These variables can be specified in [.filename]#make.conf# or in the command " "line:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:659 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:655 #, no-wrap msgid "# cd category/port && make -DWITH_DEBUG DEBUG_FLAGSS=\"-g -O0\"\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:667 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:663 msgid "" "If the port is built using package:ports-mgmt/poudriere[] the debugging " "variables must be specified in poudriere's [.filename]#make.conf# and not in " @@ -1281,7 +1279,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/porters-handbook/testing/_index.adoc:671 +#: documentation/content/en/books/porters-handbook/testing/_index.adoc:667 msgid "" "Please refer to the debugging information in the extref:{developers-handbook}" "tools[Developer's Handbook, debugging] for more details about the debugging " |