1 files changed, 195 insertions, 179 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 <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\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 <<freebsd-intro>>)."
+"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 ""
-"<<freebsd-intro>> 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 ""
-"<<freebsd-collaboration>> 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 "<<conclusion>> 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 <<Mon2005>> 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 <<McKu1999-1>>, "
-"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 ""
-"<<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."
+"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) <<McKu1999>>."
+"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] <<ComGuide>> "
-"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 <<Nik2005>>."
+#: 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 (<<fig-freebsd-branches, "
-"FreeBSD Release Branches>>):"
+"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 <<RelEngDoc>>."
+#: 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 <<Hub1994>>:"
+#: 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\"<<Nor1993>>.\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 <<Nor2001>>. 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 (<<fig-change-log, "
-"A sample change log entry>>) are used in their place.  FreeBSD development "
-"happens by \"rough consensus and running code\"<<Carp1996>>."
+"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 ""
-"<<fig-svn-blame, An annotated source listing generated using `svn blame`>> "
-"shows a portion of an annotated listing of the file referenced by the change "
-"log in <<fig-change-log, A sample change log entry>>.  The ancestry of each "
-"line of the source is clearly visible.  Annotated listings showing the "
-"history of every file that is part of FreeBSD are https://svnweb.freebsd.org/"
-"[available on the web]."
+"crossref:building-products[fig-svn-blame, An annotated source listing "
+"generated using `svn blame`] shows a portion of an annotated listing of the "
+"file referenced by the change log in crossref:building-products[fig-change-"
+"log, A sample change log entry].  The ancestry of each line of the source is "
+"clearly visible.  Annotated listings showing the history of every file that "
+"is part of FreeBSD are https://svnweb.freebsd.org/[available on the web]."
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/articles/building-products/_index.adoc:291
+#: documentation/content/en/articles/building-products/_index.adoc:310
 #, no-wrap
 msgid "#REV         #WHO #DATE                                        #TEXT\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/articles/building-products/_index.adoc:305
+#: documentation/content/en/articles/building-products/_index.adoc:324
 #, no-wrap
 msgid ""
 "176410        bde 2008-02-19 07:42:46 -0800 (Tue, 19 Feb 2008) #include <sys/cdefs.h>\n"
@@ -855,19 +871,19 @@ msgid ""
 msgstr ""
 
 #. type: Block title
-#: documentation/content/en/articles/building-products/_index.adoc:306
+#: documentation/content/en/articles/building-products/_index.adoc:325
 #, no-wrap
 msgid "An annotated source listing generated using `svn blame` [[fig-svn-blame]]"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:309
+#: documentation/content/en/articles/building-products/_index.adoc:328
 #, no-wrap
 msgid "*Use a gatekeeper.* Appoint a _gatekeeper_ to monitor FreeBSD development, to keep an eye out for changes that could potentially impact your products.\n"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:312
+#: documentation/content/en/articles/building-products/_index.adoc:331
 #, no-wrap
 msgid ""
 "*Report bugs upstream.* If you notice bug in the FreeBSD code that you are using, file a https://www.FreeBSD.org/support/bugreports/[bug report].\n"
@@ -875,13 +891,13 @@ msgid ""
 msgstr ""
 
 #. type: Labeled list
-#: documentation/content/en/articles/building-products/_index.adoc:312
+#: documentation/content/en/articles/building-products/_index.adoc:331
 #, no-wrap
 msgid "Leverage FreeBSD's release engineering efforts"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:315
+#: documentation/content/en/articles/building-products/_index.adoc:334
 msgid ""
 "Use code from a -STABLE development branch of FreeBSD.  These development "
 "branches are formally supported by FreeBSD's release engineering and "
@@ -889,13 +905,13 @@ msgid ""
 msgstr ""
 
 #. type: Labeled list
-#: documentation/content/en/articles/building-products/_index.adoc:316
+#: documentation/content/en/articles/building-products/_index.adoc:335
 #, no-wrap
 msgid "Donate code to reduce costs"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:320
+#: documentation/content/en/articles/building-products/_index.adoc:339
 msgid ""
 "A major proportion of the costs associated with developing products is that "
 "of doing maintenance.  By donating non-critical code to the project, you "
@@ -905,13 +921,13 @@ msgid ""
 msgstr ""
 
 #. type: Labeled list
-#: documentation/content/en/articles/building-products/_index.adoc:321
+#: documentation/content/en/articles/building-products/_index.adoc:340
 #, no-wrap
 msgid "Get support effectively"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:326
+#: documentation/content/en/articles/building-products/_index.adoc:345
 msgid ""
 "For products with tight deadlines, it is recommended that you hire or enter "
 "into a consulting agreement with a developer or firm with FreeBSD "
@@ -923,28 +939,28 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:329
+#: documentation/content/en/articles/building-products/_index.adoc:349
 msgid ""
 "For less critical needs, you can ask for help on the link:https://lists."
 "freebsd.org/[project mailing lists].  A useful guide to follow when asking "
-"for help is given in <<Ray2004>>."
+"for help is given in crossref:building-products[Ray2004]."
 msgstr ""
 
 #. type: Labeled list
-#: documentation/content/en/articles/building-products/_index.adoc:329
+#: documentation/content/en/articles/building-products/_index.adoc:349
 #, no-wrap
 msgid "Publicize your involvement"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:331
+#: documentation/content/en/articles/building-products/_index.adoc:351
 msgid ""
 "You are not required to publicize your use of FreeBSD, but doing so helps "
 "both your effort as well as that of the project."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:335
+#: documentation/content/en/articles/building-products/_index.adoc:355
 msgid ""
 "Letting the FreeBSD community know that your company uses FreeBSD helps "
 "improve your chances of attracting high quality talent.  A large roster of "
@@ -953,13 +969,13 @@ msgid ""
 msgstr ""
 
 #. type: Labeled list
-#: documentation/content/en/articles/building-products/_index.adoc:335
+#: documentation/content/en/articles/building-products/_index.adoc:355
 #, no-wrap
 msgid "Support FreeBSD developers"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:341
+#: documentation/content/en/articles/building-products/_index.adoc:361
 msgid ""
 "Sometimes the most direct way to get a desired feature into FreeBSD is to "
 "support a developer who is already looking at a related problem.  Help can "
@@ -971,20 +987,20 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:343
+#: documentation/content/en/articles/building-products/_index.adoc:363
 msgid ""
 "As a policy the FreeBSD project extref:{contributors}[acknowledges] all "
 "contributions received on its web site."
 msgstr ""
 
 #. type: Title ==
-#: documentation/content/en/articles/building-products/_index.adoc:345
+#: documentation/content/en/articles/building-products/_index.adoc:365
 #, no-wrap
 msgid "Conclusion"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:349
+#: documentation/content/en/articles/building-products/_index.adoc:369
 msgid ""
 "The FreeBSD project's goals are to create and give away the source code for "
 "a high-quality operating system.  By working with the FreeBSD project you "
@@ -993,7 +1009,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:353
+#: documentation/content/en/articles/building-products/_index.adoc:373
 msgid ""
 "We examined the characteristics of the FreeBSD project that make it an "
 "excellent choice for being part of an organization's product strategy.  We "
@@ -1004,13 +1020,13 @@ msgid ""
 msgstr ""
 
 #. type: Title ==
-#: documentation/content/en/articles/building-products/_index.adoc:357
+#: documentation/content/en/articles/building-products/_index.adoc:377
 #, no-wrap
 msgid "Bibliography"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:360
+#: documentation/content/en/articles/building-products/_index.adoc:380
 msgid ""
 "[[Carp1996]] [Carp1996] http://www.ietf.org/rfc/rfc1958.txt[The "
 "Architectural Principles of the Internet] B. Carpenter. The Internet "
@@ -1018,14 +1034,14 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:362
+#: documentation/content/en/articles/building-products/_index.adoc:382
 msgid ""
 "[[ComGuide]] [ComGuide] extref:{committers-guide}[Committer's Guide] The "
 "FreeBSD Project. Copyright(R) 2005."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:364
+#: documentation/content/en/articles/building-products/_index.adoc:384
 msgid ""
 "[[GoldGab2005]] [GoldGab2005] http://dreamsongs.com/IHE/IHE.html[Innovation "
 "Happens Elsewhere: Open Source as Business Strategy] Ron Goldman. Richard "
@@ -1033,14 +1049,14 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:366
+#: documentation/content/en/articles/building-products/_index.adoc:386
 msgid ""
 "[[Hub1994]] [Hub1994] extref:{contributing}[Contributing to the FreeBSD "
 "Project] Jordan Hubbard. Copyright(R) 1994-2005. The FreeBSD Project."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:368
+#: documentation/content/en/articles/building-products/_index.adoc:388
 msgid ""
 "[[McKu1999]] [McKu1999] http://www.usenix.org/publications/library/"
 "proceedings/usenix99/mckusick.html[Soft Updates: A Technique for Eliminating "
@@ -1049,7 +1065,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:370
+#: documentation/content/en/articles/building-products/_index.adoc:390
 msgid ""
 "[[McKu1999-1]] [McKu1999-1] http://www.oreilly.com/catalog/opensources/book/"
 "kirkmck.html[Twenty Years of Berkeley Unix: From AT&T-Owned to Freely "
@@ -1059,7 +1075,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:372
+#: documentation/content/en/articles/building-products/_index.adoc:392
 msgid ""
 "[[Mon2005]] [Mon2005] extref:{bsdl-gpl}[Why you should use a BSD style "
 "license for your Open Source Project] Bruce Montague. The FreeBSD Project. "
@@ -1067,35 +1083,35 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:374
+#: documentation/content/en/articles/building-products/_index.adoc:394
 msgid ""
 "[[Nik2005]] [Nik2005] extref:{dev-model}[A project model for the FreeBSD "
 "Project] Niklas Saers. Copyright(R) 2005. The FreeBSD Project."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:376
+#: documentation/content/en/articles/building-products/_index.adoc:396
 msgid ""
 "[[Nor1993]] [Nor1993] http://www.norvig.com/luv-slides.ps[Tutorial on Good "
 "Lisp Programming Style] Peter Norvig. Kent Pitman. Copyright(R) 1993."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:378
+#: documentation/content/en/articles/building-products/_index.adoc:398
 msgid ""
 "[[Nor2001]] [Nor2001] http://www.norvig.com/21-days.html[Teach Yourself "
 "Programming in Ten Years] Peter Norvig. Copyright(R) 2001."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:380
+#: documentation/content/en/articles/building-products/_index.adoc:400
 msgid ""
 "[[Ray2004]] [Ray2004] http://www.catb.org/~esr/faqs/smart-questions.html[How "
 "to ask questions the smart way] Eric Steven Raymond. Copyright(R) 2004."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/articles/building-products/_index.adoc:381
+#: documentation/content/en/articles/building-products/_index.adoc:401
 msgid ""
 "[[RelEngDoc]] [RelEngDoc] extref:{releng}[FreeBSD Release Engineering] "
 "Murray Stokely. Copyright(R) 2001. The FreeBSD Project."