git: fd158872ad - main - doc: Update source files (en .po), for translations

From: Danilo G. Baio <dbaio_at_FreeBSD.org>
Date: Tue, 24 Jan 2023 20:46:23 UTC
The branch main has been updated by dbaio:

URL: https://cgit.FreeBSD.org/doc/commit/?id=fd158872ad928742df9f0cff832c0812ba6ac398

commit fd158872ad928742df9f0cff832c0812ba6ac398
Author:     Danilo G. Baio <dbaio@FreeBSD.org>
AuthorDate: 2023-01-24 20:45:45 +0000
Commit:     Danilo G. Baio <dbaio@FreeBSD.org>
CommitDate: 2023-01-24 20:45:45 +0000

    doc: Update source files (en .po), for translations
---
 .../en/books/fdp-primer/doc-build/_index.po        | 259 +++++----
 .../content/en/books/handbook/basics/_index.po     | 611 +++++++++++----------
 2 files changed, 462 insertions(+), 408 deletions(-)

diff --git a/documentation/content/en/books/fdp-primer/doc-build/_index.po b/documentation/content/en/books/fdp-primer/doc-build/_index.po
index 81ef0896f6..406f5cdc09 100644
--- a/documentation/content/en/books/fdp-primer/doc-build/_index.po
+++ b/documentation/content/en/books/fdp-primer/doc-build/_index.po
@@ -7,7 +7,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: FreeBSD Documentation VERSION\n"
-"POT-Creation-Date: 2023-01-21 20:00-0300\n"
+"POT-Creation-Date: 2023-01-24 17:44-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"
@@ -244,26 +244,53 @@ msgstr ""
 msgid "% make run BIND=192.168.15.10 HOSTNAME=example.com\n"
 msgstr ""
 
-#. type: Title ===
+#. type: Block title
 #: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:155
 #, no-wrap
+msgid "Build documentation in html for offline usage"
+msgstr ""
+
+#. type: delimited block . 4
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:162
+#, no-wrap
+msgid ""
+"% cd ~/doc/documentation\n"
+"% make html\n"
+msgstr ""
+
+#. type: Plain text
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:165
+msgid "To compress the html output, add `DOC_HTML_ARCHIVE=1`:"
+msgstr ""
+
+#. type: delimited block . 4
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:170
+#, no-wrap
+msgid ""
+"% cd ~/doc/documentation\n"
+"% DOC_HTML_ARCHIVE=1 make html\n"
+msgstr ""
+
+#. type: Title ===
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:174
+#, no-wrap
 msgid "Rendering to pdf"
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:158
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:177
 msgid ""
 "To render the documentation to `pdf`, use one of the following examples."
 msgstr ""
 
 #. type: Block title
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:160
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:179
 #, no-wrap
 msgid "Build all documents in pdf"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:167
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:186
 #, no-wrap
 msgid ""
 "% cd ~/doc/documentation\n"
@@ -271,13 +298,13 @@ msgid ""
 msgstr ""
 
 #. type: Block title
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:171
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:190
 #, no-wrap
 msgid "Build all articles in pdf"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:178
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:197
 #, no-wrap
 msgid ""
 "% cd ~/doc/documentation\n"
@@ -285,13 +312,13 @@ msgid ""
 msgstr ""
 
 #. type: Block title
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:182
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:201
 #, no-wrap
 msgid "Build all books in pdf"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:189
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:208
 #, no-wrap
 msgid ""
 "% cd ~/doc/documentation\n"
@@ -299,13 +326,13 @@ msgid ""
 msgstr ""
 
 #. type: Block title
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:193
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:212
 #, no-wrap
 msgid "Build documents in pdf for specific languages"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:200
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:219
 #, no-wrap
 msgid ""
 "% cd ~/doc/documentation\n"
@@ -313,12 +340,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:202
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:221
 msgid "This will build all English documents in pdf."
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:207
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:226
 #, no-wrap
 msgid ""
 "% cd ~/doc/documentation\n"
@@ -326,77 +353,77 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:209
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:228
 msgid "This will build all English and French books in pdf."
 msgstr ""
 
 #. type: Title ==
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:212
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:231
 #, no-wrap
 msgid "The FreeBSD Documentation Build Toolset"
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:215
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:234
 msgid "These are the tools used to build and install the FDP documentation."
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:217
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:236
 msgid "The primary build tool is man:make[1], specifically Berkeley Make."
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:218
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:237
 msgid "Hugo"
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:219
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:238
 msgid "AsciiDoctor"
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:220
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:239
 msgid "Git"
 msgstr ""
 
 #. type: Title ==
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:222
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:241
 #, no-wrap
 msgid "Understanding the Makefile in the Documentation Tree"
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:225
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:244
 msgid ""
 "There are three [.filename]#Makefile# files for building some or all of the "
 "documentation project."
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:227
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:246
 msgid ""
 "The [.filename]#Makefile# in the [.filename]#documentation# directory will "
 "build only the documentation."
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:228
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:247
 msgid ""
 "The [.filename]#Makefile# in the [.filename]#website# directory will build "
 "only the website."
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:229
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:248
 msgid ""
 "The [.filename]#Makefile# at the top of the tree will build both the "
 "documentation and the website."
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:232
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:251
 msgid ""
 "The [.filename]#Makefile# appearing in subdirectories also support `make "
 "run` to serve built content with Hugo's internal webserver.  This webserver "
@@ -404,18 +431,18 @@ msgid ""
 msgstr ""
 
 #. type: Title ===
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:234
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:253
 #, no-wrap
 msgid "Documentation Makefile"
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:237
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:256
 msgid "This [.filename]#Makefile# takes the following form:"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:262
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:281
 #, no-wrap
 msgid ""
 "# Generate the FreeBSD documentation\n"
@@ -443,14 +470,14 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:264
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:546
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:283
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:565
 #, no-wrap
 msgid "MAINTAINER=carlavilla@FreeBSD.org <.>\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:269
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:288
 #, no-wrap
 msgid ""
 "# List of languages without book translations\n"
@@ -460,7 +487,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:272
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:291
 #, no-wrap
 msgid ""
 "# List of all languages we have content for\n"
@@ -468,14 +495,14 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:274
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:551
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:293
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:570
 #, no-wrap
 msgid "LOCALBASE?=\t/usr/local\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:281
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:300
 #, no-wrap
 msgid ""
 "RUBY_CMD =\t${LOCALBASE}/bin/ruby <.>\n"
@@ -487,7 +514,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:291
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:310
 #, no-wrap
 msgid ""
 ".if defined(DOC_LANG) && !empty(DOC_LANG)\n"
@@ -502,7 +529,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:294
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:313
 #, no-wrap
 msgid ""
 "RUBYLIB =\t../shared/lib\n"
@@ -510,7 +537,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:298
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:317
 #, no-wrap
 msgid ""
 "RUN_DEPENDS=\t${HUGO_CMD} \\\n"
@@ -519,8 +546,8 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:308
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:567
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:327
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:586
 #, no-wrap
 msgid ""
 ".ifndef HOSTNAME\n"
@@ -535,7 +562,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:315
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:334
 #, no-wrap
 msgid ""
 "# Strip the languages with only articles from the list of languages we\n"
@@ -547,7 +574,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:322
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:341
 #, no-wrap
 msgid ""
 "# Strip the languages with only books from the list of languages we\n"
@@ -559,7 +586,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:331
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:350
 #, no-wrap
 msgid ""
 "# Take the list of all languages, and take out the ones we have been\n"
@@ -573,14 +600,14 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:333
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:588
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:352
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:607
 #, no-wrap
 msgid ".ORDER: all run <.>\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:338
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:357
 #, no-wrap
 msgid ""
 ".ORDER: requirements <.>\n"
@@ -590,7 +617,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:341
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:360
 #, no-wrap
 msgid ""
 "all: requirements starting-message generate-pgpkeys-txt build\n"
@@ -598,7 +625,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:344
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:363
 #, no-wrap
 msgid ""
 "# clean does not call pdf-clean as that is a subset of hugo-clean\n"
@@ -606,7 +633,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:351
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:370
 #, no-wrap
 msgid ""
 "requirements:\n"
@@ -618,7 +645,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:356
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:375
 #, no-wrap
 msgid ""
 "requirements-pdf:\n"
@@ -628,7 +655,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:361
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:380
 #, no-wrap
 msgid ""
 "requirements-epub:\n"
@@ -638,7 +665,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:368
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:387
 #, no-wrap
 msgid ""
 "starting-message: .PHONY <.>\n"
@@ -650,13 +677,13 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:370
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:389
 #, no-wrap
 msgid "generate-pgpkeys-txt: static/pgpkeys/pgpkeys.txt\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:373
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:392
 #, no-wrap
 msgid ""
 "static/pgpkeys/pgpkeys.txt: static/pgpkeys/*key\n"
@@ -664,7 +691,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:377
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:396
 #, no-wrap
 msgid ""
 "run-local: .PHONY <.>\n"
@@ -673,8 +700,8 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:380
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:622
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:399
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:641
 #, no-wrap
 msgid ""
 "build: .PHONY <.>\n"
@@ -682,7 +709,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:383
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:402
 #, no-wrap
 msgid ""
 "build-offline: .PHONY\n"
@@ -690,7 +717,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:386
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:405
 #, no-wrap
 msgid ""
 "pgp-clean: .PHONY\n"
@@ -698,7 +725,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:389
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:408
 #, no-wrap
 msgid ""
 "hugo-clean: .PHONY\n"
@@ -706,7 +733,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:395
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:414
 #, no-wrap
 msgid ""
 "#\n"
@@ -717,7 +744,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:400
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:419
 #, no-wrap
 msgid ""
 "pdf-books: requirements-pdf\n"
@@ -727,7 +754,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:405
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:424
 #, no-wrap
 msgid ""
 "pdf-articles: requirements-pdf\n"
@@ -737,13 +764,13 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:407
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:426
 #, no-wrap
 msgid "pdf-clean: pdf-articles-clean pdf-books-clean\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:414
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:433
 #, no-wrap
 msgid ""
 "pdf-books-clean:\n"
@@ -755,7 +782,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:423
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:442
 #, no-wrap
 msgid ""
 "pdf-articles-clean:\n"
@@ -769,7 +796,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:428
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:447
 #, no-wrap
 msgid ""
 "#\n"
@@ -779,13 +806,13 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:430
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:449
 #, no-wrap
 msgid "html-clean: hugo-clean\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:434
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:453
 #, no-wrap
 msgid ""
 "html-clean-global:\n"
@@ -794,7 +821,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:440
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:459
 #, no-wrap
 msgid ""
 "html-clean-articles:\n"
@@ -805,7 +832,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:445
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:464
 #, no-wrap
 msgid ""
 "html-clean-books:\n"
@@ -815,7 +842,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:455
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:474
 #, no-wrap
 msgid ""
 "html-archive:\n"
@@ -830,7 +857,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:461
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:480
 #, no-wrap
 msgid ""
 "html-archive-clean-files:\n"
@@ -841,7 +868,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:467
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:486
 #, no-wrap
 msgid ""
 "#\n"
@@ -852,7 +879,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:480
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:499
 #, no-wrap
 msgid ""
 "epub-books: requirements-epub\n"
@@ -870,7 +897,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:493
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:512
 #, no-wrap
 msgid ""
 "epub-articles: requirements-epub\n"
@@ -888,13 +915,13 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:495
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:514
 #, no-wrap
 msgid "epub-clean: epub-articles-clean epub-books-clean\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:502
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:521
 #, no-wrap
 msgid ""
 "epub-books-clean:\n"
@@ -906,7 +933,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:511
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:530
 #, no-wrap
 msgid ""
 "epub-articles-clean:\n"
@@ -920,81 +947,81 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:514
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:636
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:533
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:655
 msgid "The `MAINTAINER` flag specifies who is the maintainer of this Makefile."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:515
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:534
 msgid ""
 "`ALL_LANGUAGES` flag specifies in which languages the table of contents has "
 "to be generated."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:516
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:637
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:535
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:656
 msgid "`RUBY_CMD` flag specifies the location of the Ruby binary."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:517
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:638
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:536
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:657
 msgid "`HUGO_CMD` flag specifies the location of the Hugo binary."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:518
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:639
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:537
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:658
 msgid ""
 "`.ORDER` directives are used to ensure multiple make jobs may run without "
 "problem."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:519
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:538
 msgid ""
 "`all` target builds the documentation and puts the result in *~/doc/"
 "documentation/public*."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:520
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:641
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:539
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:660
 msgid ""
 "`starting-message` shows a message in the CLI to show the user that the "
 "process is running."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:521
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:644
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:540
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:663
 msgid ""
 "`run-local` runs hugo webserver on port 1313, or a random free port if that "
 "is already in use."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:522
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:541
 msgid ""
 "`build` builds the documentation and puts the result in the *~/doc/"
 "documentation/public*."
 msgstr ""
 
 #. type: Title ===
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:524
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:543
 #, no-wrap
 msgid "Website Makefile"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:527
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:546
 msgid "This [.filename]#Makefile# takes the form of:"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:544
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:563
 #, no-wrap
 msgid ""
 "# Generate the FreeBSD website\n"
@@ -1014,7 +1041,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:549
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:568
 #, no-wrap
 msgid ""
 "# List of all languages we have content for\n"
@@ -1022,7 +1049,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:557
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:576
 #, no-wrap
 msgid ""
 "RUBY_CMD =\t${LOCALBASE}/bin/ruby <.>\n"
@@ -1033,7 +1060,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:577
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:596
 #, no-wrap
 msgid ""
 ".if defined(DOC_LANG) && !empty(DOC_LANG)\n"
@@ -1048,7 +1075,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:586
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:605
 #, no-wrap
 msgid ""
 "# Take the list of all languages, and take out the ones we have been\n"
@@ -1062,7 +1089,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:594
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:613
 #, no-wrap
 msgid ""
 ".ORDER: starting-message generate-releases\n"
@@ -1073,7 +1100,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:598
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:617
 #, no-wrap
 msgid ""
 "all: starting-message generate-releases build post-build end-message <.>\n"
@@ -1082,7 +1109,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:605
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:624
 #, no-wrap
 msgid ""
 "starting-message: .PHONY <.>\n"
@@ -1094,7 +1121,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:610
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:629
 #, no-wrap
 msgid ""
 "end-message: .PHONY\n"
@@ -1104,13 +1131,13 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:612
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:631
 #, no-wrap
 msgid "generate-releases: data/releases.toml <.>\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:615
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:634
 #, no-wrap
 msgid ""
 "data/releases.toml:\n"
@@ -1118,7 +1145,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:619
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:638
 #, no-wrap
 msgid ""
 "run-local: .PHONY <.>\n"
@@ -1127,13 +1154,13 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:624
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:643
 #, no-wrap
 msgid "post-build: cgi-permissions\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:627
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:646
 #, no-wrap
 msgid ""
 "cgi-permissions:\n"
@@ -1141,7 +1168,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:630
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:649
 #, no-wrap
 msgid ""
 "hugo-clean:\n"
@@ -1149,7 +1176,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:633
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:652
 #, no-wrap
 msgid ""
 "releases-clean:\n"
@@ -1157,14 +1184,14 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:640
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:659
 msgid ""
 "`all` target builds the website and puts the result in *~/doc/website/"
 "public*."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:643
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:662
 msgid ""
 "`generate-releases` calls the script used to convert from AsciiDoc variables "
 "to TOML variables.  With this conversion, the releases variables can be used "
@@ -1172,7 +1199,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:644
+#: documentation/content/en/books/fdp-primer/doc-build/_index.adoc:663
 msgid ""
 "`build` builds the website and puts the result in the *~/doc/website/public*."
 msgstr ""
diff --git a/documentation/content/en/books/handbook/basics/_index.po b/documentation/content/en/books/handbook/basics/_index.po
index 9a598d8cf5..b1f5c4f880 100644
--- a/documentation/content/en/books/handbook/basics/_index.po
+++ b/documentation/content/en/books/handbook/basics/_index.po
@@ -7,7 +7,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: FreeBSD Documentation VERSION\n"
-"POT-Creation-Date: 2023-01-21 20:00-0300\n"
+"POT-Creation-Date: 2023-01-24 17:44-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"
@@ -2231,7 +2231,7 @@ msgstr ""
 
 #. type: Table
 #: documentation/content/en/books/handbook/basics/_index.adoc:1030
-#: documentation/content/en/books/handbook/basics/_index.adoc:1603
+#: documentation/content/en/books/handbook/basics/_index.adoc:1623
 #, no-wrap
 msgid "Description"
 msgstr ""
@@ -2658,8 +2658,14 @@ msgid ""
 "type `c:\\foo\\bar\\readme.txt` on FreeBSD."
 msgstr ""
 
+#. type: Title ===
+#: documentation/content/en/books/handbook/basics/_index.adoc:1146
+#, no-wrap
+msgid "File systems"
+msgstr ""
+
 #. type: Plain text
-#: documentation/content/en/books/handbook/basics/_index.adoc:1151
+#: documentation/content/en/books/handbook/basics/_index.adoc:1154
 msgid ""
 "Directories and files are stored in a file system.  Each file system "
 "contains exactly one directory at the very top level, called the _root "
@@ -2671,7 +2677,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/handbook/basics/_index.adoc:1154
+#: documentation/content/en/books/handbook/basics/_index.adoc:1157
 msgid ""
 "Consider three file systems, called `A`, `B`, and `C`.  Each file system has "
 "one root directory, which contains two other directories, called `A1`, `A2` "
@@ -2679,7 +2685,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/handbook/basics/_index.adoc:1158
+#: documentation/content/en/books/handbook/basics/_index.adoc:1161
 msgid ""
 "Call `A` the root file system.  If man:ls[1] is used to view the contents of "
 "this directory, it will show two subdirectories, `A1` and `A2`.  The "
@@ -2687,21 +2693,21 @@ msgid ""
*** 1917 LINES SKIPPED ***