1 files changed, 233 insertions, 237 deletions

diff --git a/documentation/content/en/books/developers-handbook/tools/_index.po b/documentation/content/en/books/developers-handbook/tools/_index.po
index add16f6905..c1ccabc167 100644
--- a/documentation/content/en/books/developers-handbook/tools/_index.po
+++ b/documentation/content/en/books/developers-handbook/tools/_index.po
@@ -7,7 +7,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: FreeBSD Documentation VERSION\n"
-"POT-Creation-Date: 2023-09-09 18:12-0300\n"
+"POT-Creation-Date: 2024-01-17 20:34-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"
@@ -1580,20 +1580,18 @@ msgid "Introduction to Available Debuggers"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:683
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:682
 msgid ""
 "Using a debugger allows running the program under more controlled "
 "circumstances.  Typically, it is possible to step through the program a line "
 "at a time, inspect the value of variables, change them, tell the debugger to "
 "run up to a certain point and then stop, and so on.  It is also possible to "
 "attach to a program that is already running, or load a core file to "
-"investigate why the program crashed.  It is even possible to debug the "
-"kernel, though that is a little trickier than the user applications we will "
-"be discussing in this section."
+"investigate why the program crashed."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:686
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:685
 msgid ""
 "This section is intended to be a quick introduction to using debuggers and "
 "does not cover specialized topics such as debugging the kernel.  For more "
@@ -1602,74 +1600,72 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:690
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:689
 msgid ""
-"The standard debugger supplied with FreeBSD {rel121-current} is called "
-"`lldb` (LLVM debugger).  As it is part of the standard installation for that "
-"release, there is no need to do anything special to use it.  It has good "
-"command help, accessible via the `help` command, as well as https://lldb."
-"llvm.org/[a web tutorial and documentation]."
+"The standard debugger supplied with FreeBSD is called `lldb` (LLVM "
+"debugger).  As it is part of the standard installation for that release, "
+"there is no need to do anything special to use it.  It has good command "
+"help, accessible via the `help` command, as well as https://lldb.llvm.org/[a "
+"web tutorial and documentation]."
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:695
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:693
 msgid ""
-"The `lldb` command is available for FreeBSD {rel113-current} extref:"
-"{handbook}ports/[from ports or packages, ports-using] as package:devel/"
-"llvm[].  This will install the default version of lldb (currently 9.0)."
+"The `lldb` command is also available extref:{handbook}ports/[from ports or "
+"packages, ports-using] as package:devel/llvm[]."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:702
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:699
 msgid ""
 "The other debugger available with FreeBSD is called `gdb` (GNU debugger).  "
-"Unlike lldb, it is not installed by default on FreeBSD {rel121-current}; to "
-"use it, extref:{handbook}#ports-using/[install] package:devel/gdb[] from "
-"ports or packages.  The version installed by default on FreeBSD {rel113-"
-"current} is old; instead, install package:devel/gdb[] there as well.  It has "
-"quite good on-line help, as well as a set of info pages."
+"Unlike lldb, it is not installed by default on FreeBSD; to use it, extref:"
+"{handbook}#ports-using/[install] package:devel/gdb[] from ports or "
+"packages.  It has excellent on-line help, as well as a set of info pages."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:707
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:704
 msgid ""
-"Which one to use is largely a matter of taste.  If familiar with one only, "
-"use that one.  People familiar with neither or both but wanting to use one "
-"from inside Emacs will need to use `gdb` as `lldb` is unsupported by Emacs.  "
-"Otherwise, try both and see which one you prefer."
+"The two debuggers have a similar feature set, so which one to use is largely "
+"a matter of taste.  If familiar with one only, use that one.  People "
+"familiar with neither or both but wanting to use one from inside Emacs will "
+"need to use `gdb` as `lldb` is unsupported by Emacs.  Otherwise, try both "
+"and see which one you prefer."
 msgstr ""
 
 #. type: Title ===
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:708
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:705
 #, no-wrap
 msgid "Using lldb"
 msgstr ""
 
 #. type: Title ====
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:710
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:707
 #, no-wrap
 msgid "Starting lldb"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:713
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:710
 msgid "Start up lldb by typing"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:717
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:714
 #, no-wrap
 msgid "% lldb -- progname\n"
 msgstr ""
 
 #. type: Title ====
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:719
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:716
 #, no-wrap
 msgid "Running a Program with lldb"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:724
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:721
 msgid ""
 "Compile the program with `-g` to get the most out of using `lldb`.  It will "
 "work without, but will only display the name of the function currently "
@@ -1677,27 +1673,27 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:728
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:725
 #, no-wrap
 msgid "Breakpoint 1: where = temp`main, address = …\n"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:731
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:728
 msgid ""
 "(without an indication of source code filename and line number) when setting "
 "a breakpoint, this means that the program was not compiled with `-g`."
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:736
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:733
 msgid ""
 "Most `lldb` commands have shorter forms that can be used instead.  The "
 "longer forms are used here for clarity."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:741
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:738
 msgid ""
 "At the `lldb` prompt, type `breakpoint set -n main`.  This will tell the "
 "debugger not to display the preliminary set-up code in the program being run "
@@ -1708,7 +1704,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:745
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:742
 msgid ""
 "To step through the program a line at a time, type `thread step-over`.  When "
 "the program gets to a function call, step into it by typing `thread step-"
@@ -1717,29 +1713,29 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:748
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:745
 msgid ""
 "Here is a simple example of how to spot a mistake in a program with `lldb`.  "
 "This is our program (with a deliberate mistake):"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:752
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1026
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:749
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1023
 #, no-wrap
 msgid "#include <stdio.h>\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:754
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1028
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:751
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1025
 #, no-wrap
 msgid "int bazz(int anint);\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:757
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1031
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:754
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1028
 #, no-wrap
 msgid ""
 "main() {\n"
@@ -1747,8 +1743,8 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:762
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1036
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:759
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1033
 #, no-wrap
 msgid ""
 "\tprintf(\"This is my program\\n\");\n"
@@ -1758,8 +1754,8 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:767
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1041
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:764
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1038
 #, no-wrap
 msgid ""
 "int bazz(int anint) {\n"
@@ -1769,21 +1765,21 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:770
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1044
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:767
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1041
 msgid ""
 "This program sets i to be `5` and passes it to a function `bazz()` which "
 "prints out the number we gave it."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:772
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1046
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:769
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1043
 msgid "Compiling and running the program displays"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:779
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:776
 #, no-wrap
 msgid ""
 "% cc -g -o temp temp.c\n"
@@ -1793,12 +1789,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:782
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:779
 msgid "That is not what was expected! Time to see what is going on!"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:793
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:790
 #, no-wrap
 msgid ""
 "% lldb -- temp\n"
@@ -1812,7 +1808,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:827
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:824
 #, no-wrap
 msgid ""
 "Process 9992 stopped\n"
@@ -1851,14 +1847,14 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:830
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:827
 msgid ""
 "Hang on a minute! How did anint get to be `-5360`? Was it not set to `5` in "
 "`main()`? Let us move up to `main()` and have a look."
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:844
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:841
 #, no-wrap
 msgid ""
 "(lldb) up\t\tMove up call stack\n"
@@ -1875,15 +1871,15 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:848
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1089
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:845
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1086
 msgid ""
 "Oh dear! Looking at the code, we forgot to initialize i.  We meant to put"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:854
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1095
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:851
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1092
 #, no-wrap
 msgid ""
 "...\n"
@@ -1892,8 +1888,8 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:858
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1099
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:855
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1096
 #, no-wrap
 msgid ""
 "\ti = 5;\n"
@@ -1902,7 +1898,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:863
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:860
 msgid ""
 "but we left the `i=5;` line out.  As we did not initialize i, it had "
 "whatever number happened to be in that area of memory when the program ran, "
@@ -1910,7 +1906,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:869
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:866
 msgid ""
 "The `lldb` command displays the stack frame every time we go into or out of "
 "a function, even if we are using `up` and `down` to move around the call "
@@ -1921,14 +1917,14 @@ msgid ""
 msgstr ""
 
 #. type: Title ====
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:871
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:868
 #, no-wrap
 msgid "Examining a Core File with lldb"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:876
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1117
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:873
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1114
 msgid ""
 "A core file is basically a file which contains the complete state of the "
 "process when it crashed.  In \"the good old days\", programmers had to print "
@@ -1939,7 +1935,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:879
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:876
 msgid ""
 "To examine a core file, specify the name of the core file in addition to the "
 "program itself.  Instead of starting up `lldb` in the usual way, type `lldb -"
@@ -1947,12 +1943,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:881
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:878
 msgid "The debugger will display something like this:"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:888
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:885
 #, no-wrap
 msgid ""
 "% lldb -c [.filename]#progname.core# -- [.filename]#progname#\n"
@@ -1962,7 +1958,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:894
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:891
 msgid ""
 "In this case, the program was called [.filename]#progname#, so the core file "
 "is called [.filename]#progname.core#.  The debugger does not display why the "
@@ -1971,7 +1967,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:903
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:900
 #, no-wrap
 msgid ""
 "(lldb) thread backtrace all\n"
@@ -1983,7 +1979,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:908
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:905
 msgid ""
 "`SIGSEGV` indicates that the program tried to access memory (run code or "
 "read/write data usually) at a location that does not belong to it, but does "
@@ -1993,13 +1989,13 @@ msgid ""
 msgstr ""
 
 #. type: Title ====
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:909
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:906
 #, no-wrap
 msgid "Attaching to a Running Program with lldb"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:914
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:911
 msgid ""
 "One of the neatest features about `lldb` is that it can attach to a program "
 "that is already running.  Of course, that requires sufficient permissions to "
@@ -2008,34 +2004,34 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:916
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:913
 msgid ""
 "To do that, start up another `lldb`, use `ps` to find the process ID for the "
 "child, and do"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:920
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:917
 #, no-wrap
 msgid "(lldb) process attach -p pid\n"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:923
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:920
 msgid "in `lldb`, and then debug as usual."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:925
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1180
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:922
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1177
 msgid ""
 "For that to work well, the code that calls `fork` to create the child needs "
 "to do something like the following (courtesy of the `gdb` info pages):"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:933
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1188
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:930
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1185
 #, no-wrap
 msgid ""
 "...\n"
@@ -2046,8 +2042,8 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:939
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1194
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:936
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1191
 #, no-wrap
 msgid ""
 "\twhile (PauseMode)\n"
@@ -2058,20 +2054,20 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:942
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:939
 msgid ""
 "Now all that is needed is to attach to the child, set PauseMode to `0` with "
 "`expr PauseMode = 0` and wait for the `sleep()` call to return."
 msgstr ""
 
 #. type: Title ===
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:943
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:940
 #, no-wrap
 msgid "Remote Debugging Using LLDB"
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:949
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:946
 msgid ""
 "The described functionality is available starting with LLDB version 12.0.0.  "
 "Users of FreeBSD releases containing an earlier LLDB version may wish to use "
@@ -2080,7 +2076,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:953
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:950
 msgid ""
 "Starting with LLDB 12.0.0, remote debugging is supported on FreeBSD.  This "
 "means that `lldb-server` can be started to debug a program on one host, "
@@ -2088,87 +2084,87 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:955
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:952
 msgid ""
 "To launch a new process to be debugged remotely, run `lldb-server` on the "
 "remote server by typing"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:959
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:956
 #, no-wrap
 msgid "% lldb-server g host:port -- progname\n"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:962
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:959
 msgid ""
 "The process will be stopped immediately after launching, and `lldb-server` "
 "will wait for the client to connect."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:964
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:961
 msgid ""
 "Start `lldb` locally and type the following command to connect to the remote "
 "server:"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:968
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:965
 #, no-wrap
 msgid "(lldb) gdb-remote host:port\n"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:972
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:969
 msgid ""
 "`lldb-server` can also attach to a running process.  To do that, type the "
 "following on the remote server:"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:976
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:973
 #, no-wrap
 msgid "% lldb-server g host:port --attach pid-or-name\n"
 msgstr ""
 
 #. type: Title ===
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:978
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:975
 #, no-wrap
 msgid "Using gdb"
 msgstr ""
 
 #. type: Title ====
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:980
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:977
 #, no-wrap
 msgid "Starting gdb"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:983
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:980
 msgid "Start up gdb by typing"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:987
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:984
 #, no-wrap
 msgid "% gdb progname\n"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:991
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:988
 msgid "although many people prefer to run it inside Emacs.  To do this, type:"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:995
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:992
 #, no-wrap
 msgid " M-x gdb RET progname RET\n"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:998
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:995
 msgid ""
 "Finally, for those finding its text-based command-prompt style off-putting, "
 "there is a graphical front-end for it (package:devel/xxgdb[]) in the Ports "
@@ -2176,13 +2172,13 @@ msgid ""
 msgstr ""
 
 #. type: Title ====
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:999
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:996
 #, no-wrap
 msgid "Running a Program with gdb"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1004
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1001
 msgid ""
 "Compile the program with `-g` to get the most out of using `gdb`.  It will "
 "work without, but will only display the name of the function currently "
@@ -2190,18 +2186,18 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1008
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1005
 #, no-wrap
 msgid "... (no debugging symbols found) ...\n"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1011
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1008
 msgid "when `gdb` starts up means that the program was not compiled with `-g`."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1015
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1012
 msgid ""
 "At the `gdb` prompt, type `break main`.  This will tell the debugger to skip "
 "the preliminary set-up code in the program being run and to stop execution "
@@ -2211,7 +2207,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1019
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1016
 msgid ""
 "To step through the program a line at a time, press `n`.  When at a function "
 "call, step into it by pressing `s`.  Once in a function call, return from it "
@@ -2219,14 +2215,14 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1022
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1019
 msgid ""
 "Here is a simple example of how to spot a mistake in a program with `gdb`.  "
 "This is our program (with a deliberate mistake):"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1053
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1050
 #, no-wrap
 msgid ""
 "% cc -g -o temp temp.c\n"
@@ -2236,12 +2232,12 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1056
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1053
 msgid "That was not what we expected! Time to see what is going on!"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1068
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1065
 #, no-wrap
 msgid ""
 "% gdb temp\n"
@@ -2256,7 +2252,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1075
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1072
 #, no-wrap
 msgid ""
 "Breakpoint 1, main () at temp.c:9\t\tgdb stops at main()\n"
@@ -2268,14 +2264,14 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1078
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1075
 msgid ""
 "Hang on a minute! How did anint get to be `4231`? Was it not set to `5` in "
 "`main()`? Let us move up to `main()` and have a look."
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1085
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1082
 #, no-wrap
 msgid ""
 "(gdb) up\t\t\t\t\tMove up call stack\n"
@@ -2285,7 +2281,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1104
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1101
 msgid ""
 "but we left the `i=5;` line out.  As we did not initialize i, it had "
 "whatever number happened to be in that area of memory when the program ran, "
@@ -2293,7 +2289,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1110
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1107
 msgid ""
 "The `gdb` command displays the stack frame every time we go into or out of a "
 "function, even if we are using `up` and `down` to move around the call "
@@ -2304,38 +2300,38 @@ msgid ""
 msgstr ""
 
 #. type: Title ====
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1112
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1109
 #, no-wrap
 msgid "Examining a Core File with gdb"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1120
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1117
 msgid ""
 "To examine a core file, start up `gdb` in the usual way.  Instead of typing "
 "`break` or `run`, type"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1124
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1121
 #, no-wrap
 msgid "(gdb) core progname.core\n"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1127
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1124
 msgid ""
 "If the core file is not in the current directory, type `dir /path/to/core/"
 "file` first."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1129
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1126
 msgid "The debugger should display something like this:"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1143
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1140
 #, no-wrap
 msgid ""
 "% gdb [.filename]#progname#\n"
@@ -2352,7 +2348,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1147
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1144
 msgid ""
 "In this case, the program was called [.filename]#progname#, so the core file "
 "is called [.filename]#progname.core#.  We can see that the program crashed "
@@ -2361,7 +2357,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1151
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1148
 msgid ""
 "Sometimes it is useful to be able to see how a function was called, as the "
 "problem could have occurred a long way up the call stack in a complex "
@@ -2369,7 +2365,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1159
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1156
 #, no-wrap
 msgid ""
 "(gdb) bt\n"
@@ -2380,20 +2376,20 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1163
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1160
 msgid ""
 "The `end()` function is called when a program crashes; in this case, the "
 "`bazz()` function was called from `main()`."
 msgstr ""
 
 #. type: Title ====
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1164
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1161
 #, no-wrap
 msgid "Attaching to a Running Program with gdb"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1169
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1166
 msgid ""
 "One of the neatest features about `gdb` is that it can attach to a program "
 "that is already running.  Of course, that requires sufficient permissions to "
@@ -2402,44 +2398,44 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1171
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1168
 msgid ""
 "To do that, start up another `gdb`, use `ps` to find the process ID for the "
 "child, and do"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1175
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1172
 #, no-wrap
 msgid "(gdb) attach pid\n"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1178
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1175
 msgid "in `gdb`, and then debug as usual."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1197
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1194
 msgid ""
 "Now all that is needed is to attach to the child, set PauseMode to `0`, and "
 "wait for the `sleep()` call to return!"
 msgstr ""
 
 #. type: Title ==
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1199
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1196
 #, no-wrap
 msgid "Using Emacs as a Development Environment"
 msgstr ""
 
 #. type: Title ===
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1201
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1198
 #, no-wrap
 msgid "Emacs"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1205
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1202
 msgid ""
 "Emacs is a highly customizable editor-indeed, it has been customized to the "
 "point where it is more like an operating system than an editor! Many "
@@ -2448,14 +2444,14 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1207
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1204
 msgid ""
 "It is impossible even to summarize everything Emacs can do here, but here "
 "are some of the features of interest to developers:"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1209
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1206
 msgid ""
 "Very powerful editor, allowing search-and-replace on both strings and "
 "regular expressions (patterns), jumping to start/end of block expression, "
@@ -2463,58 +2459,58 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1210
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1207
 msgid "Pull-down menus and online help."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1211
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1208
 msgid "Language-dependent syntax highlighting and indentation."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1212
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1209
 msgid "Completely customizable."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1213
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1210
 msgid "You can compile and debug programs within Emacs."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1214
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1211
 msgid ""
 "On a compilation error, you can jump to the offending line of source code."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1215
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1212
 msgid ""
 "Friendly-ish front-end to the `info` program used for reading GNU hypertext "
 "documentation, including the documentation on Emacs itself."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1216
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1213
 msgid ""
 "Friendly front-end to `gdb`, allowing you to look at the source code as you "
 "step through your program."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1218
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1215
 msgid "And doubtless many more that have been overlooked."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1220
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1217
 msgid ""
 "Emacs can be installed on FreeBSD using the package:editors/emacs[] port."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1223
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1220
 msgid ""
 "Once it is installed, start it up and do `C-h t` to read an Emacs tutorial-"
 "that means hold down kbd:[control], press kbd:[h], let go of kbd:[control], "
@@ -2523,7 +2519,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1228
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1225
 msgid ""
 "Although Emacs does have menus, it is well worth learning the key bindings, "
 "as it is much quicker when you are editing something to press a couple of "
@@ -2535,7 +2531,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1232
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1229
 msgid ""
 "Fortunately, it is quite easy to pick up the key-bindings, as they are "
 "displayed next to the menu item.  My advice is to use the menu item for, "
@@ -2545,7 +2541,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1235
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1232
 msgid ""
 "If you cannot remember what a particular combination of keys does, select [."
 "guimenuitem]#Describe Key# from the menu:Help[] menu and type it in-Emacs "
@@ -2555,7 +2551,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1238
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1235
 msgid ""
 "By the way, the expression above means hold down the kbd:[Meta] key, press "
 "kbd:[x], release the kbd:[Meta] key, type `replace-s` (short for `replace-"
@@ -2567,7 +2563,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1241
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1238
 msgid ""
 "If you are wondering what on earth kbd:[Meta] is, it is a special key that "
 "many UNIX(R) workstations have.  Unfortunately, PC's do not have one, so it "
@@ -2575,7 +2571,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1245
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1242
 msgid ""
 "Oh, and to get out of Emacs, do `C-x C-c` (that means hold down the kbd:"
 "[control] key, press kbd:[x], press kbd:[c] and release the kbd:[control] "
@@ -2587,20 +2583,20 @@ msgid ""
 msgstr ""
 
 #. type: Title ===
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1246
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1243
 #, no-wrap
 msgid "Configuring Emacs"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1249
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1246
 msgid ""
 "Emacs does many wonderful things; some of them are built in, some of them "
 "need to be configured."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1253
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1250
 msgid ""
 "Instead of using a proprietary macro language for configuration, Emacs uses "
 "a version of Lisp specially adapted for editors, known as Emacs Lisp.  "
@@ -2610,14 +2606,14 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1255
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1252
 msgid ""
 "The best way to learn Emacs Lisp is to download the link:ftp://ftp.gnu.org/"
 "old-gnu/emacs/elisp-manual-19-2.4.tar.gz[Emacs Tutorial]"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1260
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1257
 msgid ""
 "However, there is no need to actually know any Lisp to get started with "
 "configuring Emacs, as I have included a sample [.filename]#.emacs#, which "
@@ -2627,26 +2623,26 @@ msgid ""
 msgstr ""
 
 #. type: Block title
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1261
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1279
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1258
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1276
 #, no-wrap
 msgid "A Sample [.filename]#.emacs#"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1264
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1261
 msgid ""
 "Unfortunately, there is far too much here to explain it in detail; however "
 "there are one or two points worth mentioning."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1266
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1263
 msgid "Everything beginning with a `;` is a comment and is ignored by Emacs."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1267
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1264
 msgid ""
 "In the first line, the `-*- Emacs-Lisp -*-` is so that we can edit [."
 "filename]#.emacs# itself within Emacs and get all the fancy features for "
@@ -2655,7 +2651,7 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1268
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1265
 msgid ""
 "The kbd:[tab] key is bound to an indentation function in some modes, so when "
 "you press the tab key, it will indent the current line of code. If you want "
@@ -2664,14 +2660,14 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1269
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1266
 msgid ""
 "This file supports syntax highlighting for C, C++, Perl, Lisp and Scheme, by "
 "guessing the language from the filename."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1270
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1267
 msgid ""
 "Emacs already has a pre-defined function called `next-error`. In a "
 "compilation output window, this allows you to move from one compilation "
@@ -2682,20 +2678,20 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1271
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1268
 msgid ""
 "We enable Emacs's ability to act as a server, so that if you are doing "
 "something outside Emacs and you want to edit a file, you can just type in"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1275
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1272
 #, no-wrap
 msgid "% emacsclient filename\n"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1278
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1275
 msgid ""
 "and then you can edit the file in your Emacs!footnote:[Many Emacs users set "
 "their EDITOR environment to emacsclient so this happens every time they need "
@@ -2703,13 +2699,13 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1284
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1281
 #, no-wrap
 msgid ";; -*-Emacs-Lisp-*-\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1289
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1286
 #, no-wrap
 msgid ""
 ";; This file is designed to be re-evaled; use the variable first-time\n"
@@ -2719,7 +2715,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1297
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1294
 #, no-wrap
 msgid ""
 ";; Meta\n"
@@ -2732,7 +2728,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1318
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1315
 #, no-wrap
 msgid ""
 ";; Function keys\n"
@@ -2758,7 +2754,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1336
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1333
 #, no-wrap
 msgid ""
 ";; Keypad bindings\n"
@@ -2781,7 +2777,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1339
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1336
 #, no-wrap
 msgid ""
 ";; Mouse\n"
@@ -2789,7 +2785,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1343
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1340
 #, no-wrap
 msgid ""
 ";; Misc\n"
@@ -2798,7 +2794,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1348
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1345
 #, no-wrap
 msgid ""
 ";; Treat 'y' or <CR> as yes, 'n' as no.\n"
@@ -2808,7 +2804,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1352
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1349
 #, no-wrap
 msgid ""
 ";; Load packages\n"
@@ -2817,7 +2813,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1358
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1355
 #, no-wrap
 msgid ""
 ";; Pretty diff mode\n"
@@ -2828,7 +2824,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1367
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1364
 #, no-wrap
 msgid ""
 "(if first-time\n"
@@ -2842,7 +2838,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1372
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1369
 #, no-wrap
 msgid ""
 ";; Auto font lock mode\n"
@@ -2852,7 +2848,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1377
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1374
 #, no-wrap
 msgid ""
 "(defvar font-lock-mode-keyword-alist\n"
@@ -2862,7 +2858,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1385
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1382
 #, no-wrap
 msgid ""
 "(defun font-lock-auto-mode-select ()\n"
@@ -2875,13 +2871,13 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1387
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1384
 #, no-wrap
 msgid "(global-set-key [M-f1] 'font-lock-fontify-buffer)\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1404
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1401
 #, no-wrap
 msgid ""
 ";; New dabbrev stuff\n"
@@ -2903,7 +2899,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1416
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1413
 #, no-wrap
 msgid ""
 ";; C++ and C mode...\n"
@@ -2920,7 +2916,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1430
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1427
 #, no-wrap
 msgid ""
 "(defun my-c-mode-hook ()\n"
@@ -2939,7 +2935,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1437
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1434
 #, no-wrap
 msgid ""
 ";; Perl mode\n"
@@ -2951,7 +2947,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1441
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1438
 #, no-wrap
 msgid ""
 ";; Scheme mode...\n"
@@ -2960,7 +2956,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1447
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1444
 #, no-wrap
 msgid ""
 ";; Emacs-Lisp mode...\n"
@@ -2971,7 +2967,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1455
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1452
 #, no-wrap
 msgid ""
 ";; Add all of the hooks...\n"
@@ -2984,7 +2980,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1461
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1458
 #, no-wrap
 msgid ""
 ";; Complement to next-error\n"
@@ -2995,7 +2991,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1474
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1471
 #, no-wrap
 msgid ""
 ";; Misc...\n"
@@ -3013,7 +3009,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1480
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1477
 #, no-wrap
 msgid ""
 ";; Elisp archive searching\n"
@@ -3024,7 +3020,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1489
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1486
 #, no-wrap
 msgid ""
 ";; Font lock mode\n"
@@ -3038,7 +3034,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1502
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1499
 #, no-wrap
 msgid ""
 "(if (eq window-system 'x)\n"
@@ -3056,7 +3052,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1510
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1507
 #, no-wrap
 msgid ""
 "      (setq baud-rate 1000000)\n"
@@ -3069,7 +3065,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1527
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1524
 #, no-wrap
 msgid ""
 ";; X11 or PC using direct screen writes\n"
@@ -3091,7 +3087,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1536
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1533
 #, no-wrap
 msgid ""
 ";; TTY type terminal\n"
@@ -3105,7 +3101,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1542
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1539
 #, no-wrap
 msgid ""
 ";; Under UNIX\n"
@@ -3116,7 +3112,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1550
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1547
 #, no-wrap
 msgid ""
 ";; Add any face changes here\n"
@@ -3129,7 +3125,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1556
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1553
 #, no-wrap
 msgid ""
 ";; Restore the \"desktop\" - do this as late as possible\n"
@@ -3140,7 +3136,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1559
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1556
 #, no-wrap
 msgid ""
 ";; Indicate that this file has been read at least once\n"
@@ -3148,19 +3144,19 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1561
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1558
 #, no-wrap
 msgid ";; No need to debug anything now\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1563
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1560
 #, no-wrap
 msgid "(setq debug-on-error nil)\n"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1566
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1563
 #, no-wrap
 msgid ""
 ";; All done\n"
@@ -3168,13 +3164,13 @@ msgid ""
 msgstr ""
 
 #. type: Title ===
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1569
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1566
 #, no-wrap
 msgid "Extending the Range of Languages Emacs Understands"
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1572
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1569
 msgid ""
 "Now, this is all very well if you only want to program in the languages "
 "already catered for in [.filename]#.emacs# (C, C++, Perl, Lisp and Scheme), "
@@ -3183,7 +3179,7 @@ msgid ""
 msgstr ""
 
 #. type: delimited block = 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1576
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1573
 msgid ""
 "The first thing to do is find out if whizbang comes with any files that tell "
 "Emacs about the language.  These usually end in [.filename]#.el#, short for "
@@ -3192,42 +3188,42 @@ msgid ""
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1580
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1577
 #, no-wrap
 msgid "% find /usr/ports/lang/whizbang -name \"*.el\" -print\n"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1584
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1581
 msgid ""
 "and install them by copying them into the Emacs site Lisp directory.  On "
 "FreeBSD, this is [.filename]#/usr/local/share/emacs/site-lisp#."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1586
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1583
 msgid "So for example, if the output from the find command was"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1590
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1587
 #, no-wrap
 msgid "/usr/ports/lang/whizbang/work/misc/whizbang.el\n"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1593
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1590
 msgid "we would do"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1597
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1594
 #, no-wrap
 msgid "# cp /usr/ports/lang/whizbang/work/misc/whizbang.el /usr/local/share/emacs/site-lisp\n"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1602
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1599
 msgid ""
 "Next, we need to decide what extension whizbang source files have.  Let us "
 "say for the sake of argument that they all end in [.filename]#.wiz#.  We "
@@ -3236,14 +3232,14 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1604
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1601
 msgid ""
 "Find the auto-mode-alist entry in [.filename]#.emacs# and add a line for "
 "whizbang, such as:"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1612
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1609
 #, no-wrap
 msgid ""
 "...\n"
@@ -3254,21 +3250,21 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1615
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1612
 msgid ""
 "This means that Emacs will automatically go into `whizbang-mode` when you "
 "edit a file ending in [.filename]#.wiz#."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1618
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1615
 msgid ""
 "Just below this, you will find the font-lock-auto-mode-list entry.  Add "
 "`whizbang-mode` to it like so:"
 msgstr ""
 
 #. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1625
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1622
 #, no-wrap
 msgid ""
 ";; Auto font lock mode\n"
@@ -3278,14 +3274,14 @@ msgid ""
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1628
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1625
 msgid ""
 "This means that Emacs will always enable `font-lock-mode` (ie syntax "
 "highlighting) when editing a [.filename]#.wiz# file."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1631
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1628
 msgid ""
 "And that is all that is needed. If there is anything else you want done "
 "automatically when you open up [.filename]#.wiz#, you can add a `whizbang-"
@@ -3294,66 +3290,66 @@ msgid ""
 msgstr ""
 
 #. type: Title ==
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1633
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1630
 #, no-wrap
 msgid "Further Reading"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1636
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1633
 msgid ""
 "For information about setting up a development environment for contributing "
 "fixes to FreeBSD itself, please see man:development[7]."
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1638
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1635
 msgid ""
 "Brian Harvey and Matthew Wright _Simply Scheme_ MIT 1994. ISBN 0-262-08226-8"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1639
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1636
 msgid "Randall Schwartz _Learning Perl_ O'Reilly 1993 ISBN 1-56592-042-2"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1640
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1637
 msgid ""
 "Patrick Henry Winston and Berthold Klaus Paul Horn _Lisp (3rd Edition)_ "
 "Addison-Wesley 1989 ISBN 0-201-08319-1"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1641
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1638
 msgid ""
 "Brian W. Kernighan and Rob Pike _The Unix Programming Environment_ Prentice-"
 "Hall 1984 ISBN 0-13-937681-X"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1642
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1639
 msgid ""
 "Brian W. Kernighan and Dennis M. Ritchie _The C Programming Language (2nd "
 "Edition)_ Prentice-Hall 1988 ISBN 0-13-110362-8"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1643
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1640
 msgid ""
 "Bjarne Stroustrup _The C++ Programming Language_ Addison-Wesley 1991 ISBN "
 "0-201-53992-6"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1644
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1641
 msgid ""
 "W. Richard Stevens _Advanced Programming in the Unix Environment_ Addison-"
 "Wesley 1992 ISBN 0-201-56317-7"
 msgstr ""
 
 #. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1644
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1641
 msgid ""
 "W. Richard Stevens _Unix Network Programming_ Prentice-Hall 1990 ISBN "
 "0-13-949876-1"