From nobody Sat Sep 14 18:08:26 2024 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4X5fLN3KTQz5X1fL for ; Sat, 14 Sep 2024 18:08:28 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4X5fLN1X6Vz443D; Sat, 14 Sep 2024 18:08:28 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1726337308; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=t73Hx5s2TKSdCSJmLwW1/YXzP9/xDOPn8v07IGTfyGw=; b=X51wiCVkNZZ17TbWLfP/tryzyf49sIrP3+31R8ON/CKIlLxtWgF9C6cpw1T/i1Hlw2RUn1 Ca7oVzsDn+4ZIMLznkrgLi9vPeranURHiZf3DGwgL4flwj8GZKOrk+cuU2IHta2Dnil8ir JzK3Edk+giArPeJwLiuCZ09xacQFPkG8JjD1C/oOcBLgmx/vr/u9353+yKS3BYSAxDW14G pe5mSLu9AvciUOtyOFf6zB+QNe01MhtkxqXIkKRRBpLK7C8OnjBS8ETO+WU+ijMTBBXEuM cbyhQyxd7DZVZpHmGL3nAiYY3m5LnbKyT3KEvOg88OQ6QH3SXJe+goeXrBY9kg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1726337308; a=rsa-sha256; cv=none; b=lY3d1dqrpVZpdt2S1GOBRRiEO3wN+Gxot73NHSZxbFNoiLsziPW0HEFbxroeCVgpl1cXFe exk5cb5VspXqIJYZeFMPBVM8Z1VwnrClwbzjtjKXJPJCTrqxzWDyEAuBeGJyLNc1QlLDoB n5Lwezs7JJ1u/GHFyOHyDGr7RAI61FKrWSwFe106YmARLQxD3HfNrWcW/Asa0KGfA5baSB bO6kSIbz5VsvcFpnAmaF6mGEy73TMAcIStxb02AFuXou5XmfK3VfR+soLptLEGSvGjG3OU 6qQltK0yPkFHtDiEXqXEnHvZMOPkBC+5pHOmaz39MOWzhGSkUugGYnyvYqIv4w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1726337308; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=t73Hx5s2TKSdCSJmLwW1/YXzP9/xDOPn8v07IGTfyGw=; b=PL9dj01W3hWbFA5VZndh15BICFA2kzRPwh81NxNYfTxoQlzQkHj4zROy1t1vSBOLQbXrO6 ad6PKKpIs+lgAslInzMUFN8ZbqAAzDGmAE+2xFQHHDui/euel8v2GrAjvdphRpYae3AXcR Xtjxp/hNr7mPS9H0FtyNve2cy5PRzcE6vv1eFOGnq888BQUtHG7Lvhv/0WR5/aL5qOVTnn KHX0DV12VUCwTglX826/2uAxgi0i+0z1PuHbW5IAGqoRw/IhifKlvlOfXeBAR8ZhgLVyYn 9gjYN/rTsA+MVti85UuSEE5ou5i+W+Sv/5nql4StDOl9ldnBmhaY0bgQMHPdnw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4X5fLN0T4nzcwQ; Sat, 14 Sep 2024 18:08:28 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 48EI8SvD003269; Sat, 14 Sep 2024 18:08:28 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 48EI8Q53003262; Sat, 14 Sep 2024 18:08:26 GMT (envelope-from git) Date: Sat, 14 Sep 2024 18:08:26 GMT Message-Id: <202409141808.48EI8Q53003262@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: "Danilo G. Baio" Subject: git: e5b122222e - main - doc: Update source files (en .po), for translations List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: dbaio X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e5b122222e92a0c4111f40c131266100756d1200 Auto-Submitted: auto-generated The branch main has been updated by dbaio: URL: https://cgit.FreeBSD.org/doc/commit/?id=e5b122222e92a0c4111f40c131266100756d1200 commit e5b122222e92a0c4111f40c131266100756d1200 Author: Danilo G. Baio AuthorDate: 2024-09-14 18:02:34 +0000 Commit: Danilo G. Baio CommitDate: 2024-09-14 18:02:34 +0000 doc: Update source files (en .po), for translations --- .../en/articles/building-products/_index.po | 374 +- .../content/en/articles/committers-guide/_index.po | 2526 ++-- .../content/en/articles/contributing/_index.po | 357 +- .../content/en/articles/contributors/_index.po | 157 +- .../content/en/articles/freebsd-releng/_index.po | 88 +- .../content/en/articles/gjournal-desktop/_index.po | 4 +- documentation/content/en/articles/hubs/_index.po | 113 +- .../content/en/articles/ipsec-must/_index.po | 139 +- .../content/en/articles/ldap-auth/_index.po | 305 +- .../content/en/articles/license-guide/_index.po | 15 +- .../content/en/articles/linux-users/_index.po | 6 +- documentation/content/en/articles/pam/_index.po | 224 +- .../content/en/articles/pgpkeys/_index.po | 851 +- .../content/en/articles/pr-guidelines/_index.po | 16 +- .../content/en/articles/rc-scripting/_index.po | 683 +- documentation/content/en/articles/releng/_index.po | 20 +- .../content/en/articles/remote-install/_index.po | 14 +- .../content/en/articles/solid-state/_index.po | 147 +- documentation/content/en/articles/vinum/_index.po | 70 +- .../content/en/books/arch-handbook/boot/_index.po | 528 +- .../en/books/arch-handbook/driverbasics/_index.po | 34 +- .../content/en/books/arch-handbook/mac/_index.po | 5004 ++++---- .../content/en/books/arch-handbook/parti.po | 4 +- .../content/en/books/arch-handbook/smp/_index.po | 310 +- .../content/en/books/arch-handbook/sound/_index.po | 189 +- .../content/en/books/arch-handbook/usb/_index.po | 10 +- .../content/en/books/design-44bsd/_index.po | 704 +- documentation/content/en/books/dev-model/_index.po | 1036 +- .../en/books/developers-handbook/ipv6/_index.po | 612 +- .../en/books/developers-handbook/sockets/_index.po | 297 +- .../en/books/developers-handbook/testing/_index.po | 141 +- .../en/books/developers-handbook/tools/_index.po | 836 +- .../en/books/developers-handbook/x86/_index.po | 60 +- documentation/content/en/books/faq/_index.po | 6 +- .../books/fdp-primer/asciidoctor-primer/_index.po | 135 +- .../en/books/fdp-primer/editor-config/_index.po | 101 +- .../books/handbook/advanced-networking/_index.po | 947 +- .../content/en/books/handbook/audit/_index.po | 21 +- .../content/en/books/handbook/basics/_index.po | 1196 +- .../content/en/books/handbook/boot/_index.po | 61 +- .../content/en/books/handbook/bsdinstall/_index.po | 1199 +- .../content/en/books/handbook/config/_index.po | 934 +- .../en/books/handbook/cutting-edge/_index.po | 684 +- .../content/en/books/handbook/desktop/_index.po | 143 +- .../content/en/books/handbook/disks/_index.po | 1175 +- .../content/en/books/handbook/dtrace/_index.po | 62 +- .../content/en/books/handbook/firewalls/_index.po | 858 +- .../content/en/books/handbook/geom/_index.po | 318 +- .../content/en/books/handbook/glossary.po | 686 +- .../content/en/books/handbook/introduction.po | 4 +- .../en/books/handbook/introduction/_index.po | 6 +- .../content/en/books/handbook/jails/_index.po | 873 +- .../en/books/handbook/kernelconfig/_index.po | 47 +- .../content/en/books/handbook/l10n/_index.po | 417 +- .../content/en/books/handbook/linuxemu/_index.po | 4 +- .../content/en/books/handbook/mac/_index.po | 5 +- .../content/en/books/handbook/mail/_index.po | 454 +- .../content/en/books/handbook/mirrors/_index.po | 181 +- .../en/books/handbook/network-servers/_index.po | 1480 +-- .../content/en/books/handbook/network/_index.po | 233 +- .../content/en/books/handbook/ports/_index.po | 613 +- .../content/en/books/handbook/printing/_index.po | 444 +- .../content/en/books/handbook/security/_index.po | 914 +- .../en/books/handbook/serialcomms/_index.po | 902 +- .../en/books/handbook/virtualization/_index.po | 2056 +++- .../content/en/books/handbook/wayland/_index.po | 331 +- .../content/en/books/handbook/wine/_index.po | 610 +- .../content/en/books/handbook/x11/_index.po | 78 +- .../content/en/books/handbook/zfs/_index.po | 1725 +-- .../en/books/porters-handbook/flavors/_index.po | 171 +- .../en/books/porters-handbook/makefiles/_index.po | 4055 +++---- .../en/books/porters-handbook/new-port/_index.po | 6 +- .../en/books/porters-handbook/order/_index.po | 228 +- .../en/books/porters-handbook/pkg-files/_index.po | 5 +- .../en/books/porters-handbook/plist/_index.po | 335 +- .../en/books/porters-handbook/security/_index.po | 118 +- .../en/books/porters-handbook/special/_index.po | 4150 +++---- .../en/books/porters-handbook/testing/_index.po | 321 +- .../en/books/porters-handbook/upgrading/_index.po | 26 +- .../en/books/porters-handbook/uses/_index.po | 2103 ++-- .../en/books/porters-handbook/versions/_index.po | 11986 ++++++++++--------- 81 files changed, 30631 insertions(+), 28650 deletions(-) diff --git a/documentation/content/en/articles/building-products/_index.po b/documentation/content/en/articles/building-products/_index.po index f7405dcdc2..6eb038a683 100644 --- a/documentation/content/en/articles/building-products/_index.po +++ b/documentation/content/en/articles/building-products/_index.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2022-02-01 09:21-0300\n" +"POT-Creation-Date: 2024-09-14 14:59-0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -67,18 +67,19 @@ msgid "Introduction" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:66 +#: documentation/content/en/articles/building-products/_index.adoc:67 msgid "" "FreeBSD today is well-known as a high-performance server operating system. " "It is deployed on millions of web servers and internet-facing hosts " "worldwide. FreeBSD code also forms an integral part of many products, " "ranging from appliances such as network routers, firewalls, and storage " "devices, to personal computers. Portions of FreeBSD have also been used in " -"commercial shrink-wrapped software (see <>)." +"commercial shrink-wrapped software (see crossref:building-products[freebsd-" +"intro])." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:68 +#: documentation/content/en/articles/building-products/_index.adoc:69 msgid "" "In this article we look at the link:https://www.FreeBSD.org/[FreeBSD " "project] as a software engineering resource-as a collection of building " @@ -86,7 +87,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:71 +#: documentation/content/en/articles/building-products/_index.adoc:72 msgid "" "While FreeBSD's source is distributed freely to the public, to fully enjoy " "the benefits of the project's work, organizations need to _collaborate_ with " @@ -96,7 +97,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:74 +#: documentation/content/en/articles/building-products/_index.adoc:75 #, no-wrap msgid "" "*Caveat Reader.* The author believes that the characteristics of the FreeBSD Project listed in this article were substantially true at the time the article was conceived and written (2005).\n" @@ -104,19 +105,19 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:75 +#: documentation/content/en/articles/building-products/_index.adoc:76 #, no-wrap msgid "Target Audience" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:78 +#: documentation/content/en/articles/building-products/_index.adoc:79 msgid "" "This document would be of interest to the following broad groups of people:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:80 +#: documentation/content/en/articles/building-products/_index.adoc:81 msgid "" "Decision makers in product companies looking at ways to improve their " "product quality, reduce their time to market and lower engineering costs in " @@ -124,66 +125,66 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:81 +#: documentation/content/en/articles/building-products/_index.adoc:82 msgid "" -"Technology consultants looking for best-practices in leveraging \"open-source" -"\"." +"Technology consultants looking for best-practices in leveraging \"open-" +"source\"." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:82 +#: documentation/content/en/articles/building-products/_index.adoc:83 msgid "" "Industry observers interested in understanding the dynamics of open-source " "projects." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:83 +#: documentation/content/en/articles/building-products/_index.adoc:84 msgid "" "Software developers seeking to use FreeBSD and looking for ways to " "contribute back." msgstr "" #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:84 +#: documentation/content/en/articles/building-products/_index.adoc:85 #, no-wrap msgid "Article Goals" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:87 +#: documentation/content/en/articles/building-products/_index.adoc:88 msgid "After reading this article you should have:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:89 +#: documentation/content/en/articles/building-products/_index.adoc:90 msgid "" "An understanding of the goals of the FreeBSD Project and its organizational " "structure." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:90 +#: documentation/content/en/articles/building-products/_index.adoc:91 msgid "" "An understanding of its development model and release engineering processes." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:91 +#: documentation/content/en/articles/building-products/_index.adoc:92 msgid "" "An understanding of how conventional corporate software development " "processes differ from that used in the FreeBSD project." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:92 +#: documentation/content/en/articles/building-products/_index.adoc:93 msgid "" "Awareness of the communication channels used by the project and the level of " "transparency you can expect." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:93 +#: documentation/content/en/articles/building-products/_index.adoc:94 msgid "" "Awareness of optimal ways of working with the project-how best to reduce " "engineering costs, improve time to market, manage security vulnerabilities, " @@ -192,111 +193,113 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:94 +#: documentation/content/en/articles/building-products/_index.adoc:95 #, no-wrap msgid "Article Structure" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:97 +#: documentation/content/en/articles/building-products/_index.adoc:98 msgid "The rest of the article is structured as follows:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:99 +#: documentation/content/en/articles/building-products/_index.adoc:100 msgid "" -"<> introduces the FreeBSD project, explores its " -"organizational structure, key technologies and release engineering processes." +"crossref:building-products[freebsd-intro] introduces the FreeBSD project, " +"explores its organizational structure, key technologies and release " +"engineering processes." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:100 +#: documentation/content/en/articles/building-products/_index.adoc:101 msgid "" -"<> describes ways to collaborate with the FreeBSD " -"project. It examines common pitfalls encountered by corporates working with " -"voluntary projects like FreeBSD." +"crossref:building-products[freebsd-collaboration] describes ways to " +"collaborate with the FreeBSD project. It examines common pitfalls " +"encountered by corporates working with voluntary projects like FreeBSD." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:101 -msgid "<> concludes." +#: documentation/content/en/articles/building-products/_index.adoc:102 +msgid "crossref:building-products[conclusion] concludes." msgstr "" #. type: Title == -#: documentation/content/en/articles/building-products/_index.adoc:103 +#: documentation/content/en/articles/building-products/_index.adoc:104 #, no-wrap msgid "FreeBSD as a set of building blocks" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:106 +#: documentation/content/en/articles/building-products/_index.adoc:107 msgid "FreeBSD makes an excellent foundation on which to build products:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:108 +#: documentation/content/en/articles/building-products/_index.adoc:110 msgid "" "FreeBSD source code is distributed under a liberal BSD license facilitating " -"its adoption in commercial products <> with minimum hassle." +"its adoption in commercial products crossref:building-products[Mon2005] with " +"minimum hassle." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:109 +#: documentation/content/en/articles/building-products/_index.adoc:111 msgid "" "The FreeBSD project has excellent engineering practices that can be " "leveraged." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:110 +#: documentation/content/en/articles/building-products/_index.adoc:112 msgid "" "The project offers exceptional transparency into its workings, allowing " "organizations using its code to plan effectively for the future." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:111 +#: documentation/content/en/articles/building-products/_index.adoc:115 msgid "" "The culture of the FreeBSD project, carried over from the Computer Science " -"Research Group at The University of California, Berkeley <>, " -"fosters high-quality work. Some features in FreeBSD define the state of the " -"art." +"Research Group at The University of California, Berkeley crossref:building-" +"products[McKu1999-1], fosters high-quality work. Some features in FreeBSD " +"define the state of the art." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:114 +#: documentation/content/en/articles/building-products/_index.adoc:118 msgid "" -"<> examines the business reasons for using open-source in " -"greater detail. For organizations, the benefits of using FreeBSD components " -"in their products include a shorter time to market, lower development costs " -"and lower development risks." +"crossref:building-products[GoldGab2005] examines the business reasons for " +"using open-source in greater detail. For organizations, the benefits of " +"using FreeBSD components in their products include a shorter time to market, " +"lower development costs and lower development risks." msgstr "" #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:115 +#: documentation/content/en/articles/building-products/_index.adoc:119 #, no-wrap msgid "Building with FreeBSD" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:118 +#: documentation/content/en/articles/building-products/_index.adoc:122 msgid "Here are a few ways organizations have used FreeBSD:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:120 +#: documentation/content/en/articles/building-products/_index.adoc:124 msgid "As an upstream source for tested code for libraries and utilities." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:122 +#: documentation/content/en/articles/building-products/_index.adoc:126 msgid "" "By being \"downstream\" of the project, organizations leverage the new " "features, bug fixes and testing that the upstream code receives." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:123 +#: documentation/content/en/articles/building-products/_index.adoc:127 msgid "" "As an embedded OS (for example, for an OEM router and firewall device). In " "this model, organizations use a customized FreeBSD kernel and application " @@ -306,21 +309,21 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:125 +#: documentation/content/en/articles/building-products/_index.adoc:129 msgid "" "FreeBSD ships with a self-hosting development environment that allows easy " "creation of such configurations." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:126 +#: documentation/content/en/articles/building-products/_index.adoc:130 msgid "" "As a Unix compatible environment for the management functions of high-end " "storage and networking devices, running on a separate processor \"blade\"." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:130 +#: documentation/content/en/articles/building-products/_index.adoc:134 msgid "" "FreeBSD provides the tools for creating dedicated OS and application program " "images. Its implementation of a BSD unix API is mature and tested. FreeBSD " @@ -329,14 +332,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:131 +#: documentation/content/en/articles/building-products/_index.adoc:135 msgid "" "As a vehicle to get widespread testing and support from a worldwide team of " "developers for non-critical \"intellectual property\"." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:135 +#: documentation/content/en/articles/building-products/_index.adoc:139 msgid "" "In this model, organizations contribute useful infrastructural frameworks to " "the FreeBSD project (for example, see man:netgraph[3]). The widespread " @@ -347,28 +350,28 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:136 +#: documentation/content/en/articles/building-products/_index.adoc:140 msgid "" "As a development environment supporting cross-development for embedded OSes " "like http://www.rtems.com/[RTEMS] and http://ecos.sourceware.org/[eCOS]." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:138 +#: documentation/content/en/articles/building-products/_index.adoc:142 msgid "" "There are many full-fledged development environments in the {numports}-" "strong collection of applications ported and packaged with FreeBSD." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:139 +#: documentation/content/en/articles/building-products/_index.adoc:143 msgid "" "As a way to support a Unix-like API in an otherwise proprietary OS, " "increasing its palatability for application developers." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:143 +#: documentation/content/en/articles/building-products/_index.adoc:147 msgid "" "Here parts of FreeBSD's kernel and application programs are \"ported\" to " "run alongside other tasks in the proprietary OS. The availability of a " @@ -380,109 +383,110 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:145 +#: documentation/content/en/articles/building-products/_index.adoc:149 #, no-wrap msgid "Technologies" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:149 +#: documentation/content/en/articles/building-products/_index.adoc:153 msgid "" "There are a large number of technologies supported by the FreeBSD project. " "A selection of these are listed below:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:151 +#: documentation/content/en/articles/building-products/_index.adoc:155 msgid "" "A complete system that can cross-host itself for link:https://www.FreeBSD." "org/platforms/[many architectures:]" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:152 +#: documentation/content/en/articles/building-products/_index.adoc:156 msgid "" "A modular symmetric multiprocessing capable kernel, with loadable kernel " "modules and a flexible and easy to use configuration system." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:153 +#: documentation/content/en/articles/building-products/_index.adoc:157 msgid "" "Support for emulation of Linux(TM) and SVR4 binaries at near machine speeds. " "Support for binary Windows(TM) (NDIS) network drivers." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:154 +#: documentation/content/en/articles/building-products/_index.adoc:158 msgid "" "Libraries for many programming tasks: archivers, FTP and HTTP support, " "thread support, in addition to a full POSIX(TM) like programming environment." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:155 +#: documentation/content/en/articles/building-products/_index.adoc:159 msgid "" "Security features: Mandatory Access Control (man:mac[9]), jails (man:" "jail[2]), ACLs, and in-kernel cryptographic device support." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:156 +#: documentation/content/en/articles/building-products/_index.adoc:160 msgid "" "Networking features: firewall-ing, QoS management, high-performance TCP/IP " "networking with support for many extensions." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:158 +#: documentation/content/en/articles/building-products/_index.adoc:162 msgid "" "FreeBSD's in-kernel Netgraph (man:netgraph[4]) framework allows kernel " "networking modules to be connected together in flexible ways." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:159 +#: documentation/content/en/articles/building-products/_index.adoc:163 msgid "" "Support for storage technologies: Fibre Channel, SCSI, software and hardware " "RAID, ATA and SATA." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:161 +#: documentation/content/en/articles/building-products/_index.adoc:167 +#, no-wrap msgid "" -"FreeBSD supports a number of filesystems, and its native UFS2 filesystem " -"supports soft updates, snapshots and very large filesystem sizes (16TB per " -"filesystem) <>." +"FreeBSD supports a number of filesystems, and its native UFS2 filesystem\n" +"supports soft updates, snapshots and very large filesystem sizes (16TB per\n" +"\t\tfilesystem) crossref:building-products[McKu1999].\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:163 +#: documentation/content/en/articles/building-products/_index.adoc:169 msgid "" "FreeBSD's in-kernel GEOM (man:geom[4]) framework allows kernel storage " "modules to be composed in flexible ways." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:164 +#: documentation/content/en/articles/building-products/_index.adoc:170 msgid "" "Over {numports} ported applications, both commercial and open-source, " "managed via the FreeBSD ports collection." msgstr "" #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:165 +#: documentation/content/en/articles/building-products/_index.adoc:171 #, no-wrap msgid "Organizational Structure" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:168 +#: documentation/content/en/articles/building-products/_index.adoc:174 msgid "FreeBSD's organizational structure is non-hierarchical." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:170 +#: documentation/content/en/articles/building-products/_index.adoc:176 msgid "" "There are essentially two kinds of contributors to FreeBSD, general users of " "FreeBSD, and developers with write access (known as _committers_ in the " @@ -490,7 +494,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:174 +#: documentation/content/en/articles/building-products/_index.adoc:180 msgid "" "There are many thousands of contributors in the first group; the vast " "majority of contributions to FreeBSD come from individuals in this group. " @@ -501,62 +505,64 @@ msgid "" msgstr "" #. type: Block title -#: documentation/content/en/articles/building-products/_index.adoc:175 +#: documentation/content/en/articles/building-products/_index.adoc:181 #, no-wrap msgid "FreeBSD Organization" msgstr "" #. type: Target for macro image -#: documentation/content/en/articles/building-products/_index.adoc:176 +#: documentation/content/en/articles/building-products/_index.adoc:182 #, no-wrap msgid "freebsd-organization.png" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:179 +#: documentation/content/en/articles/building-products/_index.adoc:185 msgid "" "Conflict resolution is performed by a nine member \"Core Team\" that is " "elected from the group of committers." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:183 +#: documentation/content/en/articles/building-products/_index.adoc:190 msgid "" "FreeBSD does not have \"corporate\" committers. Individual committers are " "required to take responsibility for the changes they introduce to the code. " -"The extref:{committers-guide}[FreeBSD Committer's guide] <> " -"documents the rules and responsibilities for committers." +"The extref:{committers-guide}[FreeBSD Committer's guide] crossref:building-" +"products[ComGuide] documents the rules and responsibilities for committers." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:185 -msgid "FreeBSD's project model is examined in detail in <>." +#: documentation/content/en/articles/building-products/_index.adoc:193 +msgid "" +"FreeBSD's project model is examined in detail in crossref:building-" +"products[Nik2005]." msgstr "" #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:186 +#: documentation/content/en/articles/building-products/_index.adoc:194 #, no-wrap msgid "FreeBSD Release Engineering Processes" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:190 +#: documentation/content/en/articles/building-products/_index.adoc:199 msgid "" "FreeBSD's release engineering processes play a major role in ensuring that " "its released versions are of a high quality. At any point of time, " -"FreeBSD's volunteers support multiple code lines (<>):" +"FreeBSD's volunteers support multiple code lines (crossref:building-" +"products[fig-freebsd-branches, FreeBSD Release Branches]):" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:192 +#: documentation/content/en/articles/building-products/_index.adoc:201 msgid "" "New features and disruptive code enters on the development branch, also " "known as the _-CURRENT_ branch." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:193 +#: documentation/content/en/articles/building-products/_index.adoc:202 msgid "" "_-STABLE_ branches are code lines that are branched from HEAD at regular " "intervals. Only tested code is allowed onto a -STABLE branch. New features " @@ -564,33 +570,33 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:194 +#: documentation/content/en/articles/building-products/_index.adoc:203 msgid "" "_-RELEASE_ branches are maintained by the FreeBSD security team. Only bug " "fixes for critical issues are permitted onto -RELEASE branches." msgstr "" #. type: Block title -#: documentation/content/en/articles/building-products/_index.adoc:196 +#: documentation/content/en/articles/building-products/_index.adoc:205 #, no-wrap msgid "FreeBSD Release Branches" msgstr "" #. type: Target for macro image -#: documentation/content/en/articles/building-products/_index.adoc:197 +#: documentation/content/en/articles/building-products/_index.adoc:206 #, no-wrap msgid "freebsd-branches.png" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:200 +#: documentation/content/en/articles/building-products/_index.adoc:209 msgid "" "Code lines are kept alive for as long as there is user and developer " "interest in them." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:203 +#: documentation/content/en/articles/building-products/_index.adoc:212 msgid "" "Machine architectures are grouped into \"tiers\"; _Tier 1_ architectures are " "fully supported by the project's release engineering and security teams, " @@ -601,7 +607,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:206 +#: documentation/content/en/articles/building-products/_index.adoc:215 msgid "" "The release engineering team publishes a link:https://www.FreeBSD.org/releng/" "[road map] for future releases of FreeBSD on the project's web site. The " @@ -610,24 +616,26 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:208 -msgid "FreeBSD's release engineering processes are described in <>." +#: documentation/content/en/articles/building-products/_index.adoc:218 +msgid "" +"FreeBSD's release engineering processes are described in crossref:building-" +"products[RelEngDoc]." msgstr "" #. type: Title == -#: documentation/content/en/articles/building-products/_index.adoc:210 +#: documentation/content/en/articles/building-products/_index.adoc:220 #, no-wrap msgid "Collaborating with FreeBSD" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:213 +#: documentation/content/en/articles/building-products/_index.adoc:223 msgid "" "Open-source projects like FreeBSD offer finished code of a very high quality." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:218 +#: documentation/content/en/articles/building-products/_index.adoc:228 msgid "" "While access to quality source code can reduce the cost of initial " "development, in the long-term the costs of managing change begin to " @@ -640,7 +648,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:220 +#: documentation/content/en/articles/building-products/_index.adoc:230 msgid "" "FreeBSD has an active developer community around it. At the time of writing " "there are many thousands of contributors from every populated continent in " @@ -649,24 +657,25 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:221 -msgid "The goals of the FreeBSD project are <>:" +#: documentation/content/en/articles/building-products/_index.adoc:231 +msgid "" +"The goals of the FreeBSD project are crossref:building-products[Hub1994]:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:223 +#: documentation/content/en/articles/building-products/_index.adoc:233 msgid "" "To develop a high-quality operating system for popular computer hardware, " "and," msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:224 +#: documentation/content/en/articles/building-products/_index.adoc:234 msgid "To make our work available to all under a liberal license." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:226 +#: documentation/content/en/articles/building-products/_index.adoc:236 msgid "" "FreeBSD enjoys an open and transparent working culture. Nearly all " "discussion in the project happens by email, on link:https://lists.freebsd." @@ -677,20 +686,20 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:228 +#: documentation/content/en/articles/building-products/_index.adoc:238 #, no-wrap msgid "Understanding FreeBSD culture" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:231 +#: documentation/content/en/articles/building-products/_index.adoc:241 msgid "" "To be able to work effectively with the FreeBSD project, you need to " "understand the project's culture." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:234 +#: documentation/content/en/articles/building-products/_index.adoc:244 msgid "" "Volunteer driven projects operate under different rules than for-profit " "corporates. A common mistake that companies make when venturing into the " @@ -698,26 +707,32 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:236 +#: documentation/content/en/articles/building-products/_index.adoc:250 #, no-wrap -msgid "*Motivation.* Most contributions to FreeBSD are done voluntarily without monetary rewards entering the picture. The factors that motivate individuals are complex, ranging from altruism, to an interest in solving the kinds of problems that FreeBSD attempts to solve. In this environment, \"elegance is never optional\"<>.\n" +msgid "" +"*Motivation.* Most contributions to FreeBSD are done voluntarily without\n" +"monetary rewards entering the picture. The factors that motivate individuals are\n" +"complex, ranging from altruism, to an interest in solving the kinds of problems\n" +"that FreeBSD attempts to solve. In this environment, \"elegance is never\n" +"optional\"crossref:building-products[Nor1993].\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:238 +#: documentation/content/en/articles/building-products/_index.adoc:252 #, no-wrap msgid "*The Long Term View.* FreeBSD traces its roots back nearly twenty years to the work of the Computer Science Research Group at the University of California Berkeley.footnote:[FreeBSD's source repository contains a history of the project since its inception, and there are CDROMs available that contain earlier code from the CSRG.] A number of the original CSRG developers remain associated with the project.\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:240 +#: documentation/content/en/articles/building-products/_index.adoc:254 msgid "" -"The project values long-term perspectives <>. A frequent acronym " -"encountered in the project is DTRT, which stands for \"Do The Right Thing\"." +"The project values long-term perspectives crossref:building-" +"products[Nor2001]. A frequent acronym encountered in the project is DTRT, " +"which stands for \"Do The Right Thing\"." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:243 +#: documentation/content/en/articles/building-products/_index.adoc:257 #, no-wrap msgid "" "*Development Processes.* Computer programs are tools for communication: at one level programmers communicate their intentions using a precise notation to a tool (a compiler) that translates their instructions to executable code.\n" @@ -725,16 +740,17 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:247 +#: documentation/content/en/articles/building-products/_index.adoc:263 msgid "" "Formal specifications and design documents are seldom used in the project. " -"Clear and well-written code and well-written change logs (<>) are used in their place. FreeBSD development " -"happens by \"rough consensus and running code\"<>." +"Clear and well-written code and well-written change logs (crossref:building-" +"products[fig-change-log, A sample change log entry]) are used in their " +"place. FreeBSD development happens by \"rough consensus and running " +"code\"crossref:building-products[Carp1996]." msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/building-products/_index.adoc:253 +#: documentation/content/en/articles/building-products/_index.adoc:269 #, no-wrap msgid "" "r151864 | bde | 2005-10-29 09:34:50 -0700 (Sat, 29 Oct 2005) | 13 lines\n" @@ -743,7 +759,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/building-products/_index.adoc:263 +#: documentation/content/en/articles/building-products/_index.adoc:279 #, no-wrap msgid "" "Use double precision to simplify and optimize arg reduction for small\n" @@ -758,7 +774,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/articles/building-products/_index.adoc:266 +#: documentation/content/en/articles/building-products/_index.adoc:282 #, no-wrap msgid "" "This speeds up arg reduction by a factor of 2 for |x| between 3*pi/4 and\n" @@ -766,20 +782,20 @@ msgid "" msgstr "" #. type: Block title -#: documentation/content/en/articles/building-products/_index.adoc:267 +#: documentation/content/en/articles/building-products/_index.adoc:283 #, no-wrap msgid "A sample change log entry [[fig-change-log]]" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:270 +#: documentation/content/en/articles/building-products/_index.adoc:286 msgid "" "Communication between programmers is enhanced by the use of a common coding " "standard man:style[9]." msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:273 +#: documentation/content/en/articles/building-products/_index.adoc:289 #, no-wrap msgid "" "*Communication Channels.* FreeBSD's contributors are spread across the world.\n" @@ -787,56 +803,56 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/articles/building-products/_index.adoc:274 +#: documentation/content/en/articles/building-products/_index.adoc:290 #, no-wrap msgid "Best Practices for collaborating with the FreeBSD project" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:277 +#: documentation/content/en/articles/building-products/_index.adoc:293 msgid "" "We now look at a few best practices for making the best use of FreeBSD in " "product development." msgstr "" #. type: Labeled list -#: documentation/content/en/articles/building-products/_index.adoc:278 +#: documentation/content/en/articles/building-products/_index.adoc:294 #, no-wrap msgid "Plan for the long term" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:281 +#: documentation/content/en/articles/building-products/_index.adoc:297 msgid "" "Setup processes that help in tracking the development of FreeBSD. For " "example:" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:283 +#: documentation/content/en/articles/building-products/_index.adoc:299 #, no-wrap msgid "*Track FreeBSD source code.* The project makes it easy to mirror its SVN repository using extref:{committers-guide}[svnsync, svn-advanced-use-setting-up-svnsync]. Having the complete history of the source is useful when debugging complex problems and offers valuable insight into the intentions of the original developers. Use a capable source control system that allows you to easily merge changes between the upstream FreeBSD code base and your own in-house code.\n" msgstr "" #. type: Plain text -#: documentation/content/en/articles/building-products/_index.adoc:287 +#: documentation/content/en/articles/building-products/_index.adoc:306 msgid "" -"<> " -"shows a portion of an annotated listing of the file referenced by the change " -"log in <>. The ancestry of each " -"line of the source is clearly visible. Annotated listings showing the " *** 185571 LINES SKIPPED ***