git: 62d80a7755 - main - doc: Update source files (en .po), for translations
"Danilo G. Baio" <[email protected]>
| Newsgroups | gmane.os.freebsd.devel.cvs.doc |
|---|---|
| Message-ID | <[email protected]> |
The branch main has been updated by dbaio: URL: https://cgit.FreeBSD.org/doc/commit/?id=62d80a7755f68e823f09e8e2c2684203f1fd3e00 commit 62d80a7755f68e823f09e8e2c2684203f1fd3e00 Author: Danilo G. Baio <[email protected]> AuthorDate: 2023-01-21 23:34:54 +0000 Commit: Danilo G. Baio <[email protected]> CommitDate: 2023-01-21 23:34:54 +0000 doc: Update source files (en .po), for translations --- .../content/en/articles/committers-guide/_index.po | 1220 +-- .../content/en/articles/nanobsd/_index.po | 100 +- .../content/en/articles/pgpkeys/_index.po | 886 +- documentation/content/en/books/dev-model/_index.po | 20 +- .../en/books/developers-handbook/tools/_index.po | 16 +- .../en/books/developers-handbook/x86/_index.po | 12 +- documentation/content/en/books/faq/_index.po | 2218 ++-- .../en/books/fdp-primer/doc-build/_index.po | 6 +- .../en/books/fdp-primer/editor-config/_index.po | 213 +- .../content/en/books/fdp-primer/overview/_index.po | 69 +- .../en/books/fdp-primer/structure/_index.po | 121 +- .../en/books/fdp-primer/trademarks/_index.po | 80 +- .../en/books/fdp-primer/writing-style/_index.po | 287 +- .../books/handbook/advanced-networking/_index.po | 22 +- .../content/en/books/handbook/audit/_index.po | 4 +- .../content/en/books/handbook/basics/_index.po | 1750 ++- .../en/books/handbook/bibliography/_index.po | 541 +- .../content/en/books/handbook/boot/_index.po | 4 +- .../content/en/books/handbook/bsdinstall/_index.po | 2987 +++--- .../content/en/books/handbook/config/_index.po | 10 +- .../en/books/handbook/cutting-edge/_index.po | 329 +- .../content/en/books/handbook/desktop/_index.po | 4 +- .../content/en/books/handbook/disks/_index.po | 16 +- .../content/en/books/handbook/dtrace/_index.po | 4 +- .../en/books/handbook/filesystems/_index.po | 4 +- .../content/en/books/handbook/firewalls/_index.po | 42 +- .../content/en/books/handbook/geom/_index.po | 4 +- .../content/en/books/handbook/introduction.po | 25 +- .../en/books/handbook/introduction/_index.po | 465 +- .../content/en/books/handbook/jails/_index.po | 4 +- .../en/books/handbook/kernelconfig/_index.po | 29 +- .../content/en/books/handbook/l10n/_index.po | 9 +- .../content/en/books/handbook/linuxemu/_index.po | 10 +- .../content/en/books/handbook/mac/_index.po | 4 +- .../content/en/books/handbook/mail/_index.po | 6 +- .../content/en/books/handbook/mirrors/_index.po | 7 +- .../content/en/books/handbook/multimedia/_index.po | 6 +- .../en/books/handbook/network-servers/_index.po | 31 +- documentation/content/en/books/handbook/parti.po | 7 +- .../content/en/books/handbook/pgpkeys/_index.po | 12 +- .../content/en/books/handbook/ports/_index.po | 1608 +-- .../en/books/handbook/ppp-and-slip/_index.po | 10 +- .../content/en/books/handbook/preface/_index.po | 368 +- .../content/en/books/handbook/printing/_index.po | 4 +- .../content/en/books/handbook/security/_index.po | 1136 +- .../en/books/handbook/serialcomms/_index.po | 18 +- .../en/books/handbook/usb-device-mode/_index.po | 4 +- .../en/books/handbook/virtualization/_index.po | 12 +- .../content/en/books/handbook/wine/_index.po | 31 +- .../content/en/books/handbook/x11/_index.po | 1145 +- .../content/en/books/handbook/zfs/_index.po | 51 +- .../en/books/porters-handbook/makefiles/_index.po | 1047 +- .../en/books/porters-handbook/pkg-files/_index.po | 196 +- .../books/porters-handbook/porting-dads/_index.po | 13 +- .../en/books/porters-handbook/special/_index.po | 89 +- .../en/books/porters-handbook/uses/_index.po | 2175 ++-- .../en/books/porters-handbook/versions/_index.po | 10660 ++++++++++--------- 57 files changed, 14637 insertions(+), 15514 deletions(-) diff --git a/documentation/content/en/articles/committers-guide/_index.po b/documentation/content/en/articles/committers-guide/_index.po index 9938c1f80a..cd4083faf1 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: 2022-10-16 17:07-0300\n" +"POT-Creation-Date: 2023-01-21 20:00-0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <[email protected]>\n" @@ -48,7 +48,7 @@ msgid "" "Almost all FreeBSD developers have commit rights to one or more " "repositories. However, a few developers do not, and some of the information " "here applies to them as well. (For instance, some people only have rights " -"to work with the Problem Report database). Please see <<non-committers>> " +"to work with the Problem Report database.) Please see <<non-committers>> " "for more information." msgstr "" @@ -127,7 +127,7 @@ msgstr "" #. type: Table #: documentation/content/en/articles/committers-guide/_index.adoc:82 #, no-wrap -msgid "`ssh://[email protected]/src.git` (see also <<git-getting-started-base-layout>>)." +msgid "`ssh://[email protected]/src.git`" msgstr "" #. type: Table @@ -139,7 +139,7 @@ msgstr "" #. type: Table #: documentation/content/en/articles/committers-guide/_index.adoc:85 #, no-wrap -msgid "`ssh://[email protected]/doc.git` (see also <<git-getting-started-doc-layout>>)." +msgid "`ssh://[email protected]/doc.git`" msgstr "" #. type: Table @@ -151,7 +151,7 @@ msgstr "" #. type: Table #: documentation/content/en/articles/committers-guide/_index.adoc:88 #, no-wrap -msgid "`ssh://[email protected]/ports.git` (see also <<git-getting-started-ports-layout>>)." +msgid "`ssh://[email protected]/ports.git`" msgstr "" #. type: Table @@ -163,7 +163,7 @@ msgstr "" #. type: Table #: documentation/content/en/articles/committers-guide/_index.adoc:91 #, no-wrap -msgid "developers (technically called all-developers), doc-developers, doc-committers, ports-developers, ports-committers, src-developers, src-committers. (Each project repository has its own -developers and -committers mailing lists. Archives for these lists can be found in the files [.filename]#/local/mail/repository-name-developers-archive# and [.filename]#/local/mail/repository-name-committers-archive# on the `FreeBSD.org` cluster.)" +msgid "developers (technically called all-developers), doc-developers, doc-committers, ports-developers, ports-committers, src-developers, src-committers. (Each project repository has its own -developers and -committers mailing lists. Archives for these lists can be found in the files [.filename]#/local/mail/repository-name-developers-archive# and [.filename]#/local/mail/repository-name-committers-archive# on `freefall.FreeBSD.org`.)" msgstr "" #. type: Table @@ -175,7 +175,7 @@ msgstr "" #. type: Table #: documentation/content/en/articles/committers-guide/_index.adoc:94 #, no-wrap -msgid "[.filename]#/home/core/public/monthly-reports# on the `FreeBSD.org` cluster." +msgid "[.filename]#/home/core/public/reports# on the `FreeBSD.org` cluster." msgstr "" #. type: Table @@ -355,8 +355,7 @@ msgstr "" #: documentation/content/en/articles/committers-guide/_index.adoc:181 msgid "" "2048-bit keys with a three-year expiration provide adequate protection at " -"present (2013-12). http://danielpocock.com/rsa-key-sizes-2048-or-4096-bits[] " -"describes the situation in more detail." +"present (2022-10)." msgstr "" #. type: Plain text @@ -379,9 +378,9 @@ msgstr "" msgid "" "After the email address is entered, a passphrase is requested. Methods of " "creating a secure passphrase are contentious. Rather than suggest a single " -"way, here are some links to sites that describe various methods: http://" -"world.std.com/~reinhold/diceware.html[], http://www.iusmentis.com/security/" -"passphrasefaq/[], http://xkcd.com/936/[], http://en.wikipedia.org/wiki/" +"way, here are some links to sites that describe various methods: https://" +"world.std.com/~reinhold/diceware.html[], https://www.iusmentis.com/security/" +"passphrasefaq/[], https://xkcd.com/936/[], https://en.wikipedia.org/wiki/" "Passphrase[]." msgstr "" @@ -597,9 +596,9 @@ msgstr "" #: documentation/content/en/articles/committers-guide/_index.adoc:270 msgid "" "doc committers may commit documentation changes to [.filename]#src# files, " -"such as man pages, READMEs, fortune databases, calendar files, and comment " -"fixes without approval from a src committer, subject to the normal care and " -"tending of commits." +"such as manual pages, READMEs, fortune databases, calendar files, and " +"comment fixes without approval from a src committer, subject to the normal " +"care and tending of commits." msgstr "" #. type: Plain text @@ -895,8 +894,8 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:389 msgid "" -"Again, note that `gitrepo.freebsd.org` will be canonicalized to `repo." -"freebsd.org` in the future." +"Again, note that `gitrepo.freebsd.org` has been canonicalized to `repo." +"freebsd.org`." msgstr "" #. type: Plain text @@ -955,8 +954,8 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:420 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 @@ -2030,8 +2029,8 @@ msgstr "" #: documentation/content/en/articles/committers-guide/_index.adoc:935 msgid "" "For MFC commits, for example a vendor import, you would need to specify one " -"parent for cherry-pick purposes. Normally, that would be the \"first parent" -"\" of the branch you are cherry-picking from, so:" +"parent for cherry-pick purposes. Normally, that would be the \"first " +"parent\" of the branch you are cherry-picking from, so:" msgstr "" #. type: delimited block . 4 @@ -3926,8 +3925,8 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:1867 msgid "" -"(note that gitrepo.freebsd.org will be change to repo.freebsd.org in the " -"future.)" +"(Note that gitrepo.freebsd.org now points to the same addresses as repo." +"freebsd.org.)" msgstr "" #. type: Plain text @@ -4809,8 +4808,8 @@ msgid "" "Make whatever modifications you wish in your branch. Build, test, and once " "you're ready to collaborate with others it's time to push your changes into " "your hosted branch. Before you can push you'll have to set the appropriate " -"upstream, as Git will tell you the first time you try to push to your +github" -"+ remote:" +"upstream, as Git will tell you the first time you try to push to your " +"+github+ remote:" msgstr "" #. type: delimited block . 4 @@ -5243,8 +5242,9 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/committers-guide/_index.adoc:2512 msgid "" -"See <<kerberos-ldap>> to generate or set a Kerberos for use with other " -"FreeBSD services like the bug tracking database." +"See <<kerberos-ldap>> to generate or set a Kerberos account for use with " +"other FreeBSD services like the link:https://bugs.freebsd.org/bugzilla/[bug-" +"tracking database] (you get a bug-tracking account as part of that step)." msgstr "" #. type: Plain text @@ -5253,36 +5253,37 @@ msgid "Optional: Enable Wiki Account" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2515 +#: documentation/content/en/articles/committers-guide/_index.adoc:2517 msgid "" -"https://wiki.freebsd.org[FreeBSD Wiki] Account - A wiki account allows " -"sharing projects and ideas. Those who do not yet have an account can follow " -"instructions on the https://wiki.freebsd.org/AboutWiki[AboutWiki Page] to " -"obtain one. Contact mailto:[email protected][[email protected]] if " -"you need help with your Wiki account." +"link:https://wiki.freebsd.org[FreeBSD Wiki] Account - A wiki account allows " +"sharing projects and ideas. Those who do not yet have an account can follow " +"instructions on the link:https://wiki.freebsd.org/Wiki/About[Wiki/About " +"page] to obtain one. Contact mailto:[email protected][wiki-" +"[email protected]] if you need help with your Wiki account." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2516 +#: documentation/content/en/articles/committers-guide/_index.adoc:2518 msgid "Optional: Update Wiki Information" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2518 +#: documentation/content/en/articles/committers-guide/_index.adoc:2520 msgid "" "Wiki Information - After gaining access to the wiki, some people add entries " "to the https://wiki.freebsd.org/HowWeGotHere[How We Got Here], https://wiki." -"freebsd.org/IRC/Nicknames[IRC Nicks], and https://wiki.freebsd.org/Community/" -"Dogs[Dogs of FreeBSD] pages." +"freebsd.org/IRC/Nicknames[IRC Nicks], https://wiki.freebsd.org/Community/" +"Dogs[Dogs of FreeBSD], and or https://wiki.freebsd.org/Community/Cats[Cats " +"of FreeBSD] pages." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2519 +#: documentation/content/en/articles/committers-guide/_index.adoc:2521 msgid "Optional: Update Ports with Personal Information" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2521 +#: documentation/content/en/articles/committers-guide/_index.adoc:2523 msgid "" "[.filename]#ports/astro/xearth/files/freebsd.committers.markers# and [." "filename]#src/usr.bin/calendar/calendars/calendar.freebsd# - Some people add " @@ -5291,12 +5292,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2522 +#: documentation/content/en/articles/committers-guide/_index.adoc:2524 msgid "Optional: Prevent Duplicate Mailings" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2524 +#: documentation/content/en/articles/committers-guide/_index.adoc:2526 msgid "" "Subscribers to {dev-commits-doc-all}, {dev-commits-ports-all} or {dev-" "commits-src-all} might wish to unsubscribe to avoid receiving duplicate " @@ -5304,13 +5305,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:2527 +#: documentation/content/en/articles/committers-guide/_index.adoc:2529 #, no-wrap msgid "For Everyone" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2533 +#: documentation/content/en/articles/committers-guide/_index.adoc:2535 msgid "" "Introduce yourself to the other developers, otherwise no one will have any " "idea who you are or what you are working on. The introduction need not be a " @@ -5320,7 +5321,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2534 +#: documentation/content/en/articles/committers-guide/_index.adoc:2536 msgid "" "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 " @@ -5333,14 +5334,14 @@ msgid "" msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:2538 +#: documentation/content/en/articles/committers-guide/_index.adoc:2540 msgid "" "If your e-mail system uses SPF with strict rules, you should exclude `mx2." "FreeBSD.org` from SPF checks." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2541 +#: documentation/content/en/articles/committers-guide/_index.adoc:2543 msgid "" "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 " @@ -5352,7 +5353,7 @@ msgid "" msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:2545 +#: documentation/content/en/articles/committers-guide/_index.adoc:2547 msgid "" "Those who are developers but not committers will not be subscribed to the " "committers or developers mailing lists. The subscriptions are derived from " @@ -5360,35 +5361,35 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/articles/committers-guide/_index.adoc:2549 +#: documentation/content/en/articles/committers-guide/_index.adoc:2551 #, no-wrap msgid "SMTP Access Setup" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2552 +#: documentation/content/en/articles/committers-guide/_index.adoc:2554 msgid "" "For those willing to send e-mail messages through the FreeBSD.org " "infrastructure, follow the instructions below:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2556 +#: documentation/content/en/articles/committers-guide/_index.adoc:2558 msgid "Point your mail client at `smtp.FreeBSD.org:587`." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2557 +#: documentation/content/en/articles/committers-guide/_index.adoc:2559 msgid "Enable STARTTLS." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2558 +#: documentation/content/en/articles/committers-guide/_index.adoc:2560 msgid "Ensure your `From:` address is set to `[email protected]`." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2559 +#: documentation/content/en/articles/committers-guide/_index.adoc:2561 msgid "" "For authentication, you can use your FreeBSD Kerberos username and password " "(see <<kerberos-ldap>>). The `_yourusername_/mail` principal is preferred, " @@ -5396,57 +5397,57 @@ msgid "" msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:2563 +#: documentation/content/en/articles/committers-guide/_index.adoc:2565 msgid "Do not include `@FreeBSD.org` when entering in your username." msgstr "" #. type: Block title -#: documentation/content/en/articles/committers-guide/_index.adoc:2565 +#: documentation/content/en/articles/committers-guide/_index.adoc:2567 #, no-wrap msgid "Additional Notes" msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:2569 +#: documentation/content/en/articles/committers-guide/_index.adoc:2571 msgid "" "Will only accept mail from `[email protected]`. If you are " "authenticated as one user, you are not permitted to send mail from another." msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:2570 +#: documentation/content/en/articles/committers-guide/_index.adoc:2572 msgid "" "A header will be appended with the SASL username: (`Authenticated sender: " "_username_`)." msgstr "" #. type: delimited block = 6 -#: documentation/content/en/articles/committers-guide/_index.adoc:2571 +#: documentation/content/en/articles/committers-guide/_index.adoc:2573 msgid "" "Host has various rate limits in place to cut down on brute force attempts." msgstr "" #. type: Title ===== -#: documentation/content/en/articles/committers-guide/_index.adoc:2575 +#: documentation/content/en/articles/committers-guide/_index.adoc:2577 #, no-wrap msgid "Using a Local MTA to Forward Emails to the FreeBSD.org SMTP Service" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2578 +#: documentation/content/en/articles/committers-guide/_index.adoc:2580 msgid "" "It is also possible to use a local MTA to forward locally sent emails to the " "FreeBSD.org SMTP servers." msgstr "" #. type: Block title -#: documentation/content/en/articles/committers-guide/_index.adoc:2580 +#: documentation/content/en/articles/committers-guide/_index.adoc:2582 #, no-wrap msgid "Using Postfix" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2585 +#: documentation/content/en/articles/committers-guide/_index.adoc:2587 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 [." @@ -5454,7 +5455,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2593 +#: documentation/content/en/articles/committers-guide/_index.adoc:2595 #, no-wrap msgid "" "sender_dependent_relayhost_maps = hash:/usr/local/etc/postfix/relayhost_maps\n" @@ -5465,33 +5466,33 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2596 +#: documentation/content/en/articles/committers-guide/_index.adoc:2598 msgid "" "Create [.filename]#/usr/local/etc/postfix/relayhost_maps# with the following " "content:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2600 +#: documentation/content/en/articles/committers-guide/_index.adoc:2602 #, no-wrap msgid "[email protected] [smtp.freebsd.org]:587\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2603 +#: documentation/content/en/articles/committers-guide/_index.adoc:2605 msgid "" "Create [.filename]#/usr/local/etc/postfix/sasl_passwd# with the following " "content:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2607 +#: documentation/content/en/articles/committers-guide/_index.adoc:2609 #, no-wrap msgid "[smtp.freebsd.org]:587 yourusername:yourpassword\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2610 +#: documentation/content/en/articles/committers-guide/_index.adoc:2612 msgid "" "If the email server is used by other people, you may want to prevent them " "from sending e-mails from your address. To achieve this, add this to your [." @@ -5499,7 +5500,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2615 +#: documentation/content/en/articles/committers-guide/_index.adoc:2617 #, no-wrap msgid "" "smtpd_sender_login_maps = hash:/usr/local/etc/postfix/sender_login_maps\n" @@ -5507,33 +5508,33 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2618 +#: documentation/content/en/articles/committers-guide/_index.adoc:2620 msgid "" "Create [.filename]#/usr/local/etc/postfix/sender_login_maps# with the " "following content:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2622 +#: documentation/content/en/articles/committers-guide/_index.adoc:2624 #, no-wrap msgid "[email protected] yourlocalusername\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2625 +#: documentation/content/en/articles/committers-guide/_index.adoc:2627 msgid "" "Where _yourlocalusername_ is the SASL username used to connect to the local " "instance of Postfix." msgstr "" #. type: Block title -#: documentation/content/en/articles/committers-guide/_index.adoc:2628 +#: documentation/content/en/articles/committers-guide/_index.adoc:2630 #, no-wrap msgid "Using OpenSMTPD" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2633 +#: documentation/content/en/articles/committers-guide/_index.adoc:2635 msgid "" "To tell a local OpenSMTPD instance that anything from " "`[email protected]` should be forwarded to the FreeBSD.org servers, " @@ -5541,7 +5542,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2638 +#: documentation/content/en/articles/committers-guide/_index.adoc:2640 #, no-wrap msgid "" "action \"freebsd\" relay host smtp+tls://[email protected]:587 auth <secrets>\n" @@ -5549,32 +5550,32 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2641 +#: documentation/content/en/articles/committers-guide/_index.adoc:2643 msgid "" "Where _yourlocalusername_ is the SASL username used to connect to the local " "instance of OpenSMTPD." msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2643 +#: documentation/content/en/articles/committers-guide/_index.adoc:2645 msgid "" "Create [.filename]#/usr/local/etc/mail/secrets# with the following content:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2647 +#: documentation/content/en/articles/committers-guide/_index.adoc:2649 #, no-wrap msgid "freebsd\tyourusername:yourpassword\n" msgstr "" #. type: Block title -#: documentation/content/en/articles/committers-guide/_index.adoc:2651 +#: documentation/content/en/articles/committers-guide/_index.adoc:2653 #, no-wrap msgid "Using Exim" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2657 +#: documentation/content/en/articles/committers-guide/_index.adoc:2659 #, no-wrap msgid "" "To direct a local Exim instance to forward all mail from `[email protected]`\n" @@ -5582,7 +5583,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2666 +#: documentation/content/en/articles/committers-guide/_index.adoc:2668 #, no-wrap msgid "" "Routers section: (at the top of the list):\n" @@ -5594,7 +5595,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2678 +#: documentation/content/en/articles/committers-guide/_index.adoc:2680 #, no-wrap msgid "" "Transport Section:\n" @@ -5611,7 +5612,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2684 +#: documentation/content/en/articles/committers-guide/_index.adoc:2686 #, no-wrap msgid "" "Authenticators:\n" @@ -5622,26 +5623,26 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/committers-guide/_index.adoc:2687 +#: documentation/content/en/articles/committers-guide/_index.adoc:2689 msgid "" "Create [.filename]#/usr/local/etc/exim/freebsd_send# with the following " "content:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2691 +#: documentation/content/en/articles/committers-guide/_index.adoc:2693 #, no-wrap msgid "[email protected]:smtp.freebsd.org::587\n" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:2696 +#: documentation/content/en/articles/committers-guide/_index.adoc:2698 #, no-wrap msgid "Mentors" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2701 +#: documentation/content/en/articles/committers-guide/_index.adoc:2703 msgid "" "All new developers have a mentor assigned to them for the first few months. " "A mentor is responsible for teaching the mentee the rules and conventions of " @@ -5651,7 +5652,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2704 +#: documentation/content/en/articles/committers-guide/_index.adoc:2706 msgid "" "For committers: do not commit anything without first getting mentor " "approval. Document that approval with an `Approved by:` line in the commit " @@ -5659,7 +5660,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2708 +#: documentation/content/en/articles/committers-guide/_index.adoc:2710 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 [." @@ -5669,13 +5670,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:2710 +#: documentation/content/en/articles/committers-guide/_index.adoc:2712 #, no-wrap msgid "Pre-Commit Review" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2715 +#: documentation/content/en/articles/committers-guide/_index.adoc:2717 msgid "" "Code review is one way to increase the quality of software. The following " "guidelines apply to commits to the `head` (-CURRENT) branch of the `src` " @@ -5685,28 +5686,28 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2717 +#: documentation/content/en/articles/committers-guide/_index.adoc:2719 msgid "" "All non-trivial changes should be reviewed before they are committed to the " "repository." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2718 +#: documentation/content/en/articles/committers-guide/_index.adoc:2720 msgid "" "Reviews may be conducted by email, in Bugzilla, in Phabricator, or by " "another mechanism. Where possible, reviews should be public." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2719 +#: documentation/content/en/articles/committers-guide/_index.adoc:2721 msgid "" "The developer responsible for a code change is also responsible for making " "all necessary review-related changes." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2720 +#: documentation/content/en/articles/committers-guide/_index.adoc:2722 msgid "" "Code review can be an iterative process, which continues until the patch is " "ready to be committed. Specifically, once a patch is sent out for review, it " @@ -5716,12 +5717,12 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2721 +#: documentation/content/en/articles/committers-guide/_index.adoc:2723 msgid "Timeouts are not a substitute for review." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2723 +#: documentation/content/en/articles/committers-guide/_index.adoc:2725 msgid "" "Sometimes code reviews will take longer than you would hope for, especially " "for larger features. Accepted ways to speed up review times for your patches " @@ -5729,14 +5730,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2725 +#: documentation/content/en/articles/committers-guide/_index.adoc:2727 msgid "" "Review other people's patches. If you help out, everybody will be more " "willing to do the same for you; goodwill is our currency." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2726 +#: documentation/content/en/articles/committers-guide/_index.adoc:2728 msgid "" "Ping the patch. If it is urgent, provide reasons why it is important to you " "to get this patch landed and ping it every couple of days. If it is not " @@ -5745,14 +5746,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2727 +#: documentation/content/en/articles/committers-guide/_index.adoc:2729 msgid "" "Ask for help on mailing lists, IRC, etc. Others may be able to either help " "you directly, or suggest a reviewer." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2728 +#: documentation/content/en/articles/committers-guide/_index.adoc:2730 msgid "" "Split your patch into multiple smaller patches that build on each other. The " "smaller your patch, the higher the probability that somebody will take a " @@ -5760,7 +5761,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2730 +#: documentation/content/en/articles/committers-guide/_index.adoc:2732 msgid "" "When making large changes, it is helpful to keep this in mind from the " "beginning of the effort as breaking large changes into smaller ones is often " @@ -5768,7 +5769,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2735 +#: documentation/content/en/articles/committers-guide/_index.adoc:2737 msgid "" "Developers should participate in code reviews as both reviewers and " "reviewees. If someone is kind enough to review your code, you should return " @@ -5779,7 +5780,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2738 +#: documentation/content/en/articles/committers-guide/_index.adoc:2740 msgid "" "In some cases, no subject-matter expert may be available. In those cases, a " "review by an experienced developer is sufficient when coupled with " @@ -5787,26 +5788,26 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/articles/committers-guide/_index.adoc:2740 +#: documentation/content/en/articles/committers-guide/_index.adoc:2742 #, no-wrap msgid "Commit Log Messages" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2743 +#: documentation/content/en/articles/committers-guide/_index.adoc:2745 msgid "" "This section contains some suggestions and traditions for how commit logs " "are formatted." msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:2744 +#: documentation/content/en/articles/committers-guide/_index.adoc:2746 #, no-wrap msgid "Why are commit messages important?" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2748 +#: documentation/content/en/articles/committers-guide/_index.adoc:2750 msgid "" "When you commit a change in Git, Subversion, or another version control " "system (VCS), you're prompted to write some text describing the commit -- a " @@ -5816,7 +5817,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2751 +#: documentation/content/en/articles/committers-guide/_index.adoc:2753 msgid "" "Most projects have more than one developer and last for some length of " "time. Commit messages are a very important method of communicating with " @@ -5824,7 +5825,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2754 +#: documentation/content/en/articles/committers-guide/_index.adoc:2756 msgid "" "FreeBSD has hundreds of active developers and hundreds of thousands of " "commits spanning decades of history. Over that time the developer community " @@ -5833,17 +5834,17 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2756 +#: documentation/content/en/articles/committers-guide/_index.adoc:2758 msgid "Commit messages serve at least three purposes:" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2758 +#: documentation/content/en/articles/committers-guide/_index.adoc:2760 msgid "Communicating with other developers" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2763 +#: documentation/content/en/articles/committers-guide/_index.adoc:2765 msgid "" "FreeBSD commits generate email to various mailing lists. These include the " "commit message along with a copy of the patch itself. Commit messages are " @@ -5855,12 +5856,12 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2765 +#: documentation/content/en/articles/committers-guide/_index.adoc:2767 msgid "Making Changes Discoverable" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2769 +#: documentation/content/en/articles/committers-guide/_index.adoc:2771 msgid "" "In a large project with a long history it may be difficult to find changes " "of interest when investigating an issue or change in behaviour. Verbose, " @@ -5869,12 +5870,12 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2771 +#: documentation/content/en/articles/committers-guide/_index.adoc:2773 msgid "Providing historical documentation" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2775 +#: documentation/content/en/articles/committers-guide/_index.adoc:2777 msgid "" "Commit messages serve to document changes for future developers, perhaps " "years or decades later. This future developer may even be you, the original " @@ -5883,27 +5884,27 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2777 +#: documentation/content/en/articles/committers-guide/_index.adoc:2779 msgid "" "The `git blame` command annotates each line of a source file with the change " "(hash and subject line) that brought it in." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2779 +#: documentation/content/en/articles/committers-guide/_index.adoc:2781 msgid "" "Having established the importance, here are elements of a good FreeBSD " "commit message:" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:2780 +#: documentation/content/en/articles/committers-guide/_index.adoc:2782 #, no-wrap msgid "Start with a subject line" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2784 +#: documentation/content/en/articles/committers-guide/_index.adoc:2786 msgid "" "Commit messages should start with a single-line subject that briefly " "summarizes the change. The subject should, by itself, allow the reader to " @@ -5911,13 +5912,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:2785 +#: documentation/content/en/articles/committers-guide/_index.adoc:2787 #, no-wrap msgid "Keep subject lines short" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2790 +#: documentation/content/en/articles/committers-guide/_index.adoc:2792 msgid "" "The subject line should be as short as possible while still retaining the " "required information. This is to make browsing Git log more efficient, and " @@ -5927,86 +5928,86 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/committers-guide/_index.adoc:2791 +#: documentation/content/en/articles/committers-guide/_index.adoc:2793 #, no-wrap msgid "Prefix the subject line with a component, if applicable" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2794 +#: documentation/content/en/articles/committers-guide/_index.adoc:2796 msgid "" "If the change relates to a specific component the subject line may be " "prefixed with that component name and a colon (:)." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2796 +#: documentation/content/en/articles/committers-guide/_index.adoc:2798 msgid "✓ `foo: Add -k option to keep temporary data`" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/articles/committers-guide/_index.adoc:2798 +#: documentation/content/en/articles/committers-guide/_index.adoc:2800 msgid "" "Include the prefix in the 63-character limit suggested above, so that `git " *** 86065 LINES SKIPPED ***