diff options
| author | Danilo G. Baio <dbaio@FreeBSD.org> | 2025-05-01 23:11:25 +0000 |
|---|---|---|
| committer | Danilo G. Baio <dbaio@FreeBSD.org> | 2025-05-01 23:11:25 +0000 |
| commit | f85add5b55c5a68df11aa282656a88e8d3a1fd8e (patch) | |
| tree | 1b42e154f41fc93ac39f985ed1ae5d5fa64db7ed /documentation/content/en/articles | |
| parent | 064cb2c41704b78530e8a10970bba32347451114 (diff) | |
Diffstat (limited to 'documentation/content/en/articles')
5 files changed, 824 insertions, 801 deletions
diff --git a/documentation/content/en/articles/committers-guide/_index.po b/documentation/content/en/articles/committers-guide/_index.po index 3409cfaa88..1dee22ffb3 100644 --- a/documentation/content/en/articles/committers-guide/_index.po +++ b/documentation/content/en/articles/committers-guide/_index.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2024-12-29 08:30-0500\n" +"POT-Creation-Date: 2025-05-01 19:56-0300\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" @@ -260,8 +260,8 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:122 msgid "" -"Existing keys can be used, but should be checked with [." -"filename]#documentation/tools/checkkey.sh# first. In this case, make sure " +"Existing keys can be used, but should be checked with " +"[.filename]#documentation/tools/checkkey.sh# first. In this case, make sure " "the key has a FreeBSD user ID." msgstr "" @@ -275,10 +275,11 @@ msgstr "" #. type: delimited block = 4 #: documentation/content/en/articles/committers-guide/_index.adoc:129 msgid "" -"Install [.filename]#security/gnupg#. Enter these lines in [.filename]#~/." -"gnupg/gpg.conf# to set minimum acceptable defaults for signing and new key " -"preferences (see the link:https://www.gnupg.org/documentation/manuals/gnupg/" -"GPG-Options.html[GnuPG options documentation] for more details):" +"Install [.filename]#security/gnupg#. Enter these lines in " +"[.filename]#~/.gnupg/gpg.conf# to set minimum acceptable defaults for " +"signing and new key preferences (see the link:https://www.gnupg.org/" +"documentation/manuals/gnupg/GPG-Options.html[GnuPG options documentation] " +"for more details):" msgstr "" #. type: delimited block . 4 @@ -388,8 +389,8 @@ msgstr "" #: documentation/content/en/articles/committers-guide/_index.adoc:190 msgid "" "Protect the private key and passphrase. If either the private key or " -"passphrase may have been compromised or disclosed, immediately notify mailto:" -"accounts@FreeBSD.org[accounts@FreeBSD.org] and revoke the key." +"passphrase may have been compromised or disclosed, immediately notify " +"mailto:accounts@FreeBSD.org[accounts@FreeBSD.org] and revoke the key." msgstr "" #. type: delimited block = 4 @@ -445,8 +446,8 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:217 msgid "" -"A Kerberos password can also be set manually by logging into `freefall." -"FreeBSD.org` and running:" +"A Kerberos password can also be set manually by logging into " +"`freefall.FreeBSD.org` and running:" msgstr "" #. type: delimited block . 4 @@ -587,9 +588,9 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:267 msgid "" -"All committers may modify [.filename]#src/share/misc/committers-*.dot#, [." -"filename]#src/usr.bin/calendar/calendars/calendar.freebsd#, and [." -"filename]#ports/astro/xearth/files#." +"All committers may modify [.filename]#src/share/misc/committers-*.dot#, " +"[.filename]#src/usr.bin/calendar/calendars/calendar.freebsd#, and " +"[.filename]#ports/astro/xearth/files#." msgstr "" #. type: Plain text @@ -739,9 +740,9 @@ msgstr "" msgid "" "When one searches for \"Git Primer\" a number of good ones come up. Daniel " "Miessler's link:https://danielmiessler.com/study/git/[A git primer] and " -"Willie Willus' link:https://gist.github.com/" -"williewillus/068e9a8543de3a7ef80adb2938657b6b[Git - Quick Primer] are both " -"good overviews. The Git book is also complete, but much longer https://git-" +"Willie Willus' link:https://gist.github.com/williewillus/" +"068e9a8543de3a7ef80adb2938657b6b[Git - Quick Primer] are both good " +"overviews. The Git book is also complete, but much longer https://git-" "scm.com/book/en/v2. There is also this website https://dangitgit.com/ for " "common traps and pitfalls of Git, in case you need guidance to fix things " "up. Finally, an introduction link:https://eagain.net/articles/git-for-" @@ -901,8 +902,8 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:393 msgid "" -"Again, note that `gitrepo.freebsd.org` has been canonicalized to `repo." -"freebsd.org`." +"Again, note that `gitrepo.freebsd.org` has been canonicalized to " +"`repo.freebsd.org`." msgstr "" #. type: Plain text @@ -990,8 +991,8 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:441 msgid "" -"For browsing `internal/admin` branch on web: `https://cgit.freebsd.org/" -"${repo}/log/?h=internal/admin`" +"For browsing `internal/admin` branch on web: `https://cgit.freebsd.org/$" +"{repo}/log/?h=internal/admin`" msgstr "" #. type: Plain text @@ -1132,8 +1133,8 @@ msgid "" "will create a deep clone. `branch` should be one of the branches listed in " "the previous section. If no `branch` is given: the default (`main`) will be " "used. If no `<directory>` is given: the name of the new directory will " -"match the name of the repo ([.filename]#doc#, [.filename]#ports# or [." -"filename]#src#)." +"match the name of the repo ([.filename]#doc#, [.filename]#ports# or " +"[.filename]#src#)." msgstr "" #. type: Plain text @@ -1543,8 +1544,8 @@ msgstr "" #: documentation/content/en/articles/committers-guide/_index.adoc:693 msgid "" "The cgit repository web interface for use with web browsers is at https://" -"cgit.FreeBSD.org/ports/ . The production Git repository is at https://git." -"FreeBSD.org/ports.git and at ssh://anongit@git.FreeBSD.org/ports.git (or " +"cgit.FreeBSD.org/ports/ . The production Git repository is at https://" +"git.FreeBSD.org/ports.git and at ssh://anongit@git.FreeBSD.org/ports.git (or " "anongit@git.FreeBSD.org:ports.git)." msgstr "" @@ -1566,9 +1567,9 @@ msgstr "" #: documentation/content/en/articles/committers-guide/_index.adoc:703 msgid "" "A hook is available in the ports repository to help you write up your commit " -"messages in https://cgit.freebsd.org/ports/tree/.hooks/prepare-commit-msg[." -"hooks/prepare-commit-message]. It can be enabled by running ``git config --" -"add core.hooksPath .hooks``." +"messages in https://cgit.freebsd.org/ports/tree/.hooks/prepare-commit-" +"msg[.hooks/prepare-commit-message]. It can be enabled by running ``git " +"config --add core.hooksPath .hooks``." msgstr "" #. type: Plain text @@ -1972,8 +1973,8 @@ msgstr "" #: documentation/content/en/articles/committers-guide/_index.adoc:907 msgid "" "MFC workflow can be summarized as `git cherry-pick -x` plus `git commit --" -"amend` to adjust the commit message. For multiple commits, use `git rebase -" -"i` to squash them together and edit the commit message." +"amend` to adjust the commit message. For multiple commits, use `git rebase " +"-i` to squash them together and edit the commit message." msgstr "" #. type: Title ==== @@ -2835,8 +2836,8 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:1315 msgid "" -"% cd /some/where % mkdir glorbnitz % cd glorbnitz % git init % git checkout -" -"b vendor/glorbnitz" +"% cd /some/where % mkdir glorbnitz % cd glorbnitz % git init % git checkout " +"-b vendor/glorbnitz" msgstr "" #. type: delimited block . 4 @@ -3218,9 +3219,9 @@ msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/committers-guide/_index.adoc:1523 msgid "" -"You'll need to make sure that you've fetched the notes (see the crossref:" -"committers-guide[git-mini-daily-use, Daily use]for details). Once you have " -"these, notes will show up in the git log command like so:" +"You'll need to make sure that you've fetched the notes (see the " +"crossref:committers-guide[git-mini-daily-use, Daily use]for details). Once " +"you have these, notes will show up in the git log command like so:" msgstr "" #. type: Plain text @@ -3916,8 +3917,8 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:1905 msgid "" -"% git clone --mirror https://git.freebsd.org/ports.git ports.git % cd ports." -"git % git worktree add ../ports main % git worktree add ../quarterly " +"% git clone --mirror https://git.freebsd.org/ports.git ports.git % cd " +"ports.git % git worktree add ../ports main % git worktree add ../quarterly " "branches/2020Q4 % cd ../ports" msgstr "" @@ -4052,17 +4053,18 @@ msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/committers-guide/_index.adoc:1967 msgid "" -"Now add a remote on your local system that points to your fork: [source," -"shell]" +"Now add a remote on your local system that points to your fork: " +"[source,shell]" msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:1974 msgid "" "% git remote add github git@github.com:gvnn3/freebsd-src.git % git remote -v " -"github\tgit@github.com:gvnn3/freebsd-src.git (fetch) github\tgit@github.com:" -"gvnn3/freebsd-src.git (push) freebsd\thttps://git.freebsd.org/src.git " -"(fetch) freebsd\tssh://git@gitrepo.freebsd.org/src.git (push)" +"github\tgit@github.com:gvnn3/freebsd-src.git (fetch) " +"github\tgit@github.com:gvnn3/freebsd-src.git (push) freebsd\thttps://" +"git.freebsd.org/src.git (fetch) freebsd\tssh://git@gitrepo.freebsd.org/" +"src.git (push)" msgstr "" #. type: delimited block . 4 @@ -4460,25 +4462,26 @@ msgid "" "you are working on. The introduction need not be a comprehensive biography, " "just write a paragraph or two about who you are, what you plan to be working " "on as a developer in FreeBSD, and who will be your mentor. Email this to the " -"{developers-name} and you will be on your way! . Log into `freefall.FreeBSD." -"org` and create a [.filename]#/var/forward/user# (where _user_ is your " -"username) file containing the e-mail address where you want mail addressed " -"to _yourusername_@FreeBSD.org to be forwarded. This includes all of the " -"commit messages as well as any other mail addressed to the {committers-name} " -"and the {developers-name}. Really large mailboxes which have taken up " -"permanent residence on `freefall` may get truncated without warning if space " -"needs to be freed, so forward it or save it elsewhere. + [NOTE] ====== If " -"your e-mail system uses SPF with strict rules, you should exclude `mx2." -"FreeBSD.org` from SPF checks. ====== + Due to the severe load dealing with " -"SPAM places on the central mail servers that do the mailing list processing, " -"the front-end server does do some basic checks and will drop some messages " -"based on these checks. At the moment proper DNS information for the " -"connecting host is the only check in place but that may change. Some people " -"blame these checks for bouncing valid email. To have these checks turned off " -"for your email, create a file named [.filename]#~/.spam_lover# on `freefall." -"FreeBSD.org`. + [NOTE] ====== Those who are developers but not committers " -"will not be subscribed to the committers or developers mailing lists. The " -"subscriptions are derived from the access rights. ====== ====" +"{developers-name} and you will be on your way! . Log into " +"`freefall.FreeBSD.org` and create a [.filename]#/var/forward/user# (where " +"_user_ is your username) file containing the e-mail address where you want " +"mail addressed to _yourusername_@FreeBSD.org to be forwarded. This includes " +"all of the commit messages as well as any other mail addressed to the " +"{committers-name} and the {developers-name}. Really large mailboxes which " +"have taken up permanent residence on `freefall` may get truncated without " +"warning if space needs to be freed, so forward it or save it elsewhere. + " +"[NOTE] ====== If your e-mail system uses SPF with strict rules, you should " +"exclude `mx2.FreeBSD.org` from SPF checks. ====== + Due to the severe load " +"dealing with SPAM places on the central mail servers that do the mailing " +"list processing, the front-end server does do some basic checks and will " +"drop some messages based on these checks. At the moment proper DNS " +"information for the connecting host is the only check in place but that may " +"change. Some people blame these checks for bouncing valid email. To have " +"these checks turned off for your email, create a file named " +"[.filename]#~/.spam_lover# on `freefall.FreeBSD.org`. + [NOTE] ====== Those " +"who are developers but not committers will not be subscribed to the " +"committers or developers mailing lists. The subscriptions are derived from " +"the access rights. ====== ====" msgstr "" #. type: delimited block . 4 @@ -4553,9 +4556,9 @@ msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/committers-guide/_index.adoc:2259 msgid "" -"To tell a local Postfix instance that anything from `_yourusername_@FreeBSD." -"org` should be forwarded to the FreeBSD.org servers, add this to your [." -"filename]#main.cf#:" +"To tell a local Postfix instance that anything from " +"`_yourusername_@FreeBSD.org` should be forwarded to the FreeBSD.org servers, " +"add this to your [.filename]#main.cf#:" msgstr "" #. type: delimited block . 4 @@ -4792,10 +4795,10 @@ msgstr "" #: documentation/content/en/articles/committers-guide/_index.adoc:2384 msgid "" "When the mentor decides that a mentee has learned the ropes and is ready to " -"commit on their own, the mentor announces it with a commit to [." -"filename]#mentors#. This file is in the [.filename]#admin# orphan branch of " -"each repository. Detailed information on how to access these branches can " -"be found in crossref:committers-guide[admin-branch, \"admin\" branch]." +"commit on their own, the mentor announces it with a commit to " +"[.filename]#mentors#. This file is in the [.filename]#admin# orphan branch " +"of each repository. Detailed information on how to access these branches " +"can be found in crossref:committers-guide[admin-branch, \"admin\" branch]." msgstr "" #. type: delimited block . 4 @@ -5222,11 +5225,19 @@ msgstr "" #. type: delimited block . 4 #: documentation/content/en/articles/committers-guide/_index.adoc:2546 +msgid "" +"For key words where multiple values make sense (e.g., `PR:` with a comma-" +"separated list of PRs), it is permitted to use the same keyword multiple " +"times to avoid ambiguity or improve readability." +msgstr "" + +#. type: delimited block . 4 +#: documentation/content/en/articles/committers-guide/_index.adoc:2548 msgid "The key words or phrases are:" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2551 +#: documentation/content/en/articles/committers-guide/_index.adoc:2553 #, no-wrap msgid "" "[.informaltable]\n" @@ -5234,25 +5245,25 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2552 +#: documentation/content/en/articles/committers-guide/_index.adoc:2554 #, no-wrap msgid "`PR:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2554 +#: documentation/content/en/articles/committers-guide/_index.adoc:2556 #, no-wrap msgid "The problem report (if any) which is affected (typically, by being closed) by this commit. Multiple PRs may be specified on one line, separated by commas or spaces." msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2555 +#: documentation/content/en/articles/committers-guide/_index.adoc:2557 #, no-wrap msgid "`Reported by:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2559 +#: documentation/content/en/articles/committers-guide/_index.adoc:2561 #, no-wrap msgid "" "The name and e-mail address of the person that reported the issue; for developers, just the username on the FreeBSD cluster.\n" @@ -5261,7 +5272,7 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2561 +#: documentation/content/en/articles/committers-guide/_index.adoc:2563 #, no-wrap msgid "" "`Submitted by:` +\n" @@ -5269,19 +5280,19 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2563 +#: documentation/content/en/articles/committers-guide/_index.adoc:2565 #, no-wrap msgid "This has been deprecated with git; submitted patches should have the author set by using `git commit --author` with a full name and valid email." msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2564 +#: documentation/content/en/articles/committers-guide/_index.adoc:2566 #, no-wrap msgid "`Reviewed by:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2579 +#: documentation/content/en/articles/committers-guide/_index.adoc:2581 #, no-wrap msgid "" "The name and e-mail address of the person or people that reviewed the change; for developers, just the username on the FreeBSD cluster. If a patch was submitted to a mailing list for review, and the review was favorable, then just include the list name. If the reviewer is not a member of the project, provide the name, email, and if ports an external role like maintainer:\n" @@ -5300,25 +5311,25 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2580 +#: documentation/content/en/articles/committers-guide/_index.adoc:2582 #, no-wrap msgid "`Tested by:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2582 +#: documentation/content/en/articles/committers-guide/_index.adoc:2584 #, no-wrap msgid "The name and e-mail address of the person or people that tested the change; for developers, just the username on the FreeBSD cluster." msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2583 +#: documentation/content/en/articles/committers-guide/_index.adoc:2585 #, no-wrap msgid "`Discussed with:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2586 +#: documentation/content/en/articles/committers-guide/_index.adoc:2588 #, no-wrap msgid "" "The name and e-mail address of the person or people that contributed to the patch by providing meaningful feedback; for developers, just the username on the FreeBSD cluster.\n" @@ -5326,13 +5337,13 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2587 +#: documentation/content/en/articles/committers-guide/_index.adoc:2589 #, no-wrap msgid "`Approved by:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2613 +#: documentation/content/en/articles/committers-guide/_index.adoc:2615 #, no-wrap msgid "" "The name and e-mail address of the person or people that approved the change; for developers, just the username on the FreeBSD cluster.\n" @@ -5361,121 +5372,121 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2614 +#: documentation/content/en/articles/committers-guide/_index.adoc:2616 #, no-wrap msgid "`Obtained from:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2616 +#: documentation/content/en/articles/committers-guide/_index.adoc:2618 #, no-wrap msgid "The name of the project (if any) from which the code was obtained. Do not use this line for the name of an individual person." msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2617 +#: documentation/content/en/articles/committers-guide/_index.adoc:2619 #, no-wrap msgid "`Fixes:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2619 +#: documentation/content/en/articles/committers-guide/_index.adoc:2621 #, no-wrap msgid "The Git short hash and the title line of a commit that is fixed by this change as returned by `git log -n 1 --pretty=format:'%h (\"%s\")' GIT-COMMIT-HASH`." msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2620 +#: documentation/content/en/articles/committers-guide/_index.adoc:2622 #, no-wrap msgid "`MFC after:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2622 +#: documentation/content/en/articles/committers-guide/_index.adoc:2624 #, no-wrap msgid "To receive an e-mail reminder to MFC at a later date, specify the number of days, weeks, or months after which an MFC is planned." msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2623 +#: documentation/content/en/articles/committers-guide/_index.adoc:2625 #, no-wrap msgid "`MFC to:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2625 +#: documentation/content/en/articles/committers-guide/_index.adoc:2627 #, no-wrap msgid "If the commit should be merged to a subset of stable branches, specify the branch names." msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2626 +#: documentation/content/en/articles/committers-guide/_index.adoc:2628 #, no-wrap msgid "`MFH:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2628 +#: documentation/content/en/articles/committers-guide/_index.adoc:2630 #, no-wrap msgid "If the commit is to be merged into a ports quarterly branch name, specify the quarterly branch. For example `2021Q2`." msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2629 +#: documentation/content/en/articles/committers-guide/_index.adoc:2631 #, no-wrap msgid "`Relnotes:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2631 +#: documentation/content/en/articles/committers-guide/_index.adoc:2633 #, no-wrap msgid "If the change is a candidate for inclusion in the release notes for the next release from the branch, set to `yes`." msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2632 +#: documentation/content/en/articles/committers-guide/_index.adoc:2634 #, no-wrap msgid "`Security:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2634 +#: documentation/content/en/articles/committers-guide/_index.adoc:2636 #, no-wrap msgid "If the change is related to a security vulnerability or security exposure, include one or more references or a description of the issue. If possible, include a VuXML URL or a CVE ID." msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2635 +#: documentation/content/en/articles/committers-guide/_index.adoc:2637 #, no-wrap msgid "`Event:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2637 +#: documentation/content/en/articles/committers-guide/_index.adoc:2639 #, no-wrap msgid "The description for the event where this commit was made. If this is a recurring event, add the year or even the month to it. For example, this could be `FooBSDcon 2019`. The idea behind this line is to put recognition to conferences, gatherings, and other types of meetups and to show that these are useful to have. Please do not use the `Sponsored by:` line for this as that is meant for organizations sponsoring certain features or developers working on them." msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2638 +#: documentation/content/en/articles/committers-guide/_index.adoc:2640 #, no-wrap msgid "`Sponsored by:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2640 +#: documentation/content/en/articles/committers-guide/_index.adoc:2642 #, no-wrap msgid "Sponsoring organizations for this change, if any. Separate multiple organizations with commas. If only a portion of the work was sponsored, or different amounts of sponsorship were provided to different authors, please give appropriate credit in parentheses after each sponsor name. For example, `Example.com (alice, code refactoring), Wormulon (bob), Momcorp (cindy)` shows that Alice was sponsored by Example.com to do code refactoring, while Wormulon sponsored Bob's work and Momcorp sponsored Cindy's work. Other authors were either not sponsored or chose not to list sponsorship." msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2641 +#: documentation/content/en/articles/committers-guide/_index.adoc:2643 #, no-wrap msgid "`Pull Request:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2645 +#: documentation/content/en/articles/committers-guide/_index.adoc:2647 #, no-wrap msgid "" "This change was submitted as a pull request or merge request against one of FreeBSD's public read-only Git repositories.\n" @@ -5484,13 +5495,13 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2646 +#: documentation/content/en/articles/committers-guide/_index.adoc:2648 #, no-wrap msgid "`Co-authored-by:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2649 +#: documentation/content/en/articles/committers-guide/_index.adoc:2651 #, no-wrap msgid "" "The name and email address of an additional author of the commit.\n" @@ -5498,73 +5509,73 @@ msgid "" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2650 +#: documentation/content/en/articles/committers-guide/_index.adoc:2652 #, no-wrap msgid "`Signed-off-by:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2652 +#: documentation/content/en/articles/committers-guide/_index.adoc:2654 #, no-wrap msgid "ID certifies compliance with https://developercertificate.org/" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2653 +#: documentation/content/en/articles/committers-guide/_index.adoc:2655 #, no-wrap msgid "`Differential Revision:`" msgstr "" #. type: Table -#: documentation/content/en/articles/committers-guide/_index.adoc:2655 +#: documentation/content/en/articles/committers-guide/_index.adoc:2657 #, no-wrap msgid "The full URL of the Phabricator review. This line __must be the last line__. For example: `https://reviews.freebsd.org/D1708`." msgstr "" #. type: Block title -#: documentation/content/en/articles/committers-guide/_index.adoc:2657 +#: documentation/content/en/articles/committers-guide/_index.adoc:2659 #, no-wrap msgid "Commit Log for a Commit Based on a PR" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2663 +#: documentation/content/en/articles/committers-guide/_index.adoc:2665 msgid "" "The commit is based on a patch from a PR submitted by John Smith. The " "commit message \"PR\" field is filled." msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2667 -#: documentation/content/en/articles/committers-guide/_index.adoc:2685 -#: documentation/content/en/articles/committers-guide/_index.adoc:2700 -#: documentation/content/en/articles/committers-guide/_index.adoc:2716 -#: documentation/content/en/articles/committers-guide/_index.adoc:2731 +#: documentation/content/en/articles/committers-guide/_index.adoc:2669 +#: documentation/content/en/articles/committers-guide/_index.adoc:2687 +#: documentation/content/en/articles/committers-guide/_index.adoc:2702 +#: documentation/content/en/articles/committers-guide/_index.adoc:2718 +#: documentation/content/en/articles/committers-guide/_index.adoc:2733 #, no-wrap msgid "...\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2669 +#: documentation/content/en/articles/committers-guide/_index.adoc:2671 #, no-wrap msgid "PR:\t\t12345\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2672 +#: documentation/content/en/articles/committers-guide/_index.adoc:2674 msgid "" "The committer sets the author of the patch with `git commit --author \"John " "Smith <John.Smith@example.com>\"`." msgstr "" #. type: Block title -#: documentation/content/en/articles/committers-guide/_index.adoc:2675 +#: documentation/content/en/articles/committers-guide/_index.adoc:2677 #, no-wrap msgid "Commit Log for a Commit Needing Review" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2681 +#: documentation/content/en/articles/committers-guide/_index.adoc:2683 msgid "" "The virtual memory system is being changed. After posting patches to the " "appropriate mailing list (in this case, `freebsd-arch`) and the changes have " @@ -5572,73 +5583,73 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2687 +#: documentation/content/en/articles/committers-guide/_index.adoc:2689 #, no-wrap msgid "Reviewed by:\t-arch\n" msgstr "" #. type: Block title -#: documentation/content/en/articles/committers-guide/_index.adoc:2691 +#: documentation/content/en/articles/committers-guide/_index.adoc:2693 #, no-wrap msgid "Commit Log for a Commit Needing Approval" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2696 +#: documentation/content/en/articles/committers-guide/_index.adoc:2698 msgid "" "Commit a port, after working with the listed MAINTAINER, who said to go " "ahead and commit." msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2702 +#: documentation/content/en/articles/committers-guide/_index.adoc:2704 #, no-wrap msgid "Approved by:\tabc (maintainer)\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2705 +#: documentation/content/en/articles/committers-guide/_index.adoc:2707 msgid "Where _abc_ is the account name of the person who approved." msgstr "" #. type: Block title -#: documentation/content/en/articles/committers-guide/_index.adoc:2707 +#: documentation/content/en/articles/committers-guide/_index.adoc:2709 #, no-wrap msgid "Commit Log for a Commit Bringing in Code from OpenBSD" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2712 +#: documentation/content/en/articles/committers-guide/_index.adoc:2714 msgid "Committing some code based on work done in the OpenBSD project." msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2718 +#: documentation/content/en/articles/committers-guide/_index.adoc:2720 #, no-wrap msgid "Obtained from:\tOpenBSD\n" msgstr "" #. type: Block title -#: documentation/content/en/articles/committers-guide/_index.adoc:2722 +#: documentation/content/en/articles/committers-guide/_index.adoc:2724 #, no-wrap msgid "Commit Log for a Change to FreeBSD-CURRENT with a Planned Commit to FreeBSD-STABLE to Follow at a Later Date." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2727 +#: documentation/content/en/articles/committers-guide/_index.adoc:2729 msgid "" "Committing some code which will be merged from FreeBSD-CURRENT into the " "FreeBSD-STABLE branch after two weeks." msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2733 +#: documentation/content/en/articles/committers-guide/_index.adoc:2735 #, no-wrap msgid "MFC after:\t2 weeks\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2736 +#: documentation/content/en/articles/committers-guide/_index.adoc:2738 msgid "" "Where _2_ is the number of days, weeks, or months after which an MFC is " "planned. The _weeks_ option may be `day`, `days`, `week`, `weeks`, `month`, " @@ -5646,12 +5657,12 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2739 +#: documentation/content/en/articles/committers-guide/_index.adoc:2741 msgid "It is often necessary to combine these." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2743 +#: documentation/content/en/articles/committers-guide/_index.adoc:2745 msgid "" "Consider the situation where a user has submitted a PR containing code from " "the NetBSD project. Looking at the PR, the developer sees it is not an area " @@ -5661,19 +5672,19 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2745 +#: documentation/content/en/articles/committers-guide/_index.adoc:2747 msgid "" "The extra information to include in the commit would look something like" msgstr "" #. type: Block title -#: documentation/content/en/articles/committers-guide/_index.adoc:2746 +#: documentation/content/en/articles/committers-guide/_index.adoc:2748 #, no-wrap msgid "Example Combined Commit Log" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2757 +#: documentation/content/en/articles/committers-guide/_index.adoc:2759 #, no-wrap msgid "" "PR:\t\t54321\n" @@ -5684,33 +5695,33 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:2762 +#: documentation/content/en/articles/committers-guide/_index.adoc:2764 #, no-wrap msgid "Preferred License for New Files" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2768 +#: documentation/content/en/articles/committers-guide/_index.adoc:2770 msgid "" -"The FreeBSD Project's full license policy can be found at link:https://www." -"FreeBSD.org/internal/software-license/[https://www.FreeBSD.org/internal/" +"The FreeBSD Project's full license policy can be found at link:https://" +"www.FreeBSD.org/internal/software-license/[https://www.FreeBSD.org/internal/" "software-license]. The rest of this section is intended to help you get " "started. As a rule, when in doubt, ask. It is much easier to give advice " "than to fix the source tree." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2770 +#: documentation/content/en/articles/committers-guide/_index.adoc:2772 msgid "" "The FreeBSD Project suggests and uses this text as the preferred license " "scheme:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2801 +#: documentation/content/en/articles/committers-guide/_index.adoc:2803 #, no-wrap msgid "" -"/*-\n" +"/*\n" " * SPDX-License-Identifier: BSD-2-Clause\n" " *\n" " * Copyright (c) [year] [your name]\n" @@ -5741,7 +5752,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2807 +#: documentation/content/en/articles/committers-guide/_index.adoc:2809 msgid "" "The FreeBSD project strongly discourages the so-called \"advertising " "clause\" in new code. Due to the large number of contributors to the " @@ -5752,7 +5763,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2811 +#: documentation/content/en/articles/committers-guide/_index.adoc:2813 msgid "" "The FreeBSD project discourages completely new licenses and variations on " "the standard licenses. New licenses require the approval of {core-email} to " @@ -5763,7 +5774,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2815 +#: documentation/content/en/articles/committers-guide/_index.adoc:2817 msgid "" "Project policy dictates that code under some non-BSD licenses must be placed " "only in specific sections of the repository, and in some cases, compilation " @@ -5774,7 +5785,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2818 +#: documentation/content/en/articles/committers-guide/_index.adoc:2820 msgid "" "Developers are reminded that in open source, getting \"open\" right is just " "as important as getting \"source\" right, as improper handling of " @@ -5783,13 +5794,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:2820 +#: documentation/content/en/articles/committers-guide/_index.adoc:2822 #, no-wrap msgid "Keeping Track of Licenses Granted to the FreeBSD Project" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2825 +#: documentation/content/en/articles/committers-guide/_index.adoc:2827 msgid "" "Various software or data exist in the repositories where the FreeBSD project " "has been granted a special license to be able to use them. A case in point " @@ -5800,7 +5811,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2830 +#: documentation/content/en/articles/committers-guide/_index.adoc:2832 msgid "" "It is clearly sensible to keep a record of any such license grants. To that " "end, the {core-email} has decided to keep an archive of them. Whenever the " @@ -5810,13 +5821,13 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2832 +#: documentation/content/en/articles/committers-guide/_index.adoc:2834 msgid "" "Contact details for people or organizations granting the special license." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2833 +#: documentation/content/en/articles/committers-guide/_index.adoc:2835 msgid "" "What files, directories etc. in the repositories are covered by the license " "grant including the revision numbers where any specially licensed material " @@ -5824,7 +5835,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2834 +#: documentation/content/en/articles/committers-guide/_index.adoc:2836 msgid "" "The date the license comes into effect from. Unless otherwise agreed, this " "will be the date the license was issued by the authors of the software in " @@ -5832,24 +5843,24 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2835 +#: documentation/content/en/articles/committers-guide/_index.adoc:2837 msgid "The license text." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2836 +#: documentation/content/en/articles/committers-guide/_index.adoc:2838 msgid "" "A note of any restrictions, limitations or exceptions that apply " "specifically to FreeBSD's usage of the licensed material." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2837 +#: documentation/content/en/articles/committers-guide/_index.adoc:2839 msgid "Any other relevant information." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2840 +#: documentation/content/en/articles/committers-guide/_index.adoc:2842 msgid "" "Once the {core-email} is satisfied that all the necessary details have been " "gathered and are correct, the secretary will send a PGP-signed " @@ -5859,7 +5870,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2843 +#: documentation/content/en/articles/committers-guide/_index.adoc:2845 msgid "" "The license archive should contain only details of license grants; this is " "not the place for any discussions around licensing or other subjects. " @@ -5868,13 +5879,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:2845 +#: documentation/content/en/articles/committers-guide/_index.adoc:2847 #, no-wrap msgid "SPDX Tags in the tree" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2856 +#: documentation/content/en/articles/committers-guide/_index.adoc:2858 msgid "" "The project uses https://spdx.dev[SPDX] tags in our source base. At " "present, these tags are indented to help automated tools reconstruct license " @@ -5893,20 +5904,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2858 +#: documentation/content/en/articles/committers-guide/_index.adoc:2860 msgid "" "As of March 2021, approximately 25,000 out of 90,000 files in the tree have " "been marked." msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:2859 +#: documentation/content/en/articles/committers-guide/_index.adoc:2861 #, no-wrap msgid "Developer Relations" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2865 +#: documentation/content/en/articles/committers-guide/_index.adoc:2867 msgid "" "When working directly on your own code or on code which is already well " "established as your responsibility, then there is probably little need to " @@ -5919,7 +5930,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2869 +#: documentation/content/en/articles/committers-guide/_index.adoc:2871 msgid "" "To determine if an area of the tree is maintained, check the MAINTAINERS " "file at the root of the tree. If nobody is listed, scan the revision " @@ -5930,27 +5941,27 @@ msgid "" msgstr "" #. type: delimited block - 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2873 +#: documentation/content/en/articles/committers-guide/_index.adoc:2875 #, no-wrap msgid "% git -C /path/to/repo shortlog -sne --since=\"2 years\" -- relative/path/to/file\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2876 +#: documentation/content/en/articles/committers-guide/_index.adoc:2878 msgid "" "If queries go unanswered or the committer otherwise indicates a lack of " "interest in the area affected, go ahead and commit it." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2881 +#: documentation/content/en/articles/committers-guide/_index.adoc:2883 msgid "" "Avoid sending private emails to maintainers. Other people might be " "interested in the conversation, not just the final output." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2887 +#: documentation/content/en/articles/committers-guide/_index.adoc:2889 msgid "" "If there is any doubt about a commit for any reason at all, have it reviewed " "before committing. Better to have it flamed then and there rather than when " @@ -5961,7 +5972,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2891 +#: documentation/content/en/articles/committers-guide/_index.adoc:2893 msgid "" "Do not impugn the intentions of others. If they see a different solution to " "a problem, or even a different problem, it is probably not because they are " @@ -5971,7 +5982,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2894 +#: documentation/content/en/articles/committers-guide/_index.adoc:2896 msgid "" "Disagree honestly. Argue your position from its merits, be honest about any " "shortcomings it may have, and be open to seeing their solution, or even " @@ -5979,7 +5990,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2900 +#: documentation/content/en/articles/committers-guide/_index.adoc:2902 msgid "" "Accept correction. We are all fallible. When you have made a mistake, " "apologize and get on with life. Do not beat up yourself, and certainly do " @@ -5988,7 +5999,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2904 +#: documentation/content/en/articles/committers-guide/_index.adoc:2906 msgid "" "Ask for help. Seek out (and give) peer reviews. One of the ways open " "source software is supposed to excel is in the number of eyeballs applied to " @@ -5996,20 +6007,20 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:2906 +#: documentation/content/en/articles/committers-guide/_index.adoc:2908 #, no-wrap msgid "If in Doubt..." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2910 +#: documentation/content/en/articles/committers-guide/_index.adoc:2912 msgid "" "When unsure about something, whether it be a technical issue or a project " "convention be sure to ask. If you stay silent you will never make progress." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2914 +#: documentation/content/en/articles/committers-guide/_index.adoc:2916 msgid "" "If it relates to a technical issue ask on the public mailing lists. Avoid " "the temptation to email the individual person that knows the answer. This " @@ -6017,32 +6028,32 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2916 +#: documentation/content/en/articles/committers-guide/_index.adoc:2918 msgid "For project specific or administrative questions ask, in order:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2918 +#: documentation/content/en/articles/committers-guide/_index.adoc:2920 msgid "Your mentor or former mentor." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2919 +#: documentation/content/en/articles/committers-guide/_index.adoc:2921 msgid "An experienced committer on IRC, email, etc." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2920 +#: documentation/content/en/articles/committers-guide/_index.adoc:2922 msgid "Any team with a \"hat\", as they can give you a definitive answer." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2921 +#: documentation/content/en/articles/committers-guide/_index.adoc:2923 msgid "If still not sure, ask on {developers-name}." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2923 +#: documentation/content/en/articles/committers-guide/_index.adoc:2925 msgid "" "Once your question is answered, if no one pointed you to documentation that " "spelled out the answer to your question, document it, as others will have " @@ -6050,13 +6061,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:2925 +#: documentation/content/en/articles/committers-guide/_index.adoc:2927 #, no-wrap msgid "Bugzilla" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2930 +#: documentation/content/en/articles/committers-guide/_index.adoc:2932 msgid "" "The FreeBSD Project utilizes Bugzilla for tracking bugs and change " "requests. If you commit a fix or suggestion found in the PR database, be " @@ -6065,26 +6076,26 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2932 +#: documentation/content/en/articles/committers-guide/_index.adoc:2934 msgid "" "Committers with non-``FreeBSD.org`` Bugzilla accounts can have the old " "account merged with the `FreeBSD.org` account by following these steps:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2936 +#: documentation/content/en/articles/committers-guide/_index.adoc:2938 msgid "Log in using your old account." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2937 +#: documentation/content/en/articles/committers-guide/_index.adoc:2939 msgid "" "Open new bug. Choose `Services` as the Product, and `Bug Tracker` as the " "Component. In bug description list accounts you wish to be merged." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2939 +#: documentation/content/en/articles/committers-guide/_index.adoc:2941 msgid "" "Log in using `FreeBSD.org` account and post comment to newly opened bug to " "confirm ownership. See crossref:committers-guide[kerberos-ldap, Kerberos and " @@ -6093,35 +6104,35 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2940 +#: documentation/content/en/articles/committers-guide/_index.adoc:2942 msgid "" "If there are more than two accounts to merge, post comments from each of " "them." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2943 +#: documentation/content/en/articles/committers-guide/_index.adoc:2945 msgid "You can find out more about Bugzilla at:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2945 +#: documentation/content/en/articles/committers-guide/_index.adoc:2947 msgid "extref:{pr-guidelines}[FreeBSD Problem Report Handling Guidelines]" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2946 +#: documentation/content/en/articles/committers-guide/_index.adoc:2948 msgid "link:https://www.FreeBSD.org/support/[https://www.FreeBSD.org/support]" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:2948 +#: documentation/content/en/articles/committers-guide/_index.adoc:2950 #, no-wrap msgid "Phabricator" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2952 +#: documentation/content/en/articles/committers-guide/_index.adoc:2954 msgid "" "The FreeBSD Project utilizes https://reviews.freebsd.org[Phabricator] for " "code review requests. See the https://wiki.freebsd.org/" @@ -6129,19 +6140,19 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2954 +#: documentation/content/en/articles/committers-guide/_index.adoc:2956 msgid "" "Committers with non-``FreeBSD.org`` Phabricator accounts can have the old " "account renamed to the ``FreeBSD.org`` account by following these steps:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2958 +#: documentation/content/en/articles/committers-guide/_index.adoc:2960 msgid "Change your Phabricator account email to your `FreeBSD.org` email." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2960 +#: documentation/content/en/articles/committers-guide/_index.adoc:2962 msgid "" "Open new bug on our bug tracker using your `FreeBSD.org` account, see " "crossref:committers-guide[bugzilla, Bugzilla] for more information. Choose " @@ -6152,19 +6163,19 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2965 +#: documentation/content/en/articles/committers-guide/_index.adoc:2967 msgid "" "Phabricator accounts cannot be merged, please do not open a new account." msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:2968 +#: documentation/content/en/articles/committers-guide/_index.adoc:2970 #, no-wrap msgid "Who's Who" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2971 +#: documentation/content/en/articles/committers-guide/_index.adoc:2973 msgid "" "Besides the repository meisters, there are other FreeBSD project members and " "teams whom you will probably get to know in your role as a committer. " @@ -6172,33 +6183,33 @@ msgid "" msgstr "" #. type: Labeled list -#: documentation/content/en/articles/committers-guide/_index.adoc:2972 +#: documentation/content/en/articles/committers-guide/_index.adoc:2974 #, no-wrap msgid "`{doceng}`" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2978 +#: documentation/content/en/articles/committers-guide/_index.adoc:2980 msgid "" "doceng is the group responsible for the documentation build infrastructure, " "approving new documentation committers, and ensuring that the FreeBSD " "website and documentation on the FTP site is up to date with respect to the " "Subversion tree. It is not a conflict resolution body. The vast majority " "of documentation related discussion takes place on the {freebsd-doc}. More " -"details regarding the doceng team can be found in its https://www.FreeBSD." -"org/internal/doceng/[charter]. Committers interested in contributing to the " -"documentation should familiarize themselves with the extref:{fdp-primer}" -"[Documentation Project Primer]." +"details regarding the doceng team can be found in its https://" +"www.FreeBSD.org/internal/doceng/[charter]. Committers interested in " +"contributing to the documentation should familiarize themselves with the " +"extref:{fdp-primer}[Documentation Project Primer]." msgstr "" #. type: Labeled list -#: documentation/content/en/articles/committers-guide/_index.adoc:2979 +#: documentation/content/en/articles/committers-guide/_index.adoc:2981 #, no-wrap msgid "`{re-members}`" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2984 +#: documentation/content/en/articles/committers-guide/_index.adoc:2986 msgid "" "These are the members of the `{re}`. This team is responsible for setting " "release deadlines and controlling the release process. During code freezes, " @@ -6209,20 +6220,20 @@ msgid "" msgstr "" #. type: Labeled list -#: documentation/content/en/articles/committers-guide/_index.adoc:2985 +#: documentation/content/en/articles/committers-guide/_index.adoc:2987 #, no-wrap msgid "`{so}`" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2987 +#: documentation/content/en/articles/committers-guide/_index.adoc:2989 msgid "" "`{so-name}` is the link:https://www.FreeBSD.org/security/[FreeBSD Security " "Officer] and oversees the `{security-officer}`." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2992 +#: documentation/content/en/articles/committers-guide/_index.adoc:2994 msgid "" "{committers-name}:: {dev-src-all}, {dev-ports-all} and {dev-doc-all} are the " "mailing lists that the version control system uses to send commit messages " @@ -6231,7 +6242,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2997 +#: documentation/content/en/articles/committers-guide/_index.adoc:2999 msgid "" "{developers-name}:: All committers are subscribed to -developers. This list " "was created to be a forum for the committers \"community\" issues. Examples " @@ -6239,7 +6250,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3001 +#: documentation/content/en/articles/committers-guide/_index.adoc:3003 msgid "" "The {developers-name} is for the exclusive use of FreeBSD committers. To " "develop FreeBSD, committers must have the ability to openly discuss matters " @@ -6249,7 +6260,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3005 +#: documentation/content/en/articles/committers-guide/_index.adoc:3007 msgid "" "All FreeBSD committers are expected not to not publish or forward messages " "from the {developers-name} outside the list membership without permission of " @@ -6259,7 +6270,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3011 +#: documentation/content/en/articles/committers-guide/_index.adoc:3013 msgid "" "This list is _not_ intended as a place for code reviews or for any technical " "discussion. In fact using it as such hurts the FreeBSD Project as it gives " @@ -6272,13 +6283,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:3012 +#: documentation/content/en/articles/committers-guide/_index.adoc:3014 #, no-wrap msgid "SSH Quick-Start Guide" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3017 +#: documentation/content/en/articles/committers-guide/_index.adoc:3019 msgid "" "If you do not wish to type your password in every time you use man:ssh[1], " "and you use keys to authenticate, man:ssh-agent[1] is there for your " @@ -6289,28 +6300,28 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3018 +#: documentation/content/en/articles/committers-guide/_index.adoc:3020 msgid "" "Generate a key pair using man:ssh-keygen[1]. The key pair will wind up in " "your [.filename]#$HOME/.ssh/# directory." msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:3022 +#: documentation/content/en/articles/committers-guide/_index.adoc:3024 msgid "Only ECDSA, Ed25519 or RSA keys are supported." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3024 +#: documentation/content/en/articles/committers-guide/_index.adoc:3026 msgid "" -"Send your public key ([.filename]#$HOME/.ssh/id_ecdsa.pub#, [." -"filename]#$HOME/.ssh/id_ed25519.pub#, or [.filename]#$HOME/.ssh/id_rsa.pub#) " -"to the person setting you up as a committer so it can be put into [." -"filename]#yourlogin# in [.filename]#/etc/ssh-keys/# on `freefall`." +"Send your public key ([.filename]#$HOME/.ssh/id_ecdsa.pub#, " +"[.filename]#$HOME/.ssh/id_ed25519.pub#, or [.filename]#$HOME/.ssh/" +"id_rsa.pub#) to the person setting you up as a committer so it can be put " +"into [.filename]#yourlogin# in [.filename]#/etc/ssh-keys/# on `freefall`." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3029 +#: documentation/content/en/articles/committers-guide/_index.adoc:3031 msgid "" "Now man:ssh-add[1] can be used for authentication once per session. It " "prompts for the private key's pass phrase, and then stores it in the " @@ -6319,41 +6330,41 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3031 +#: documentation/content/en/articles/committers-guide/_index.adoc:3033 msgid "Test with a simple remote command: `ssh freefall.FreeBSD.org ls /usr`." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3033 +#: documentation/content/en/articles/committers-guide/_index.adoc:3035 msgid "" "For more information, see package:security/openssh-portable[], man:ssh[1], " "man:ssh-add[1], man:ssh-agent[1], man:ssh-keygen[1], and man:scp[1]." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3035 +#: documentation/content/en/articles/committers-guide/_index.adoc:3037 msgid "" "For information on adding, changing, or removing man:ssh[1] keys, see " "https://wiki.freebsd.org/clusteradm/ssh-keys[this article]." msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:3037 +#: documentation/content/en/articles/committers-guide/_index.adoc:3039 #, no-wrap msgid "Coverity(R) Availability for FreeBSD Committers" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3041 +#: documentation/content/en/articles/committers-guide/_index.adoc:3043 msgid "" "All FreeBSD developers can obtain access to Coverity analysis results of all " "FreeBSD Project software. All who are interested in obtaining access to the " -"analysis results of the automated Coverity runs, can sign up at http://scan." -"coverity.com/[Coverity Scan]." +"analysis results of the automated Coverity runs, can sign up at http://" +"scan.coverity.com/[Coverity Scan]." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3044 +#: documentation/content/en/articles/committers-guide/_index.adoc:3046 msgid "" "The FreeBSD wiki includes a mini-guide for developers who are interested in " "working with the Coverity(R) analysis reports: https://wiki.freebsd.org/" @@ -6364,7 +6375,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3046 +#: documentation/content/en/articles/committers-guide/_index.adoc:3048 msgid "" "Finally, all FreeBSD developers who are going to use Coverity(R) are always " "encouraged to ask for more details and usage information, by posting any " @@ -6372,13 +6383,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:3048 +#: documentation/content/en/articles/committers-guide/_index.adoc:3050 #, no-wrap msgid "The FreeBSD Committers' Big List of Rules" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3053 +#: documentation/content/en/articles/committers-guide/_index.adoc:3055 msgid "" "Everyone involved with the FreeBSD project is expected to abide by the _Code " "of Conduct_ available from link:https://www.FreeBSD.org/internal/code-of-" @@ -6389,34 +6400,34 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3055 -#: documentation/content/en/articles/committers-guide/_index.adoc:3085 +#: documentation/content/en/articles/committers-guide/_index.adoc:3057 +#: documentation/content/en/articles/committers-guide/_index.adoc:3087 msgid "Respect other committers." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3056 -#: documentation/content/en/articles/committers-guide/_index.adoc:3101 +#: documentation/content/en/articles/committers-guide/_index.adoc:3058 +#: documentation/content/en/articles/committers-guide/_index.adoc:3103 msgid "Respect other contributors." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3057 -#: documentation/content/en/articles/committers-guide/_index.adoc:3116 +#: documentation/content/en/articles/committers-guide/_index.adoc:3059 +#: documentation/content/en/articles/committers-guide/_index.adoc:3118 msgid "Discuss any significant change _before_ committing." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3058 +#: documentation/content/en/articles/committers-guide/_index.adoc:3060 msgid "" -"Respect existing maintainers (if listed in the `MAINTAINER` field in [." -"filename]#Makefile# or in [.filename]#MAINTAINER# in the top-level " +"Respect existing maintainers (if listed in the `MAINTAINER` field in " +"[.filename]#Makefile# or in [.filename]#MAINTAINER# in the top-level " "directory)." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3059 -#: documentation/content/en/articles/committers-guide/_index.adoc:3131 +#: documentation/content/en/articles/committers-guide/_index.adoc:3061 +#: documentation/content/en/articles/committers-guide/_index.adoc:3133 msgid "" "Any disputed change must be backed out pending resolution of the dispute if " "requested by a maintainer. Security related changes may override a " @@ -6424,7 +6435,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3060 +#: documentation/content/en/articles/committers-guide/_index.adoc:3062 msgid "" "Changes go to FreeBSD-CURRENT before FreeBSD-STABLE unless specifically " "permitted by the release engineer or unless they are not applicable to " @@ -6436,40 +6447,40 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3061 -#: documentation/content/en/articles/committers-guide/_index.adoc:3146 +#: documentation/content/en/articles/committers-guide/_index.adoc:3063 +#: documentation/content/en/articles/committers-guide/_index.adoc:3148 msgid "Do not fight in public with other committers; it looks bad." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3062 +#: documentation/content/en/articles/committers-guide/_index.adoc:3064 msgid "" "Respect all code freezes and read the `committers` and `developers` mailing " "lists in a timely manner so you know when a code freeze is in effect." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3063 -#: documentation/content/en/articles/committers-guide/_index.adoc:3161 +#: documentation/content/en/articles/committers-guide/_index.adoc:3065 +#: documentation/content/en/articles/committers-guide/_index.adoc:3163 msgid "When in doubt on any procedure, ask first!" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3064 -#: documentation/content/en/articles/committers-guide/_index.adoc:3166 +#: documentation/content/en/articles/committers-guide/_index.adoc:3066 +#: documentation/content/en/articles/committers-guide/_index.adoc:3168 msgid "Test your changes before committing them." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3065 -#: documentation/content/en/articles/committers-guide/_index.adoc:3176 +#: documentation/content/en/articles/committers-guide/_index.adoc:3067 +#: documentation/content/en/articles/committers-guide/_index.adoc:3178 msgid "" "Do not commit to contributed software without _explicit_ approval from the " "respective maintainers." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3076 +#: documentation/content/en/articles/committers-guide/_index.adoc:3078 msgid "" "As noted, breaking some of these rules can be grounds for suspension or, " "upon repeated offense, permanent removal of commit privileges. Individual " @@ -6495,7 +6506,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3080 +#: documentation/content/en/articles/committers-guide/_index.adoc:3082 msgid "" "In all other aspects of project operation, core is a subset of committers " "and is bound by the __same rules__. Just because someone is in core this " @@ -6506,13 +6517,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3081 +#: documentation/content/en/articles/committers-guide/_index.adoc:3083 #, no-wrap msgid "Details" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3089 +#: documentation/content/en/articles/committers-guide/_index.adoc:3091 msgid "" "This means that you need to treat other committers as the peer-group " "developers that they are. Despite our occasional attempts to prove the " @@ -6524,7 +6535,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3091 +#: documentation/content/en/articles/committers-guide/_index.adoc:3093 msgid "" "Being able to work together long term is this project's greatest asset, one " "far more important than any set of changes to the code, and turning " @@ -6534,7 +6545,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3097 +#: documentation/content/en/articles/committers-guide/_index.adoc:3099 msgid "" "To comply with this rule, do not send email when you are angry or otherwise " "behave in a manner which is likely to strike others as needlessly " @@ -6553,7 +6564,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3100 +#: documentation/content/en/articles/committers-guide/_index.adoc:3102 msgid "" "All of this is never an option which the project's leadership enjoys in the " "slightest, but unity comes first. No amount of code or good advice is worth " @@ -6561,7 +6572,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3113 +#: documentation/content/en/articles/committers-guide/_index.adoc:3115 msgid "" "You were not always a committer. At one time you were a contributor. " "Remember that at all times. Remember what it was like trying to get help " @@ -6575,14 +6586,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3115 +#: documentation/content/en/articles/committers-guide/_index.adoc:3117 msgid "" "Consider the points raised under crossref:committers-guide[respect,Respect " "other committers] and apply them also to contributors." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3122 +#: documentation/content/en/articles/committers-guide/_index.adoc:3124 msgid "" "The repository is not where changes are initially submitted for correctness " "or argued over, that happens first in the mailing lists or by use of the " @@ -6598,17 +6609,17 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3124 +#: documentation/content/en/articles/committers-guide/_index.adoc:3126 msgid "When in doubt, ask for review!" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3125 +#: documentation/content/en/articles/committers-guide/_index.adoc:3127 msgid "Respect existing maintainers if listed." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3130 +#: documentation/content/en/articles/committers-guide/_index.adoc:3132 msgid "" "Many parts of FreeBSD are not \"owned\" in the sense that any specific " "individual will jump up and yell if you commit a change to \"their\" area, " @@ -6624,7 +6635,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3136 +#: documentation/content/en/articles/committers-guide/_index.adoc:3138 msgid "" "This may be hard to swallow in times of conflict (when each side is " "convinced that they are in the right, of course) but a version control " @@ -6642,7 +6653,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3137 +#: documentation/content/en/articles/committers-guide/_index.adoc:3139 msgid "" "Changes go to FreeBSD-CURRENT before FreeBSD-STABLE unless specifically " "permitted by the release engineer or unless they are not applicable to " @@ -6653,7 +6664,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3143 +#: documentation/content/en/articles/committers-guide/_index.adoc:3145 msgid "" "This is another \"do not argue about it\" issue since it is the release " "engineer who is ultimately responsible (and gets beaten up) if a change " @@ -6672,7 +6683,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3145 +#: documentation/content/en/articles/committers-guide/_index.adoc:3147 msgid "" "Changes to the security branches (for example, `releng/9.3`) must be " "approved by a member of the `{security-officer}`, or in some cases, by a " @@ -6680,7 +6691,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3156 +#: documentation/content/en/articles/committers-guide/_index.adoc:3158 msgid "" "This project has a public image to uphold and that image is very important " "to all of us, especially if we are to continue to attract new members. " @@ -6705,14 +6716,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3157 +#: documentation/content/en/articles/committers-guide/_index.adoc:3159 msgid "" "Respect all code freezes and read the `committers` and `developers` mailing " "list on a timely basis so you know when a code freeze is in effect." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3160 +#: documentation/content/en/articles/committers-guide/_index.adoc:3162 msgid "" "Committing unapproved changes during a code freeze is a really big mistake " "and committers are expected to keep up-to-date on what is going on before " @@ -6723,7 +6734,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3165 +#: documentation/content/en/articles/committers-guide/_index.adoc:3167 msgid "" "Many mistakes are made because someone is in a hurry and just assumes they " "know the right way of doing something. If you have not done it before, " @@ -6735,7 +6746,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3175 +#: documentation/content/en/articles/committers-guide/_index.adoc:3177 msgid "" "If your changes are to the kernel, make sure you can still compile both " "GENERIC and LINT. If your changes are anywhere else, make sure you can " @@ -6743,22 +6754,22 @@ msgid "" "occurs with a machine which is running that code. If you have a change " "which also may break another architecture, be sure and test on all supported " "architectures. Please ensure your change works for crossref:committers-" -"guide[compilers,supported toolchains]. Please refer to the https://www." -"FreeBSD.org/internal/[FreeBSD Internal Page] for a list of available " +"guide[compilers,supported toolchains]. Please refer to the https://" +"www.FreeBSD.org/internal/[FreeBSD Internal Page] for a list of available " "resources. As other architectures are added to the FreeBSD supported " "platforms list, the appropriate shared testing resources will be made " "available." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3178 +#: documentation/content/en/articles/committers-guide/_index.adoc:3180 msgid "" -"Contributed software is anything under the [.filename]#src/contrib#, [." -"filename]#src/crypto#, or [.filename]#src/sys/contrib# trees." +"Contributed software is anything under the [.filename]#src/contrib#, " +"[.filename]#src/crypto#, or [.filename]#src/sys/contrib# trees." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3183 +#: documentation/content/en/articles/committers-guide/_index.adoc:3185 msgid "" "The trees mentioned above are for contributed software usually imported onto " "a vendor branch. Committing something there may cause unnecessary headaches " @@ -6768,7 +6779,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3187 +#: documentation/content/en/articles/committers-guide/_index.adoc:3189 msgid "" "Reasons for modifying upstream software range from wanting strict control " "over a tightly coupled dependency to lack of portability in the canonical " @@ -6780,7 +6791,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3190 +#: documentation/content/en/articles/committers-guide/_index.adoc:3192 msgid "" "If a particular piece of software lacks a maintainer, you are encouraged to " "take up ownership. If you are unsure of the current maintainership email " @@ -6788,13 +6799,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3191 +#: documentation/content/en/articles/committers-guide/_index.adoc:3193 #, no-wrap msgid "Policy on Multiple Architectures" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3195 +#: documentation/content/en/articles/committers-guide/_index.adoc:3197 msgid "" "FreeBSD has added several new architecture ports during recent release " "cycles and is truly no longer an i386(TM) centric operating system. In an " @@ -6803,7 +6814,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3199 +#: documentation/content/en/articles/committers-guide/_index.adoc:3201 msgid "" "Our 32-bit reference platform is i386, and our 64-bit reference platform is " "amd64. Major design work (including major API and ABI changes) must prove " @@ -6813,7 +6824,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3203 +#: documentation/content/en/articles/committers-guide/_index.adoc:3205 msgid "" "Developers should also be aware of our Tier Policy for the long term support " "of hardware architectures. The rules here are intended to provide guidance " @@ -6824,13 +6835,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3205 +#: documentation/content/en/articles/committers-guide/_index.adoc:3207 #, no-wrap msgid "Policy on Multiple Compilers" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3219 +#: documentation/content/en/articles/committers-guide/_index.adoc:3221 msgid "" "FreeBSD builds with both Clang and GCC. The project does this in a careful " "and controlled way to maximize benefits from this extra work, while keeping " @@ -6856,7 +6867,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3224 +#: documentation/content/en/articles/committers-guide/_index.adoc:3226 msgid "" "The FreeBSD project provides an in-tree Clang compiler. Due to being in the " "tree, this compiler is the most supported compiler. All changes must " @@ -6865,7 +6876,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3232 +#: documentation/content/en/articles/committers-guide/_index.adoc:3234 msgid "" "At any moment in time, the FreeBSD project also supports one or more out-of-" "tree compilers. At present, this is GCC 12.x. Ideally, committers should " @@ -6880,7 +6891,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3236 +#: documentation/content/en/articles/committers-guide/_index.adoc:3238 msgid "" "The FreeBSD project also has some CI pipelines on github. For pull requests " "on github and some branches pushed to the github forks, a number of cross " @@ -6889,7 +6900,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3242 +#: documentation/content/en/articles/committers-guide/_index.adoc:3244 msgid "" "The FreeBSD project is also upgrading compilers. Both Clang and GCC are " "fast moving targets. Some work to change things in the tree, for example " @@ -6902,7 +6913,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3246 +#: documentation/content/en/articles/committers-guide/_index.adoc:3248 msgid "" "In addition to the compiler, LLVM's LLD and GNU's binutils are used " "indirectly by the compiler. Committers should be mindful of variations in " @@ -6912,7 +6923,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3252 +#: documentation/content/en/articles/committers-guide/_index.adoc:3254 msgid "" "The FreeBSD project provides headers and libraries that allow other " "compilers to be used to build software not in the base system. These " @@ -6927,7 +6938,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3257 +#: documentation/content/en/articles/committers-guide/_index.adoc:3259 msgid "" "The FreeBSD build system currently accommodates these different " "environments. As new warnings are added to compilers, the project tries to " @@ -6939,13 +6950,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3258 +#: documentation/content/en/articles/committers-guide/_index.adoc:3260 #, no-wrap msgid "Current Compiler Versions" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3263 +#: documentation/content/en/articles/committers-guide/_index.adoc:3265 msgid "" "The in-tree compiler is currently Clang 15.x. Currently, GCC 12 and Clang " "12, 13, 14 and 15 are tested in the github and project's CI jenkins jobs. " @@ -6955,13 +6966,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3264 +#: documentation/content/en/articles/committers-guide/_index.adoc:3266 #, no-wrap msgid "Other Suggestions" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3268 +#: documentation/content/en/articles/committers-guide/_index.adoc:3270 msgid "" "When committing documentation changes, use a spell checker before " "committing. For all XML docs, verify that the formatting directives are " @@ -6969,7 +6980,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3270 +#: documentation/content/en/articles/committers-guide/_index.adoc:3272 msgid "" "For manual pages, run package:sysutils/manck[] and package:textproc/igor[] " "over the manual page to verify all of the cross references and file " @@ -6978,7 +6989,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3277 +#: documentation/content/en/articles/committers-guide/_index.adoc:3279 msgid "" "Do not mix style fixes with new functionality. A style fix is any change " "which does not modify the functionality of the code. Mixing the changes " @@ -6991,20 +7002,20 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3278 +#: documentation/content/en/articles/committers-guide/_index.adoc:3280 #, no-wrap msgid "Deprecating Features" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3281 +#: documentation/content/en/articles/committers-guide/_index.adoc:3283 msgid "" "When it is necessary to remove functionality from software in the base " "system, follow these guidelines whenever possible:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3283 +#: documentation/content/en/articles/committers-guide/_index.adoc:3285 msgid "" "Mention is made in the manual page and possibly the release notes that the " "option, utility, or interface is deprecated. Use of the deprecated feature " @@ -7012,14 +7023,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3284 +#: documentation/content/en/articles/committers-guide/_index.adoc:3286 msgid "" "The option, utility, or interface is preserved until the next major (point " "zero) release." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3285 +#: documentation/content/en/articles/committers-guide/_index.adoc:3287 msgid "" "The option, utility, or interface is removed and no longer documented. It is " "now obsolete. It is also generally a good idea to note its removal in the " @@ -7027,18 +7038,18 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3286 +#: documentation/content/en/articles/committers-guide/_index.adoc:3288 #, no-wrap msgid "Privacy and Confidentiality" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3289 +#: documentation/content/en/articles/committers-guide/_index.adoc:3291 msgid "Most FreeBSD business is done in public." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3292 +#: documentation/content/en/articles/committers-guide/_index.adoc:3294 msgid "" "FreeBSD is an _open_ project. Which means that not only can anyone use the " "source code, but that most of the development process is open to public " @@ -7046,12 +7057,12 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3293 +#: documentation/content/en/articles/committers-guide/_index.adoc:3295 msgid "Certain sensitive matters must remain private or held under embargo." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3299 +#: documentation/content/en/articles/committers-guide/_index.adoc:3301 msgid "" "There unfortunately cannot be complete transparency. As a FreeBSD developer " "you will have a certain degree of privileged access to information. " @@ -7062,14 +7073,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3300 +#: documentation/content/en/articles/committers-guide/_index.adoc:3302 msgid "" "The Security Officer has sole control over the release of security " "advisories." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3305 +#: documentation/content/en/articles/committers-guide/_index.adoc:3307 msgid "" "Where there are security problems that affect many different operating " "systems, FreeBSD frequently depends on early access to be able to prepare " @@ -7082,13 +7093,13 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3306 +#: documentation/content/en/articles/committers-guide/_index.adoc:3308 msgid "" "Communications with Core are kept confidential for as long as necessary." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3311 +#: documentation/content/en/articles/committers-guide/_index.adoc:3313 msgid "" "Communications to core will initially be treated as confidential. " "Eventually however, most of Core's business will be summarized into the " @@ -7099,14 +7110,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3312 +#: documentation/content/en/articles/committers-guide/_index.adoc:3314 msgid "" "Non-disclosure Agreements may be required for access to certain commercially " "sensitive data." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3315 +#: documentation/content/en/articles/committers-guide/_index.adoc:3317 msgid "" "Access to certain commercially sensitive data may only be available under a " "Non-Disclosure Agreement. The FreeBSD Foundation legal staff must be " @@ -7114,12 +7125,12 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3316 +#: documentation/content/en/articles/committers-guide/_index.adoc:3318 msgid "Private communications must not be made public without permission." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3319 +#: documentation/content/en/articles/committers-guide/_index.adoc:3321 msgid "" "Beyond the specific requirements above there is a general expectation not to " "publish private communications between developers without the consent of all " @@ -7129,14 +7140,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3320 +#: documentation/content/en/articles/committers-guide/_index.adoc:3322 msgid "" "Communications on project-only or restricted access channels must be kept " "private." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3323 +#: documentation/content/en/articles/committers-guide/_index.adoc:3325 msgid "" "Similarly to personal communications, certain internal communications " "channels, including FreeBSD Committer only mailing lists and restricted " @@ -7145,12 +7156,12 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3324 +#: documentation/content/en/articles/committers-guide/_index.adoc:3326 msgid "Core may approve publication." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3326 +#: documentation/content/en/articles/committers-guide/_index.adoc:3328 msgid "" "Where it is impractical to obtain permission due to the number of " "correspondents or where permission to publish is unreasonably withheld, Core " @@ -7159,13 +7170,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:3328 +#: documentation/content/en/articles/committers-guide/_index.adoc:3330 #, no-wrap msgid "Support for Multiple Architectures" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3335 +#: documentation/content/en/articles/committers-guide/_index.adoc:3337 msgid "" "FreeBSD is a highly portable operating system intended to function on many " "different types of hardware architectures. Maintaining clean separation of " @@ -7181,13 +7192,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3336 +#: documentation/content/en/articles/committers-guide/_index.adoc:3338 #, no-wrap msgid "Statement of General Intent" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3341 +#: documentation/content/en/articles/committers-guide/_index.adoc:3343 msgid "" "The FreeBSD Project targets \"production quality commercial off-the-shelf " "(COTS) workstation, server, and high-end embedded systems\". By retaining a " @@ -7203,7 +7214,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3348 +#: documentation/content/en/articles/committers-guide/_index.adoc:3350 msgid "" "The FreeBSD Project differentiates platform targets into four tiers. Each " "tier includes a list of guarantees consumers may rely on as well as " @@ -7217,13 +7228,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3349 +#: documentation/content/en/articles/committers-guide/_index.adoc:3351 #, no-wrap msgid "Platform Targets" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3356 +#: documentation/content/en/articles/committers-guide/_index.adoc:3358 msgid "" "Support for a hardware platform consists of two components: kernel support " "and userland Application Binary Interfaces (ABIs). Kernel platform support " @@ -7238,7 +7249,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3358 +#: documentation/content/en/articles/committers-guide/_index.adoc:3360 msgid "" "A FreeBSD kernel also uses an ABI (sometimes referred to as the Kernel " "Binary Interface (KBI)) which includes the semantics and layouts of public " @@ -7247,7 +7258,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3363 +#: documentation/content/en/articles/committers-guide/_index.adoc:3365 msgid "" "A FreeBSD kernel may support multiple userland ABIs. For example, FreeBSD's " "amd64 kernel supports FreeBSD amd64 and i386 userland ABIs as well as Linux " @@ -7258,20 +7269,20 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3365 +#: documentation/content/en/articles/committers-guide/_index.adoc:3367 msgid "" "Tiers are defined for both kernels and userland ABIs. In the common case, a " "platform's kernel and FreeBSD ABIs are assigned to the same tier." msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3366 +#: documentation/content/en/articles/committers-guide/_index.adoc:3368 #, no-wrap msgid "Tier 1: Fully-Supported Architectures" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3371 +#: documentation/content/en/articles/committers-guide/_index.adoc:3373 msgid "" "Tier 1 platforms are the most mature FreeBSD platforms. They are supported " "by the security officer, release engineering, and Ports Management Team. " @@ -7281,42 +7292,42 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3373 +#: documentation/content/en/articles/committers-guide/_index.adoc:3375 msgid "" "The FreeBSD Project provides the following guarantees to consumers of Tier 1 " "platforms:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3375 +#: documentation/content/en/articles/committers-guide/_index.adoc:3377 msgid "" "Official FreeBSD release images will be provided by the release engineering " "team." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3376 +#: documentation/content/en/articles/committers-guide/_index.adoc:3378 msgid "" "Binary updates and source patches for Security Advisories and Errata Notices " "will be provided for supported releases." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3377 +#: documentation/content/en/articles/committers-guide/_index.adoc:3379 msgid "" "Source patches for Security Advisories will be provided for supported " "branches." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3378 +#: documentation/content/en/articles/committers-guide/_index.adoc:3380 msgid "" "Binary updates and source patches for cross-platform Security Advisories " "will typically be provided at the time of the announcement." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3379 +#: documentation/content/en/articles/committers-guide/_index.adoc:3381 msgid "" "Changes to userland ABIs will generally include compatibility shims to " "ensure correct operation of binaries compiled against any stable branch " @@ -7326,7 +7337,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3380 +#: documentation/content/en/articles/committers-guide/_index.adoc:3382 msgid "" "Changes to certain portions of the kernel ABI will include compatibility " "shims to ensure correct operation of kernel modules compiled against the " @@ -7335,7 +7346,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3381 +#: documentation/content/en/articles/committers-guide/_index.adoc:3383 msgid "" "Official binary packages for third party software will be provided by the " "ports team. For embedded architectures, these packages may be cross-built " @@ -7343,21 +7354,21 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3382 +#: documentation/content/en/articles/committers-guide/_index.adoc:3384 msgid "" "Most relevant ports should either build or have the appropriate filters to " "prevent inappropriate ones from building." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3383 +#: documentation/content/en/articles/committers-guide/_index.adoc:3385 msgid "" "New features which are not inherently platform-specific will be fully " "functional on all Tier 1 architectures." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3384 +#: documentation/content/en/articles/committers-guide/_index.adoc:3386 msgid "" "Features and compatibility shims used by binaries compiled against older " "stable branches may be removed in newer major versions. Such removals will " @@ -7365,19 +7376,19 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3385 +#: documentation/content/en/articles/committers-guide/_index.adoc:3387 msgid "" "Tier 1 platforms should be fully documented. Basic operations will be " "documented in the FreeBSD Handbook." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3386 +#: documentation/content/en/articles/committers-guide/_index.adoc:3388 msgid "Tier 1 platforms will be included in the source tree." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3387 +#: documentation/content/en/articles/committers-guide/_index.adoc:3389 msgid "" "Tier 1 platforms should be self-hosting either via the in-tree toolchain or " "an external toolchain. If an external toolchain is required, official binary " @@ -7385,14 +7396,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3389 +#: documentation/content/en/articles/committers-guide/_index.adoc:3391 msgid "" "To maintain maturity of Tier 1 platforms, the FreeBSD Project will maintain " "the following resources to support development:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3391 +#: documentation/content/en/articles/committers-guide/_index.adoc:3393 msgid "" "Build and test automation support either in the FreeBSD.org cluster or some " "other location easily available for all developers. Embedded platforms may " @@ -7401,41 +7412,41 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3392 -#: documentation/content/en/articles/committers-guide/_index.adoc:3422 +#: documentation/content/en/articles/committers-guide/_index.adoc:3394 +#: documentation/content/en/articles/committers-guide/_index.adoc:3424 msgid "Inclusion in the `make universe` and `make tinderbox` targets." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3393 +#: documentation/content/en/articles/committers-guide/_index.adoc:3395 msgid "" "Dedicated hardware in one of the FreeBSD clusters for package building " "(either natively or via qemu-user)." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3395 +#: documentation/content/en/articles/committers-guide/_index.adoc:3397 msgid "" "Collectively, developers are required to provide the following to maintain " "the Tier 1 status of a platform:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3397 +#: documentation/content/en/articles/committers-guide/_index.adoc:3399 msgid "" "Changes to the source tree should not knowingly break the build of a Tier 1 " "platform." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3398 +#: documentation/content/en/articles/committers-guide/_index.adoc:3400 msgid "" "Tier 1 architectures must have a mature, healthy ecosystem of users and " "active developers." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3399 +#: documentation/content/en/articles/committers-guide/_index.adoc:3401 msgid "" "Developers should be able to build packages on commonly available, non-" "embedded Tier 1 systems. This can mean either native builds if non-embedded " @@ -7444,7 +7455,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3400 +#: documentation/content/en/articles/committers-guide/_index.adoc:3402 msgid "" "Changes cannot break the userland ABI. If an ABI change is required, ABI " "compatibility for existing binaries should be provided via use of symbol " @@ -7452,7 +7463,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3401 +#: documentation/content/en/articles/committers-guide/_index.adoc:3403 msgid "" "Changes merged to stable branches cannot break the protected portions of the " "kernel ABI. If a kernel ABI change is required, the change should be " @@ -7460,13 +7471,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3402 +#: documentation/content/en/articles/committers-guide/_index.adoc:3404 #, no-wrap msgid "Tier 2: Developmental and Niche Architectures" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3406 +#: documentation/content/en/articles/committers-guide/_index.adoc:3408 msgid "" "Tier 2 platforms are functional, but less mature FreeBSD platforms. They " "are not supported by the security officer, release engineering, and Ports " @@ -7474,7 +7485,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3410 +#: documentation/content/en/articles/committers-guide/_index.adoc:3412 msgid "" "Tier 2 platforms may be Tier 1 platform candidates that are still under " "active development. Architectures reaching end of life may also be moved " @@ -7484,14 +7495,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3412 +#: documentation/content/en/articles/committers-guide/_index.adoc:3414 msgid "" "The FreeBSD Project provides the following guarantees to consumers of Tier 2 " "platforms:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3414 +#: documentation/content/en/articles/committers-guide/_index.adoc:3416 msgid "" "The ports infrastructure should include basic support for Tier 2 " "architectures sufficient to support building ports and packages. This " @@ -7500,19 +7511,19 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3415 +#: documentation/content/en/articles/committers-guide/_index.adoc:3417 msgid "" "New features which are not inherently platform-specific should be feasible " "on all Tier 2 architectures if not implemented." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3416 +#: documentation/content/en/articles/committers-guide/_index.adoc:3418 msgid "Tier 2 platforms will be included in the source tree." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3417 +#: documentation/content/en/articles/committers-guide/_index.adoc:3419 msgid "" "Tier 2 platforms should be self-hosting either via the in-tree toolchain or " "an external toolchain. If an external toolchain is required, official binary " @@ -7520,41 +7531,41 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3418 +#: documentation/content/en/articles/committers-guide/_index.adoc:3420 msgid "" "Tier 2 platforms should provide functional kernels and userlands even if an " "official release distribution is not provided." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3420 +#: documentation/content/en/articles/committers-guide/_index.adoc:3422 msgid "" "To maintain maturity of Tier 2 platforms, the FreeBSD Project will maintain " "the following resources to support development:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3424 +#: documentation/content/en/articles/committers-guide/_index.adoc:3426 msgid "" "Collectively, developers are required to provide the following to maintain " "the Tier 2 status of a platform:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3426 +#: documentation/content/en/articles/committers-guide/_index.adoc:3428 msgid "" "Changes to the source tree should not knowingly break the build of a Tier 2 " "platform." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3427 +#: documentation/content/en/articles/committers-guide/_index.adoc:3429 msgid "" "Tier 2 architectures must have an active ecosystem of users and developers." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3428 +#: documentation/content/en/articles/committers-guide/_index.adoc:3430 msgid "" "While changes are permitted to break the userland ABI, the ABI should not be " "broken gratuitously. Significant userland ABI changes should be restricted " @@ -7562,20 +7573,20 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3429 +#: documentation/content/en/articles/committers-guide/_index.adoc:3431 msgid "" "New features that are not yet implemented on Tier 2 architectures should " "provide a means of disabling them on those architectures." msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3430 +#: documentation/content/en/articles/committers-guide/_index.adoc:3432 #, no-wrap msgid "Tier 3: Experimental Architectures" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3434 +#: documentation/content/en/articles/committers-guide/_index.adoc:3436 msgid "" "Tier 3 platforms have at least partial FreeBSD support. They are _not_ " "supported by the security officer, release engineering, and Ports Management " @@ -7583,7 +7594,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3437 +#: documentation/content/en/articles/committers-guide/_index.adoc:3439 msgid "" "Tier 3 platforms are architectures in the early stages of development, for " "non-mainstream hardware platforms, or which are considered legacy systems " @@ -7592,7 +7603,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3440 +#: documentation/content/en/articles/committers-guide/_index.adoc:3442 msgid "" "The FreeBSD Project provides no guarantees to consumers of Tier 3 platforms " "and is not committed to maintaining resources to support development. Tier " @@ -7601,20 +7612,20 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3441 +#: documentation/content/en/articles/committers-guide/_index.adoc:3443 #, no-wrap msgid "Unsupported Architectures" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3445 +#: documentation/content/en/articles/committers-guide/_index.adoc:3447 msgid "" "Other platforms are not supported in any form by the project. The project " "previously described these as Tier 4 systems." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3448 +#: documentation/content/en/articles/committers-guide/_index.adoc:3450 msgid "" "After a platform transitions to unsupported, all support for the platform is " "removed from the source, ports and documentation trees. Note that ports " @@ -7623,13 +7634,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3449 +#: documentation/content/en/articles/committers-guide/_index.adoc:3451 #, no-wrap msgid "Policy on Changing the Tier of an Architecture" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3453 +#: documentation/content/en/articles/committers-guide/_index.adoc:3455 msgid "" "Systems may only be moved from one tier to another by approval of the " "FreeBSD Core Team, which shall make that decision in collaboration with the " @@ -7639,48 +7650,48 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:3455 +#: documentation/content/en/articles/committers-guide/_index.adoc:3457 #, no-wrap msgid "Ports Specific FAQ" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3458 +#: documentation/content/en/articles/committers-guide/_index.adoc:3460 #, no-wrap msgid "Adding a New Port" msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3461 +#: documentation/content/en/articles/committers-guide/_index.adoc:3463 #, no-wrap msgid "How do I add a new port?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3466 +#: documentation/content/en/articles/committers-guide/_index.adoc:3468 msgid "" "Adding a port to the tree is relatively simple. Once the port is ready to be " -"added, as explained later crossref:committers-guide[ports-qa-add-new-extra," -"here], you need to add the port's directory entry in the category's [." -"filename]#Makefile#. In this [.filename]#Makefile#, ports are listed in " +"added, as explained later crossref:committers-guide[ports-qa-add-new-" +"extra,here], you need to add the port's directory entry in the category's " +"[.filename]#Makefile#. In this [.filename]#Makefile#, ports are listed in " "alphabetical order and added to the `SUBDIR` variable, like this:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3470 +#: documentation/content/en/articles/committers-guide/_index.adoc:3472 #, no-wrap msgid "\tSUBDIR += newport\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3473 +#: documentation/content/en/articles/committers-guide/_index.adoc:3475 msgid "" "Once the port and its category's Makefile are ready, the new port can be " "committed:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3478 +#: documentation/content/en/articles/committers-guide/_index.adoc:3480 #, no-wrap msgid "" "% git add category/Makefile category/newport\n" @@ -7689,7 +7700,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3482 +#: documentation/content/en/articles/committers-guide/_index.adoc:3484 msgid "" "Don't forget to crossref:committers-guide[port-commit-message-formats,setup " "git hooks for the ports tree as explained here]; a specific hook has been " @@ -7697,19 +7708,19 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3485 +#: documentation/content/en/articles/committers-guide/_index.adoc:3487 #, no-wrap msgid "Any other things I need to know when I add a new port?" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3488 +#: documentation/content/en/articles/committers-guide/_index.adoc:3490 msgid "" "Check the port, preferably to make sure it compiles and packages correctly." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3491 +#: documentation/content/en/articles/committers-guide/_index.adoc:3493 msgid "" "The extref:{porters-handbook}testing[Porters Handbook's Testing Chapter] " "contains more detailed instructions. See the extref:{porters-handbook}" @@ -7718,14 +7729,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3493 +#: documentation/content/en/articles/committers-guide/_index.adoc:3495 msgid "" "You do not necessarily have to eliminate all warnings but make sure you have " "fixed the simple ones." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3495 +#: documentation/content/en/articles/committers-guide/_index.adoc:3497 msgid "" "If the port came from a submitter who has not contributed to the Project " "before, add that person's name to the extref:{contributors}[Additional " @@ -7733,14 +7744,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3498 +#: documentation/content/en/articles/committers-guide/_index.adoc:3500 msgid "" "Close the PR if the port came in as a PR. To close a PR, change the state " "to `Issue Resolved` and the resolution as `Fixed`." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3502 +#: documentation/content/en/articles/committers-guide/_index.adoc:3504 msgid "" "If for some reason using extref:{porters-handbook}testing[poudriere, testing-" "poudriere] to test the new port is not possible, the bare minimum of testing " @@ -7748,7 +7759,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3512 +#: documentation/content/en/articles/committers-guide/_index.adoc:3514 #, no-wrap msgid "" "# make install\n" @@ -7761,85 +7772,85 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3515 +#: documentation/content/en/articles/committers-guide/_index.adoc:3517 msgid "" "Note that poudriere is the reference for package building, it the port does " "not build in poudriere, it will be removed." msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3518 +#: documentation/content/en/articles/committers-guide/_index.adoc:3520 #, no-wrap msgid "Removing an Existing Port" msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3521 +#: documentation/content/en/articles/committers-guide/_index.adoc:3523 #, no-wrap msgid "How do I remove an existing port?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3524 +#: documentation/content/en/articles/committers-guide/_index.adoc:3526 msgid "" "First, please read the section about repository copies. Before you remove " "the port, you have to verify there are no other ports depending on it." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3526 +#: documentation/content/en/articles/committers-guide/_index.adoc:3528 msgid "Make sure there is no dependency on the port in the ports collection:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3527 +#: documentation/content/en/articles/committers-guide/_index.adoc:3529 msgid "The port's PKGNAME appears in exactly one line in a recent INDEX file." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3528 +#: documentation/content/en/articles/committers-guide/_index.adoc:3530 msgid "" "No other ports contains any reference to the port's directory or PKGNAME in " "their Makefiles" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3532 +#: documentation/content/en/articles/committers-guide/_index.adoc:3534 msgid "" "When using Git, consider using man:git-grep[1], it is much faster than `grep " "-r`." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3535 +#: documentation/content/en/articles/committers-guide/_index.adoc:3537 msgid "Then, remove the port:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3539 +#: documentation/content/en/articles/committers-guide/_index.adoc:3541 msgid "Remove the port's files and directory with `git rm`." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3540 +#: documentation/content/en/articles/committers-guide/_index.adoc:3542 msgid "" -"Remove the `SUBDIR` listing of the port in the parent directory [." -"filename]#Makefile#." +"Remove the `SUBDIR` listing of the port in the parent directory " +"[.filename]#Makefile#." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3541 -#: documentation/content/en/articles/committers-guide/_index.adoc:3556 +#: documentation/content/en/articles/committers-guide/_index.adoc:3543 +#: documentation/content/en/articles/committers-guide/_index.adoc:3558 msgid "Add an entry to [.filename]#ports/MOVED#." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3542 +#: documentation/content/en/articles/committers-guide/_index.adoc:3544 msgid "Remove the port from [.filename]#ports/LEGAL# if it is there." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3547 +#: documentation/content/en/articles/committers-guide/_index.adoc:3549 msgid "" "Alternatively, you can use the rmport script, from [.filename]#ports/Tools/" "scripts#. This script was written by {vd}. When sending questions about " @@ -7848,30 +7859,30 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3549 +#: documentation/content/en/articles/committers-guide/_index.adoc:3551 #, no-wrap msgid "How do I move a port to a new location?" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3554 +#: documentation/content/en/articles/committers-guide/_index.adoc:3556 msgid "" "Perform a thorough check of the ports collection for any dependencies on the " -"old port location/name, and update them. Running `grep` on [." -"filename]#INDEX# is not enough because some ports have dependencies enabled " -"by compile-time options. A full man:git-grep[1] of the ports collection is " -"recommended." +"old port location/name, and update them. Running `grep` on " +"[.filename]#INDEX# is not enough because some ports have dependencies " +"enabled by compile-time options. A full man:git-grep[1] of the ports " +"collection is recommended." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3555 +#: documentation/content/en/articles/committers-guide/_index.adoc:3557 msgid "" "Remove the `SUBDIR` entry from the old category Makefile and add a `SUBDIR` " "entry to the new category Makefile." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3557 +#: documentation/content/en/articles/committers-guide/_index.adoc:3559 msgid "" "Search for entries in xml files inside [.filename]#ports/security/vuxml# and " "adjust them accordingly. In particular, check for previous packages with the " @@ -7879,51 +7890,51 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3558 +#: documentation/content/en/articles/committers-guide/_index.adoc:3560 msgid "Move the port with `git mv`." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3559 -#: documentation/content/en/articles/committers-guide/_index.adoc:3570 +#: documentation/content/en/articles/committers-guide/_index.adoc:3561 +#: documentation/content/en/articles/committers-guide/_index.adoc:3572 msgid "Commit the changes." msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3562 +#: documentation/content/en/articles/committers-guide/_index.adoc:3564 #, no-wrap msgid "How do I copy a port to a new location?" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3567 +#: documentation/content/en/articles/committers-guide/_index.adoc:3569 msgid "Copy port with `cp -R old-cat/old-port new-cat/new-port`." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3568 +#: documentation/content/en/articles/committers-guide/_index.adoc:3570 msgid "Add the new port to the [.filename]#new-cat/Makefile#." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3569 +#: documentation/content/en/articles/committers-guide/_index.adoc:3571 msgid "Change stuff in [.filename]#new-cat/new-port#." msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3573 +#: documentation/content/en/articles/committers-guide/_index.adoc:3575 #, no-wrap msgid "Ports Freeze" msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3576 +#: documentation/content/en/articles/committers-guide/_index.adoc:3578 #, no-wrap msgid "What is a “ports freeze”?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3583 +#: documentation/content/en/articles/committers-guide/_index.adoc:3585 msgid "" "A “ports freeze” was a restricted state the ports tree was put in before a " "release. It was used to ensure a higher quality for the packages shipped " @@ -7934,7 +7945,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3586 +#: documentation/content/en/articles/committers-guide/_index.adoc:3588 msgid "" "For more information on how to merge commits to the quarterly branch, see " "crossref:committers-guide[ports-qa-misc-request-mfh, What is the procedure " @@ -7942,32 +7953,32 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3588 +#: documentation/content/en/articles/committers-guide/_index.adoc:3590 #, no-wrap msgid "Quarterly Branches" msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3591 +#: documentation/content/en/articles/committers-guide/_index.adoc:3593 #, no-wrap msgid "What is the procedure to request authorization for merging a commit to the quarterly branch?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3594 +#: documentation/content/en/articles/committers-guide/_index.adoc:3596 msgid "" "As of November 30, 2020, there is no need to seek explicit approval to " "commit to the quarterly branch." msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3596 +#: documentation/content/en/articles/committers-guide/_index.adoc:3598 #, no-wrap msgid "What is the procedure for merging commits to the quarterly branch?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3599 +#: documentation/content/en/articles/committers-guide/_index.adoc:3601 msgid "" "Merging commits to the quarterly branch (a process we call MFH for a " "historical reason) is very similar to MFC'ing a commit in the src " @@ -7975,7 +7986,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3605 +#: documentation/content/en/articles/committers-guide/_index.adoc:3607 #, no-wrap msgid "" "% git checkout 2021Q2\n" @@ -7985,7 +7996,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3609 +#: documentation/content/en/articles/committers-guide/_index.adoc:3611 msgid "" "where `$HASH` is the hash of the commit you want to copy over to the " "quarterly branch. The `-x` parameter ensures the hash `$HASH` of the `main` " @@ -7993,19 +8004,19 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3611 +#: documentation/content/en/articles/committers-guide/_index.adoc:3613 #, no-wrap msgid "Creating a New Category" msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3614 +#: documentation/content/en/articles/committers-guide/_index.adoc:3616 #, no-wrap msgid "What is the procedure for creating a new category?" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3619 +#: documentation/content/en/articles/committers-guide/_index.adoc:3621 msgid "" "Please see extref:{porters-handbook}[Proposing a New Category, proposing-" "categories] in the Porter's Handbook. Once that procedure has been followed " @@ -8014,42 +8025,42 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3623 +#: documentation/content/en/articles/committers-guide/_index.adoc:3625 msgid "Perform any needed moves. (This only applies to physical categories.)" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3624 +#: documentation/content/en/articles/committers-guide/_index.adoc:3626 msgid "" -"Update the `VALID_CATEGORIES` definition in [.filename]#ports/Mk/bsd.port." -"mk#." +"Update the `VALID_CATEGORIES` definition in [.filename]#ports/Mk/" +"bsd.port.mk#." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3625 +#: documentation/content/en/articles/committers-guide/_index.adoc:3627 msgid "Assign the PR back to you." msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3628 +#: documentation/content/en/articles/committers-guide/_index.adoc:3630 #, no-wrap msgid "What do I need to do to implement a new physical category?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3633 +#: documentation/content/en/articles/committers-guide/_index.adoc:3635 msgid "" "Upgrade each moved port's [.filename]#Makefile#. Do not connect the new " "category to the build yet." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3635 +#: documentation/content/en/articles/committers-guide/_index.adoc:3637 msgid "To do this, you will need to:" msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:3639 +#: documentation/content/en/articles/committers-guide/_index.adoc:3641 msgid "" "Change the port's `CATEGORIES` (this was the point of the exercise, " "remember?) The new category is listed first. This will help to ensure that " @@ -8057,7 +8068,7 @@ msgid "" msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:3640 +#: documentation/content/en/articles/committers-guide/_index.adoc:3642 msgid "" "Run a `make describe`. Since the top-level `make index` that you will be " "running in a few steps is an iteration of `make describe` over the entire " @@ -8066,14 +8077,14 @@ msgid "" msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:3641 +#: documentation/content/en/articles/committers-guide/_index.adoc:3643 msgid "" -"If you want to be really thorough, now might be a good time to run man:" -"portlint[1]." +"If you want to be really thorough, now might be a good time to run " +"man:portlint[1]." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3644 +#: documentation/content/en/articles/committers-guide/_index.adoc:3646 msgid "" "Check that the ``PKGORIGIN``s are correct. The ports system uses each port's " "`CATEGORIES` entry to create its `PKGORIGIN`, which is used to connect " @@ -8083,7 +8094,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3646 +#: documentation/content/en/articles/committers-guide/_index.adoc:3648 msgid "" "To do this, use the [.filename]#chkorigin.sh# tool: `env PORTSDIR=/path/to/" "ports sh -e /path/to/ports/Tools/scripts/chkorigin.sh`. This will check " @@ -8093,7 +8104,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3647 +#: documentation/content/en/articles/committers-guide/_index.adoc:3649 msgid "" "On your own local system, test the proposed changes: first, comment out the " "SUBDIR entries in the old ports' categories' [.filename]##Makefile##s; then " @@ -8105,33 +8116,33 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3648 +#: documentation/content/en/articles/committers-guide/_index.adoc:3650 msgid "" "Once this is done, you can commit the updated [.filename]#ports/Makefile# to " -"connect the new category to the build and also commit the [." -"filename]#Makefile# changes for the old category or categories." +"connect the new category to the build and also commit the " +"[.filename]#Makefile# changes for the old category or categories." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3649 +#: documentation/content/en/articles/committers-guide/_index.adoc:3651 msgid "Add appropriate entries to [.filename]#ports/MOVED#." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3650 +#: documentation/content/en/articles/committers-guide/_index.adoc:3652 msgid "Update the documentation by modifying:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3651 -#: documentation/content/en/articles/committers-guide/_index.adoc:3660 +#: documentation/content/en/articles/committers-guide/_index.adoc:3653 +#: documentation/content/en/articles/committers-guide/_index.adoc:3662 msgid "" "the extref:{porters-handbook}[list of categories, PORTING-CATEGORIES] in the " "Porter's Handbook" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3653 +#: documentation/content/en/articles/committers-guide/_index.adoc:3655 msgid "" "Only once all the above have been done, and no one is any longer reporting " "problems with the new ports, should the old ports be deleted from their " @@ -8139,38 +8150,38 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3655 +#: documentation/content/en/articles/committers-guide/_index.adoc:3657 #, no-wrap msgid "What do I need to do to implement a new virtual category?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3658 +#: documentation/content/en/articles/committers-guide/_index.adoc:3660 msgid "" "This is much simpler than a physical category. Only a few modifications are " "needed:" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:3662 -#: documentation/content/en/articles/committers-guide/_index.adoc:3756 +#: documentation/content/en/articles/committers-guide/_index.adoc:3664 +#: documentation/content/en/articles/committers-guide/_index.adoc:3758 #, no-wrap msgid "Miscellaneous Questions" msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3665 +#: documentation/content/en/articles/committers-guide/_index.adoc:3667 #, no-wrap msgid "Are there changes that can be committed without asking the maintainer for approval?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3668 +#: documentation/content/en/articles/committers-guide/_index.adoc:3670 msgid "Blanket approval for most ports applies to these types of fixes:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3670 +#: documentation/content/en/articles/committers-guide/_index.adoc:3672 msgid "" "Most infrastructure changes to a port (that is, modernizing, but not " "changing the functionality). For example, the blanket covers converting to " @@ -8179,19 +8190,19 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3671 +#: documentation/content/en/articles/committers-guide/_index.adoc:3673 msgid "Trivial and _tested_ build and runtime fixes." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3672 +#: documentation/content/en/articles/committers-guide/_index.adoc:3674 msgid "" "Documentations or metadata changes to ports, like [.filename]#pkg-descr# or " "`COMMENT`." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3677 +#: documentation/content/en/articles/committers-guide/_index.adoc:3679 msgid "" "Exceptions to this are anything maintained by the {portmgr}, or the " "{security-officer}. No unauthorized commits may ever be made to ports " @@ -8199,63 +8210,63 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3680 +#: documentation/content/en/articles/committers-guide/_index.adoc:3682 #, no-wrap msgid "How do I know if my port is building correctly or not?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3684 +#: documentation/content/en/articles/committers-guide/_index.adoc:3686 msgid "" "The packages are built multiple times each week. If a port fails, the " "maintainer will receive an email from `pkg-fallout@FreeBSD.org`." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3686 +#: documentation/content/en/articles/committers-guide/_index.adoc:3688 msgid "" "Reports for all the package builds (official, experimental, and non-" -"regression) are aggregated at link:pkg-status.FreeBSD.org[pkg-status.FreeBSD." -"org]." +"regression) are aggregated at link:pkg-status.FreeBSD.org[pkg-" +"status.FreeBSD.org]." msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3688 +#: documentation/content/en/articles/committers-guide/_index.adoc:3690 #, no-wrap msgid "I added a new port. Do I need to add it to the [.filename]#INDEX#?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3691 +#: documentation/content/en/articles/committers-guide/_index.adoc:3693 msgid "" "No. The file can either be generated by running `make index`, or a pre-" "generated version can be downloaded with `make fetchindex`." msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3693 +#: documentation/content/en/articles/committers-guide/_index.adoc:3695 #, no-wrap msgid "Are there any other files I am not allowed to touch?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3697 +#: documentation/content/en/articles/committers-guide/_index.adoc:3699 msgid "" "Any file directly under [.filename]#ports/#, or any file under a " -"subdirectory that starts with an uppercase letter ([.filename]#Mk/#, [." -"filename]#Tools/#, etc.). In particular, the {portmgr} is very protective " +"subdirectory that starts with an uppercase letter ([.filename]#Mk/#, " +"[.filename]#Tools/#, etc.). In particular, the {portmgr} is very protective " "of [.filename]#ports/Mk/bsd.port*.mk# so do not commit changes to those " "files unless you want to face their wrath." msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3699 +#: documentation/content/en/articles/committers-guide/_index.adoc:3701 #, no-wrap msgid "What is the proper procedure for updating the checksum for a port distfile when the file changes without a version change?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3703 +#: documentation/content/en/articles/committers-guide/_index.adoc:3705 msgid "" "When the checksum for a distribution file is updated due to the author " "updating the file without changing the port revision, the commit message " @@ -8268,20 +8279,20 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:3705 +#: documentation/content/en/articles/committers-guide/_index.adoc:3707 #, no-wrap msgid "How can an experimental test build of the ports tree (exp-run) be requested?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3709 +#: documentation/content/en/articles/committers-guide/_index.adoc:3711 msgid "" "An exp-run must be completed before patches with a significant ports impact " "are committed. The patch can be against the ports tree or the base system." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3711 +#: documentation/content/en/articles/committers-guide/_index.adoc:3713 msgid "" "Full package builds will be done with the patches provided by the submitter, " "and the submitter is required to fix detected problems _(fallout)_ before " @@ -8289,22 +8300,22 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3715 +#: documentation/content/en/articles/committers-guide/_index.adoc:3717 msgid "Go to the link:https://bugs.freebsd.org/submit[Bugzilla new PR page]." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3716 +#: documentation/content/en/articles/committers-guide/_index.adoc:3718 msgid "Select the product your patch is about." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3717 +#: documentation/content/en/articles/committers-guide/_index.adoc:3719 msgid "Fill in the bug report as normal. Remember to attach the patch." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3718 +#: documentation/content/en/articles/committers-guide/_index.adoc:3720 msgid "" "If at the top it says “Show Advanced Fields” click on it. It will now say " "“Hide Advanced Fields”. Many new fields will be available. If it already " @@ -8312,56 +8323,56 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3719 +#: documentation/content/en/articles/committers-guide/_index.adoc:3721 msgid "" "In the “Flags” section, set the “exp-run” one to `?`. As for all other " "fields, hovering the mouse over any field shows more details." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3720 +#: documentation/content/en/articles/committers-guide/_index.adoc:3722 msgid "Submit. Wait for the build to run." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3721 +#: documentation/content/en/articles/committers-guide/_index.adoc:3723 msgid "{portmgr} will reply with a possible fallout." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3722 +#: documentation/content/en/articles/committers-guide/_index.adoc:3724 msgid "Depending on the fallout:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3723 +#: documentation/content/en/articles/committers-guide/_index.adoc:3725 msgid "" "If there is no fallout, the procedure stops here, and the change can be " "committed, pending any other approval required." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3724 +#: documentation/content/en/articles/committers-guide/_index.adoc:3726 msgid "" "If there is fallout, it _must_ be fixed, either by fixing the ports directly " "in the ports tree, or adding to the submitted patch." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3725 +#: documentation/content/en/articles/committers-guide/_index.adoc:3727 msgid "" "When this is done, go back to step 6 saying the fallout was fixed and wait " "for the exp-run to be run again. Repeat as long as there are broken ports." msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:3728 +#: documentation/content/en/articles/committers-guide/_index.adoc:3730 #, no-wrap msgid "Issues Specific to Developers Who Are Not Committers" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3733 +#: documentation/content/en/articles/committers-guide/_index.adoc:3735 msgid "" "A few people who have access to the FreeBSD machines do not have commit " "bits. Almost all of this document will apply to these developers as well " @@ -8370,113 +8381,113 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3735 +#: documentation/content/en/articles/committers-guide/_index.adoc:3737 msgid "crossref:committers-guide[admin, Administrative Details]" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3736 +#: documentation/content/en/articles/committers-guide/_index.adoc:3738 msgid "crossref:committers-guide[conventions-everyone, For Everyone]" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3740 +#: documentation/content/en/articles/committers-guide/_index.adoc:3742 msgid "" -"Get your mentor to add you to the \"Additional Contributors\" ([." -"filename]#doc/shared/contrib-additional.adoc#), if you are not already " +"Get your mentor to add you to the \"Additional Contributors\" " +"([.filename]#doc/shared/contrib-additional.adoc#), if you are not already " "listed there." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3742 +#: documentation/content/en/articles/committers-guide/_index.adoc:3744 msgid "crossref:committers-guide[developer.relations, Developer Relations]" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3743 +#: documentation/content/en/articles/committers-guide/_index.adoc:3745 msgid "crossref:committers-guide[ssh.guide, SSH Quick-Start Guide]" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3744 +#: documentation/content/en/articles/committers-guide/_index.adoc:3746 msgid "" "crossref:committers-guide[rules, The FreeBSD Committers' Big List of Rules]" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:3746 +#: documentation/content/en/articles/committers-guide/_index.adoc:3748 #, no-wrap msgid "Information About Google Analytics" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3749 +#: documentation/content/en/articles/committers-guide/_index.adoc:3751 msgid "" "As of December 12, 2012, Google Analytics was enabled on the FreeBSD Project " "website to collect anonymized usage statistics regarding usage of the site." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:3753 +#: documentation/content/en/articles/committers-guide/_index.adoc:3755 msgid "" "As of March 3, 2022, Google Analytics was removed from the FreeBSD Project." msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3758 +#: documentation/content/en/articles/committers-guide/_index.adoc:3760 #, no-wrap msgid "How do I access people.FreeBSD.org to put up personal or project information?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3762 +#: documentation/content/en/articles/committers-guide/_index.adoc:3764 msgid "" -"`people.FreeBSD.org` is the same as `freefall.FreeBSD.org`. Just create a [." -"filename]#public_html# directory. Anything you place in that directory will " -"automatically be visible under https://people.FreeBSD.org/[https://people." -"FreeBSD.org/]." +"`people.FreeBSD.org` is the same as `freefall.FreeBSD.org`. Just create a " +"[.filename]#public_html# directory. Anything you place in that directory " +"will automatically be visible under https://people.FreeBSD.org/[https://" +"people.FreeBSD.org/]." msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3763 +#: documentation/content/en/articles/committers-guide/_index.adoc:3765 #, no-wrap msgid "Where are the mailing list archives stored?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3766 +#: documentation/content/en/articles/committers-guide/_index.adoc:3768 msgid "" -"The mailing lists are archived under [.filename]#/local/mail# on `freefall." -"FreeBSD.org`." +"The mailing lists are archived under [.filename]#/local/mail# on " +"`freefall.FreeBSD.org`." msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3767 +#: documentation/content/en/articles/committers-guide/_index.adoc:3769 #, no-wrap msgid "I would like to mentor a new committer. What process do I need to follow?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3770 +#: documentation/content/en/articles/committers-guide/_index.adoc:3772 msgid "" "See the https://www.freebsd.org/internal/new-account/[New Account Creation " "Procedure] document on the internal pages." msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:3772 +#: documentation/content/en/articles/committers-guide/_index.adoc:3774 #, no-wrap msgid "Benefits and Perks for FreeBSD Committers" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3775 +#: documentation/content/en/articles/committers-guide/_index.adoc:3777 #, no-wrap msgid "Recognition" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3779 +#: documentation/content/en/articles/committers-guide/_index.adoc:3781 msgid "" "Recognition as a competent software engineer is the longest lasting value. " "In addition, getting a chance to work with some of the best people that " @@ -8484,33 +8495,33 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3781 +#: documentation/content/en/articles/committers-guide/_index.adoc:3783 #, no-wrap msgid "FreeBSD Mall" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3784 +#: documentation/content/en/articles/committers-guide/_index.adoc:3786 msgid "" "FreeBSD committers can get a free 4-CD or DVD set at conferences from http://" "www.freebsdmall.com[FreeBSD Mall, Inc.]." msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3786 +#: documentation/content/en/articles/committers-guide/_index.adoc:3788 #, no-wrap msgid "`Gandi.net`" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3789 +#: documentation/content/en/articles/committers-guide/_index.adoc:3791 msgid "" "https://gandi.net[Gandi] provides website hosting, cloud computing, domain " "registration, and X.509 certificate services." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3793 +#: documentation/content/en/articles/committers-guide/_index.adoc:3795 msgid "" "Gandi offers an E-rate discount to all FreeBSD developers. To streamline " "the process of getting the discount first set up a Gandi account, fill in " @@ -8520,22 +8531,22 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:3795 +#: documentation/content/en/articles/committers-guide/_index.adoc:3797 #, no-wrap msgid "`rsync.net`" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3798 +#: documentation/content/en/articles/committers-guide/_index.adoc:3800 msgid "" "https://rsync.net[rsync.net] provides cloud storage for offsite backup that " "is optimized for UNIX users. Their service runs entirely on FreeBSD and ZFS." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:3799 +#: documentation/content/en/articles/committers-guide/_index.adoc:3801 msgid "" "rsync.net offers a free-forever 500 GB account to FreeBSD developers. Simply " -"sign up at https://www.rsync.net/freebsd.html[https://www.rsync.net/freebsd." -"html] using your `@freebsd.org` address to receive this free account." +"sign up at https://www.rsync.net/freebsd.html[https://www.rsync.net/" +"freebsd.html] using your `@freebsd.org` address to receive this free account." msgstr "" diff --git a/documentation/content/en/articles/freebsd-status-report-process/_index.po b/documentation/content/en/articles/freebsd-status-report-process/_index.po index 337d39be90..c012594326 100644 --- a/documentation/content/en/articles/freebsd-status-report-process/_index.po +++ b/documentation/content/en/articles/freebsd-status-report-process/_index.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2025-01-24 10:22-0300\n" +"POT-Creation-Date: 2025-05-01 19:56-0300\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" @@ -61,9 +61,8 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:33 msgid "" -"This section provides some advice on writing status report entries from " -"mailto:theraven@FreeBSD.org[David Chisnall], experienced in technical " -"writing. Instructions on how to submit your entries are also given." +"This section provides some advice on writing status report entries. " +"Instructions on how to submit your entries are also given." msgstr "" #. type: Plain text @@ -120,7 +119,7 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:61 msgid "" -"Now the reader knows that abc is a network interface driver. Even if they " +"Now the reader knows that `abc` is a network interface driver. Even if they " "do not use any Yoyodyne products, you have communicated that FreeBSD's " "support for network devices is improving." msgstr "" @@ -635,7 +634,7 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:218 -msgid "and, depending on the season:" +msgid "and, depending on the season," msgstr "" #. type: Plain text @@ -656,27 +655,28 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:222 -msgid "EuroBSDcon September - October (Third-Fourth Quarter)." +msgid "Various conference attendees:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:223 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:225 msgid "" -"EuroBSDcon as an organization is not interested in writing reports for " -"FreeBSD (at least it was not in October 2019: its reason is that the " -"conference is not FreeBSD specific), so reports about this event should be " -"asked of members of the FreeBSD community that attended it;" +"EuroBSDcon in September - October (Third-Fourth Quarter); EuroBSDcon as an " +"organization is not interested in writing reports for FreeBSD - at least it " +"was not in October 2019: its reason is that the conference is not FreeBSD " +"specific. Hence, reports about this event should be asked of members of the " +"FreeBSD community that attended it." msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:224 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:226 msgid "" "Google Summer of Code link:mailto:soc-students@FreeBSD.org[students] and " "their link:mailto:soc-mentors@FreeBSD.org[mentors]." msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:228 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:230 msgid "" "The easiest way to send calls for status reports is to use the link:https://" "cgit.freebsd.org/doc/tree/tools/sendcalls/sendcalls[[.filename]#sendcalls# " @@ -686,13 +686,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:231 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:233 #, no-wrap msgid "0 0 1,15,24 3,6,9,12 * cd ~/doc/tools/sendcalls && git pull && ./sendcalls -s 'Lorenzo Salvadore'\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:237 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:239 msgid "" "If you are in charge of sending calls for status reports and you are indeed " "using a cron job, please run it on freefall and sign it with your name so " @@ -702,7 +702,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:240 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:242 msgid "" "It may also be worth making a call for reports on the forums as link:https://" "forums.freebsd.org/threads/call-for-freebsd-2014q4-october-december-status-" @@ -710,13 +710,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:241 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:243 #, no-wrap msgid "Building the report" msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:245 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:247 msgid "" "Submitted reports are reviewed and merged in the proper subdirectory of " "[.filename]#doc/website/content/en/status/# as they come in. While the " @@ -725,7 +725,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:248 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:250 msgid "" "Usually the last step in the content review process is writing the " "introduction in a file named [.filename]#intro.adoc#: a good introduction " @@ -736,7 +736,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:250 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:252 msgid "" "Once all the reports and the introduction are ready, the " "[.filename]#_index.adoc# file needs to be created: this is the file in which " @@ -744,19 +744,19 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:251 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:253 #, no-wrap msgid "Publishing the report" msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:254 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:256 msgid "" "When all the files of the status report are ready, it is time to publish it." msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:257 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:259 msgid "" "First [.filename]#doc/website/content/en/status/_index.adoc# is edited: the " "next due date is updated and a link to the new report is added. The change " @@ -765,19 +765,19 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:259 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:261 msgid "" "Then the news entry for the main website page is added to [.filename]#doc/" "website/data/en/news/news.toml#." msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:261 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:263 msgid "Here is a sample for the news entry:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:266 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:268 #, no-wrap msgid "" "[[news]]\n" @@ -787,20 +787,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:269 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:271 msgid "" "Once the HTML version of the report has been built and is online, man:w3m[1] " "is used to dump the website as plain-text, e.g:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:271 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:273 #, no-wrap msgid "% w3m -cols 80 -dump https://www.FreeBSD.org/status/report-2021-01-2021-03/ > /tmp/report-2021-01-2021-03.txt\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:274 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:276 msgid "" "man:w3m[1] has full proper unicode support. `-dump` simply outputs text " "rendering of the HTML code that can then have a few elements snipped, while " @@ -808,35 +808,35 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:276 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:278 msgid "" "A link to the rendered report is added between the introduction and the " "first entry." msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:278 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:280 msgid "" "The report is finally ready to be sent, toggling disposition (the report " "should be inlined), and ensuring it is encoded as UTF-8." msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:280 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:282 msgid "" "Two emails are sent, both with subject in the format `FreeBSD Status Report " "- <First/Second/Third/Fourth> Quarter <year>`:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:282 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:284 msgid "" "one to link:https://lists.freebsd.org/subscription/freebsd-announce[freebsd-" "announce@FreeBSD.org];" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:286 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:288 msgid "" "This one must be approved, so if you are in charge of sending this email, " "ensure that someone does it (mail " @@ -844,7 +844,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:288 +#: documentation/content/en/articles/freebsd-status-report-process/_index.adoc:290 msgid "" "one to link:https://lists.freebsd.org/subscription/freebsd-hackers[freebsd-" "hackers@FreeBSD.org], which also has link:https://lists.freebsd.org/" diff --git a/documentation/content/en/articles/license-guide/_index.po b/documentation/content/en/articles/license-guide/_index.po index 97b7f501f1..c7dc8447e2 100644 --- a/documentation/content/en/articles/license-guide/_index.po +++ b/documentation/content/en/articles/license-guide/_index.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2024-09-14 15:00-0300\n" +"POT-Creation-Date: 2025-05-01 19:56-0300\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" @@ -60,7 +60,7 @@ msgstr "" #: documentation/content/en/articles/license-guide/_index.adoc:158 #, no-wrap msgid "" -"/*-\n" +"/*\n" " * Copyright (c) [year] [your name]\n" " *\n" " * SPDX-License-Identifier: BSD-2-Clause\n" @@ -268,12 +268,12 @@ msgid "" "Historically, the phrase 'All Rights Reserved.' was included in all " "copyright notices. All the BSD releases had it, to comply with the https://" "en.wikipedia.org/wiki/Buenos_Aires_Convention[Buenos Aires Convention of " -"1910] in the Americas. With the ratification of the https://en.wikipedia." -"org/wiki/Berne_Convention[Berne Convention] in 2000 by Nicaragua, the Buenos " -"Aires Convention -- and the phrase -- became obsolete. As such, the FreeBSD " -"project recommends that new code omit the phrase and encourages existing " -"copyright holders to remove it. In 2018, the project updated its templates " -"to remove it." +"1910] in the Americas. With the ratification of the https://" +"en.wikipedia.org/wiki/Berne_Convention[Berne Convention] in 2000 by " +"Nicaragua, the Buenos Aires Convention -- and the phrase -- became " +"obsolete. As such, the FreeBSD project recommends that new code omit the " +"phrase and encourages existing copyright holders to remove it. In 2018, the " +"project updated its templates to remove it." msgstr "" #. type: Plain text @@ -313,7 +313,7 @@ msgstr "" #: documentation/content/en/articles/license-guide/_index.adoc:168 #, no-wrap msgid "" -"/*-\n" +"/*\n" " * Copyright (c) [year] [your name]\n" " *\n" " * SPDX-License-Identifier: BSD-3-Clause\n" @@ -329,7 +329,7 @@ msgstr "" #: documentation/content/en/articles/license-guide/_index.adoc:178 #, no-wrap msgid "" -"/*-\n" +"/*\n" " * Copyright (c) [year] [copyright holder]\n" " *\n" " * SPDX-License-Identifier: ISC\n" @@ -345,7 +345,7 @@ msgstr "" #: documentation/content/en/articles/license-guide/_index.adoc:188 #, no-wrap msgid "" -"/*-\n" +"/*\n" " * Copyright (c) [year] [copyright holders]\n" " *\n" " * SPDX-License-Identifier: MIT\n" @@ -361,11 +361,11 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/license-guide/_index.adoc:194 msgid "" -"The FreeBSD Project licenses its compilation of software as described in [." -"filename]#COPYRIGHT# under the BSD-2-Clause license. This license does not " -"supersede the license of individual files, which is described below. Files " -"that do not have an explicit license are licensed under the BSD-2-Clause " -"license." +"The FreeBSD Project licenses its compilation of software as described in " +"[.filename]#COPYRIGHT# under the BSD-2-Clause license. This license does " +"not supersede the license of individual files, which is described below. " +"Files that do not have an explicit license are licensed under the BSD-2-" +"Clause license." msgstr "" #. type: Title == @@ -391,10 +391,10 @@ msgid "" "Identifier expressions, but aren't otherwise allowed as detached licenses. " "All such files must appear at least once in the FreeBSD software collection, " "and should be removed when the last file that references them is removed. " -"Licenses that have no adequate SPDX matching license must be in [." -"filename]#LICENSES/other/# and have a filename that starts with LicenseRef- " -"followed by a unique idstring. No such files have currently been " -"identified, but if they are, a full list will appear here." +"Licenses that have no adequate SPDX matching license must be in " +"[.filename]#LICENSES/other/# and have a filename that starts with " +"LicenseRef- followed by a unique idstring. No such files have currently " +"been identified, but if they are, a full list will appear here." msgstr "" #. type: Plain text @@ -515,9 +515,9 @@ msgid "" "an SPDX-License-Identifier tag and an explicit license. The explicit " "license takes precedence over the SPDX-License-Identifier tag. The SPDX-" "License-Identifier tag is the project's best effort attempt to characterize " -"the license, but is only informative for automated tools. See crossref:" -"license-guide[expressions,SPDX-License-Identifier Expressions] for how to " -"interpret the expression." +"the license, but is only informative for automated tools. See " +"crossref:license-guide[expressions,SPDX-License-Identifier Expressions] for " +"how to interpret the expression." msgstr "" #. type: Title === @@ -565,9 +565,9 @@ msgstr "" msgid "" "Where `id` is the SPDX short license identifier from the `Identifier` column " "of https://spdx.org/licenses/[SPDX Identifiers] or https://spdx.org/licenses/" -"exceptions-index.html[license exception]. If there is no file in [." -"filename]#LICENSE/#, then that license or exception cannot be specified as a " -"detached license under this section." +"exceptions-index.html[license exception]. If there is no file in " +"[.filename]#LICENSE/#, then that license or exception cannot be specified as " +"a detached license under this section." msgstr "" #. type: Plain text @@ -612,8 +612,8 @@ msgstr "" msgid "" "For licenses that have slight variations in text, the SPDX has guidelines to " "match them. These guidelines are not relevant here. Contributors wishing " -"to license under a variant of a SPDX license not contained verbatim in [." -"filename]#LICENSE/# cannot use the detached option and must specify the " +"to license under a variant of a SPDX license not contained verbatim in " +"[.filename]#LICENSE/# cannot use the detached option and must specify the " "license explicitly." msgstr "" @@ -628,8 +628,8 @@ msgstr "" msgid "" "Some files cannot have suitable comments added to them. In such cases, a " "license may be found in [.filename]#file.ext.license#. For example, a file " -"named [.filename]#foo.jpg# may have a license in [.filename]#foo.jpg." -"license#, following the REUSE Software conventions." +"named [.filename]#foo.jpg# may have a license in " +"[.filename]#foo.jpg.license#, following the REUSE Software conventions." msgstr "" #. type: Plain text diff --git a/documentation/content/en/articles/mailing-list-faq/_index.po b/documentation/content/en/articles/mailing-list-faq/_index.po index 1b8f61e601..1970b15513 100644 --- a/documentation/content/en/articles/mailing-list-faq/_index.po +++ b/documentation/content/en/articles/mailing-list-faq/_index.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2025-03-20 10:41+0900\n" +"POT-Creation-Date: 2025-05-01 19:57-0300\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" @@ -16,26 +16,26 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -#. type: Yaml Front Matter Hash Value: description -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:1 +#. type: YAML Front Matter: description +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:1 #, no-wrap msgid "How to best use the mailing lists, such as how to help avoid frequently-repeated discussions" msgstr "" #. type: Title = -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:1 -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:10 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:1 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:10 #, no-wrap msgid "Frequently Asked Questions About The FreeBSD Mailing Lists" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:43 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:43 msgid "Abstract" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:49 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:49 msgid "" "This is the FAQ for the FreeBSD mailing lists. If you are interested in " "helping with this project, send email to the {freebsd-doc}. The latest " @@ -47,18 +47,18 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:51 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:51 msgid "'''" msgstr "" #. type: Title == -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:55 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:55 #, no-wrap msgid "Introduction" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:59 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:59 msgid "" "As is usual with FAQs, this document aims to cover the most frequently asked " "questions concerning the FreeBSD mailing lists (and of course answer " @@ -68,7 +68,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:63 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:63 msgid "" "This document attempts to represent a community consensus, and as such it " "can never really be __authoritative__. However, if you find technical " @@ -77,13 +77,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:64 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:64 #, no-wrap msgid "What is the purpose of the FreeBSD mailing lists?" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:67 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:67 msgid "" "The FreeBSD mailing lists serve as the primary communication channels for " "the FreeBSD community, covering many different topic areas and communities " @@ -91,13 +91,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:68 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:68 #, no-wrap msgid "Who is the audience for the FreeBSD mailing lists?" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:73 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:73 msgid "" "This depends on charter of each individual list. Some lists are more " "oriented to developers; some are more oriented towards the FreeBSD community " @@ -106,18 +106,18 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:75 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:75 msgid "Lists are English language, unless stated otherwise." msgstr "" #. type: Title === -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:76 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:76 #, no-wrap msgid "Are the FreeBSD mailing lists open for anyone to participate?" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:81 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:81 msgid "" "Again, this depends on charter of each individual list. Please read the " "charter of a mailing list before you post to it, and respect it when you " @@ -125,7 +125,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:83 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:83 msgid "" "If after reading the above lists, you still do not know which mailing list " "to post a question to, you will probably want to post to freebsd-questions " @@ -133,40 +133,40 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:86 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:86 msgid "" "Note that you must subscribe to a mailing list before you can post. You can " "elect to subscribe without receiving messages posted to the mailing list." msgstr "" #. type: Title === -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:87 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:87 #, no-wrap msgid "How can I subscribe?" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:90 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:90 msgid "" "You can use link:https://lists.FreeBSD.org/[the Mlmmj web interface] to " "subscribe to any of the public lists." msgstr "" #. type: Title === -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:91 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:91 #, no-wrap msgid "How can I unsubscribe?" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:94 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:94 msgid "" "You can use the same interface as above; or, you can follow the instructions " "that are at the bottom of every mailing list message that is sent." msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:98 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:98 msgid "" "Please do not send unsubscribe messages directly to the public lists " "themselves. First, this will not accomplish your goal, and second, it will " @@ -175,13 +175,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:99 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:99 #, no-wrap msgid "Are archives available?" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:103 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:103 msgid "" "Yes. Threaded archives with all e-mails since 1994 are available " "link:https://mail-archive.freebsd.org/mail/[here]. You can also access " @@ -190,24 +190,24 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:104 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:104 #, no-wrap msgid "Are mailing lists available in a digest format?" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:107 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:107 msgid "Yes. See link:https://lists.FreeBSD.org/[the Mlmmj web interface]." msgstr "" #. type: Title == -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:109 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:109 #, no-wrap msgid "Mailing List Etiquette" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:113 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:113 msgid "" "Participation in the mailing lists, like participation in any community, " "requires a common basis for communication. Please make only appropriate " @@ -215,13 +215,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:114 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:114 #, no-wrap msgid "What should I do before I post?" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:119 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:119 msgid "" "You have already taken the most important step by reading this document. " "However, if you are new to FreeBSD, you may first need to familiarize " @@ -236,7 +236,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:124 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:124 msgid "" "It is always considered bad form to ask a question that is already answered " "in the above documents. This is not because the volunteers who work on this " @@ -248,45 +248,45 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:125 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:125 #, no-wrap msgid "What constitutes an inappropriate posting?" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:128 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:128 msgid "Postings must be in accordance with the charter of the mailing list." msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:129 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:129 msgid "" "Personal attacks are discouraged. As good net-citizens, we should try to " "hold ourselves to high standards of behavior." msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:130 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:130 msgid "" "Spam is not allowed, ever. The mailing lists are actively processed to ban " "offenders to this rule." msgstr "" #. type: Title === -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:131 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:131 #, no-wrap msgid "What is considered proper etiquette when posting to the mailing lists?" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:134 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:134 msgid "" "Please wrap lines at 75 characters, since not everyone uses fancy GUI mail " "reading programs." msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:135 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:135 msgid "" "Please respect the fact that bandwidth is not infinite. Not everyone reads " "email through high-speed connections, so if your posting involves something " @@ -298,7 +298,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:136 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:136 msgid "" "Format your message so that it is legible, and PLEASE DO NOT SHOUT!!!!!. Do " "not underestimate the effect that a poorly formatted mail message has, and " @@ -309,7 +309,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:137 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:137 msgid "" "Please use an appropriate human language for a particular mailing list. Many " "non-English mailing lists are link:https://www.FreeBSD.org/community/" @@ -317,7 +317,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:141 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:141 msgid "" "For the ones that are not, we do appreciate that many people do not speak " "English as their first language, and we try to make allowances for that. It " @@ -327,7 +327,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:142 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:142 msgid "" "Please use a standards-compliant Mail User Agent (MUA). A lot of badly " "formatted messages come from http://www.lemis.com/grog/email/email.php[bad " @@ -336,29 +336,29 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:144 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:144 msgid "exmh" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:145 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:145 msgid "Microsoft(R) Exchange" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:146 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:146 msgid "Microsoft(R) Outlook(R)" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:148 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:148 msgid "" "Try not to use MIME: a lot of people use mailers which do not get on very " "well with MIME." msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:149 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:149 msgid "" "Make sure your time and time zone are set correctly. This may seem a little " "silly, since your message still gets there, but many of the people on these " @@ -369,7 +369,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:150 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:150 msgid "" "A lot of the information you need to supply is the output of programs, such " "as man:dmesg[8], or console messages, which usually appear in [.filename]#/" @@ -382,18 +382,18 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:154 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:154 #, no-wrap msgid "% dmesg > /tmp/dmesg.out\n" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:157 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:157 msgid "This redirects the information to the file [.filename]#/tmp/dmesg.out#." msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:158 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:158 msgid "" "When using cut-and-paste, please be aware that some such operations badly " "mangle their messages. This is of particular concern when posting contents " @@ -405,13 +405,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:159 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:159 #, no-wrap msgid "What are the special etiquette consideration when replying to an existing posting on the mailing lists?" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:162 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:162 msgid "" "Please include relevant text from the original message. Trim it to the " "minimum, but do not overdo it. It should still be possible for somebody who " @@ -419,14 +419,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:164 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:164 msgid "" "This is especially important for postings of the type \"yes, I see this " "too\", where the initial posting was dozens or hundreds of lines." msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:165 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:165 msgid "" "Use some technique to identify which text came from the original message, " "and which text you add. A common convention is to prepend \"`>`\" to the " @@ -436,7 +436,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:166 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:166 msgid "" "Please ensure that the attributions of the text you are quoting is correct. " "People can become offended if you attribute words to them that they " @@ -444,35 +444,35 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:167 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:167 msgid "" "Please do not `top post`. By this, we mean that if you are replying to a " "message, please put your replies after the text that you copy in your reply." msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:169 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:169 msgid "A: Because it reverses the logical flow of conversation." msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:170 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:170 msgid "Q: Why is top posting frowned upon?" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:172 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:172 msgid "(Thanks to Randy Bush for the joke.)" msgstr "" #. type: Title == -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:174 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:174 #, no-wrap msgid "Recurring Topics On The Mailing Lists" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:181 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:181 msgid "" "Participation in the mailing lists, like participation in any community, " "requires a common basis for communication. Many of the mailing lists " @@ -485,7 +485,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:185 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:185 msgid "" "The best method to avoid this is to familiarize yourself with the http://" "docs.FreeBSD.org/mail/[mailing list archives], to help yourself understand " @@ -496,7 +496,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:188 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:188 msgid "" "By familiarizing yourself with the archives, not only will you learn what " "topics have been discussed before, but also how discussion tends to proceed " @@ -506,7 +506,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:191 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:191 msgid "" "There is no doubt that the archives are quite extensive, and some questions " "recur more often than others, sometimes as followups where the subject line " @@ -515,13 +515,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:193 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:193 #, no-wrap msgid "What Is A \"Bikeshed\"?" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:198 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:198 msgid "" "Literally, a `bikeshed` is a small outdoor shelter into which one may store " "one's two-wheeled form of transportation. However, in FreeBSD parlance, the " @@ -533,33 +533,33 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:200 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:200 msgid "" "More generally, a bikeshed is a topic that will tend to generate immediate " "meta-discussions and flames if you have not read up on their history." msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:203 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:203 msgid "" "Please help us to keep the mailing lists as useful for as many people as " "possible by avoiding bikesheds whenever you can. Thanks." msgstr "" #. type: Title == -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:205 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:205 #, no-wrap msgid "Acknowledgments" msgstr "" #. type: Labeled list -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:207 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:207 #, no-wrap msgid "`{grog}`" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:209 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:209 msgid "" "Original author of most of the material on mailing list etiquette, taken " "from the article on extref:{freebsd-questions-article}[How to get best " @@ -567,12 +567,12 @@ msgid "" msgstr "" #. type: Labeled list -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:210 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:210 #, no-wrap msgid "`{linimon}`" msgstr "" #. type: Plain text -#: documentation/content/en//articles/mailing-list-faq/_index.adoc:211 +#: documentation/content/en/articles/mailing-list-faq/_index.adoc:211 msgid "Creation of the rough draft of this FAQ." msgstr "" diff --git a/documentation/content/en/articles/pgpkeys/_index.po b/documentation/content/en/articles/pgpkeys/_index.po index 6bb12c97c9..f36963ef0d 100644 --- a/documentation/content/en/articles/pgpkeys/_index.po +++ b/documentation/content/en/articles/pgpkeys/_index.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2025-01-24 10:22-0300\n" +"POT-Creation-Date: 2025-05-01 19:57-0300\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" @@ -101,7 +101,7 @@ msgstr "" #. type: Title === #: documentation/content/en/articles/pgpkeys/_index.adoc:84 -#: documentation/content/en/articles/pgpkeys/_index.adoc:1239 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1242 #, no-wrap msgid "`{glebius}`" msgstr "" @@ -2327,623 +2327,635 @@ msgstr "" #. type: Title === #: documentation/content/en/articles/pgpkeys/_index.adoc:1212 #, no-wrap -msgid "`{ashish}`" +msgid "`{ashafer}`" msgstr "" #. type: Title === #: documentation/content/en/articles/pgpkeys/_index.adoc:1215 #, no-wrap -msgid "`{asiciliano}`" +msgid "`{ashish}`" msgstr "" #. type: Title === #: documentation/content/en/articles/pgpkeys/_index.adoc:1218 #, no-wrap -msgid "`{chs}`" +msgid "`{asiciliano}`" msgstr "" #. type: Title === #: documentation/content/en/articles/pgpkeys/_index.adoc:1221 #, no-wrap -msgid "`{bms}`" +msgid "`{chs}`" msgstr "" #. type: Title === #: documentation/content/en/articles/pgpkeys/_index.adoc:1224 #, no-wrap -msgid "`{demon}`" +msgid "`{bms}`" msgstr "" #. type: Title === #: documentation/content/en/articles/pgpkeys/_index.adoc:1227 #, no-wrap -msgid "`{jesper}`" +msgid "`{demon}`" msgstr "" #. type: Title === #: documentation/content/en/articles/pgpkeys/_index.adoc:1230 #, no-wrap -msgid "`{scop}`" +msgid "`{jesper}`" msgstr "" #. type: Title === #: documentation/content/en/articles/pgpkeys/_index.adoc:1233 #, no-wrap -msgid "`{anray}`" +msgid "`{scop}`" msgstr "" #. type: Title === #: documentation/content/en/articles/pgpkeys/_index.adoc:1236 #, no-wrap +msgid "`{anray}`" +msgstr "" + +#. type: Title === +#: documentation/content/en/articles/pgpkeys/_index.adoc:1239 +#, no-wrap msgid "`{flo}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1242 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1245 #, no-wrap msgid "`{kensmith}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1245 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1248 #, no-wrap msgid "`{ben}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1248 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1251 #, no-wrap msgid "`{des}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1251 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1254 #, no-wrap msgid "`{sobomax}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1254 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1257 #, no-wrap msgid "`{asomers}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1257 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1260 #, no-wrap msgid "`{brian}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1260 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1263 #, no-wrap msgid "`{sson}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1263 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1266 #, no-wrap msgid "`{nsouch}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1266 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1269 #, no-wrap msgid "`{ssouhlal}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1269 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1272 #, no-wrap msgid "`{loos}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1272 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1275 #, no-wrap msgid "`{brnrd}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1275 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1278 #, no-wrap msgid "`{rink}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1278 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1281 #, no-wrap msgid "`{vsevolod}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1281 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1284 #, no-wrap msgid "`{pstef}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1284 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1287 #, no-wrap msgid "`{zi}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1287 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1290 #, no-wrap msgid "`{lstewart}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1290 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1293 #, no-wrap msgid "`{murray}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1293 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1296 #, no-wrap msgid "`{vs}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1296 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1299 #, no-wrap msgid "`{xride}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1299 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1302 #, no-wrap msgid "`{marius}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1302 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1305 #, no-wrap msgid "`{cs}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1305 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1308 #, no-wrap msgid "`{clsung}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1308 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1311 #, no-wrap msgid "`{gsutter}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1311 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1314 #, no-wrap msgid "`{metal}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1314 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1317 #, no-wrap msgid "`{ryusuke}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1317 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1320 #, no-wrap msgid "`{nyan}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1320 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1323 #, no-wrap msgid "`{sahil}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1323 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1326 #, no-wrap msgid "`{tota}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1326 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1329 #, no-wrap msgid "`{romain}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1329 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1332 #, no-wrap msgid "`{eduardo}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1332 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1335 #, no-wrap msgid "`{sylvio}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1335 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1338 #, no-wrap msgid "`{itetcu}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1338 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1341 #, no-wrap msgid "`{mi}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1341 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1344 #, no-wrap msgid "`{gordon}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1344 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1347 #, no-wrap msgid "`{lth}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1347 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1350 #, no-wrap msgid "`{fabient}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1350 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1353 #, no-wrap msgid "`{thierry}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1353 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1356 #, no-wrap msgid "`{thompsa}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1356 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1359 #, no-wrap msgid "`{flz}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1359 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1362 #, no-wrap msgid "`{jilles}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1362 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1365 #, no-wrap msgid "`{ganbold}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1365 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1368 #, no-wrap msgid "`{tuexen}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1368 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1371 #, no-wrap msgid "`{gonzo}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1371 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1374 #, no-wrap msgid "`{uzsolt}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1374 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1377 #, no-wrap msgid "`{ume}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1377 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1380 #, no-wrap msgid "`{ups}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1380 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1383 #, no-wrap msgid "`{fsu}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1383 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1386 #, no-wrap msgid "`{mikael}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1386 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1389 #, no-wrap msgid "`{manu}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1389 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1392 #, no-wrap msgid "`{ram}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1392 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1395 #, no-wrap msgid "`{bryanv}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1395 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1398 #, no-wrap msgid "`{nectar}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1398 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1401 #, no-wrap msgid "`{avilla}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1401 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1404 #, no-wrap msgid "`{nivit}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1404 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1407 #, no-wrap msgid "`{ivoras}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1407 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1410 #, no-wrap msgid "`{stefan}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1410 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1413 #, no-wrap msgid "`{kaiw}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1413 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1416 #, no-wrap msgid "`{adamw}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1416 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1419 #, no-wrap msgid "`{naddy}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1419 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1422 #, no-wrap msgid "`{peter}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1422 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1425 #, no-wrap msgid "`{nwhitehorn}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1425 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1428 #, no-wrap msgid "`{miwi}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1428 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1431 #, no-wrap msgid "`{nate}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1431 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1434 #, no-wrap msgid "`{twinterg}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1434 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1437 #, no-wrap msgid "`{def}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1437 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1440 #, no-wrap msgid "`{wollman}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1440 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1443 #, no-wrap msgid "`{joerg}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1443 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1446 #, no-wrap msgid "`{ygy}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1446 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1449 #, no-wrap msgid "`{emax}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1449 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1452 #, no-wrap msgid "`{oshogbo}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1452 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1455 #, no-wrap msgid "`{riggs}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1455 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1458 #, no-wrap msgid "`{egypcio}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1458 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1461 #, no-wrap msgid "`{bz}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1461 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1464 #, no-wrap msgid "`{dsl}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1464 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1467 #, no-wrap msgid "`{zeising}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1467 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1470 #, no-wrap msgid "`{phantom}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1470 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1473 #, no-wrap msgid "`{tz}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1473 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1476 #, no-wrap msgid "`{rigoletto}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1476 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1479 #, no-wrap msgid "`{kaktus}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1479 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1482 #, no-wrap msgid "`{samm}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1482 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1485 #, no-wrap msgid "`{arrowd}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1485 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1488 #, no-wrap msgid "`{ronald}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1488 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1491 #, no-wrap msgid "`{meta}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1491 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1494 #, no-wrap msgid "`{rnagy}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1494 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1497 #, no-wrap msgid "`{vvd}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1497 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1500 #, no-wrap msgid "`{gbe}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1500 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1503 #, no-wrap msgid "`{bnovkov}`" msgstr "" +#. type: Title === +#: documentation/content/en/articles/pgpkeys/_index.adoc:1506 +#, no-wrap +msgid "`{ivy}`" +msgstr "" + #. type: Title == -#: documentation/content/en/articles/pgpkeys/_index.adoc:1504 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1510 #, no-wrap msgid "Other Cluster Account Holders" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1506 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1512 #, no-wrap msgid "`{bk}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1509 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1515 #, no-wrap msgid "`{deb}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1512 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1518 #, no-wrap msgid "`{debdrup}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1515 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1521 #, no-wrap msgid "`{dutchdaemon}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1518 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1524 #, no-wrap msgid "`{keymaster}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1521 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1527 #, no-wrap msgid "`{mwlucas}`" msgstr "" #. type: Title === -#: documentation/content/en/articles/pgpkeys/_index.adoc:1524 +#: documentation/content/en/articles/pgpkeys/_index.adoc:1530 #, no-wrap msgid "`{dhw}`" msgstr "" |