aboutsummaryrefslogtreecommitdiff
path: root/documentation/content/en/books/developers-handbook/tools
diff options
context:
space:
mode:
authorDanilo G. Baio <dbaio@FreeBSD.org>2023-09-09 21:15:57 +0000
committerDanilo G. Baio <dbaio@FreeBSD.org>2023-09-09 21:15:57 +0000
commitc54e4009208857f850f93f0ab3a6f3575c5edb7e (patch)
treee87f605b49d379746107c618eb784dbcb31d94e5 /documentation/content/en/books/developers-handbook/tools
parent435e67c9c3631f536256dc7da76827e2c2b78d95 (diff)
Diffstat (limited to 'documentation/content/en/books/developers-handbook/tools')
-rw-r--r--documentation/content/en/books/developers-handbook/tools/_index.po475
1 files changed, 229 insertions, 246 deletions
diff --git a/documentation/content/en/books/developers-handbook/tools/_index.po b/documentation/content/en/books/developers-handbook/tools/_index.po
index 5e333d24fb..add16f6905 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-04-20 20:56-0300\n"
+"POT-Creation-Date: 2023-09-09 18:12-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"
@@ -1526,36 +1526,19 @@ msgid "More Advanced Uses of `make`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:658
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:659
msgid ""
"`Make` is a very powerful tool, and can do much more than the simple example "
"above shows. Unfortunately, there are several different versions of `make`, "
"and they all differ considerably. The best way to learn what they can do is "
"probably to read the documentation-hopefully this introduction will have "
-"given you a base from which you can do this."
+"given you a base from which you can do this. The man:make[1] manual page "
+"offers a comprehensive discussion of variables, arguments, and how to use "
+"make."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:661
-msgid ""
-"The version of make that comes with FreeBSD is the Berkeley make; there is a "
-"tutorial for it in [.filename]#/usr/src/share/doc/psd/12.make#. To view it, "
-"do"
-msgstr ""
-
-#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:665
-#, no-wrap
-msgid "% zmore paper.ascii.gz\n"
-msgstr ""
-
-#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:668
-msgid "in that directory."
-msgstr ""
-
-#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:672
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:663
msgid ""
"Many applications in the ports use GNU make, which has a very good set of "
"\"info\" pages. If you have installed any of these ports, GNU make will "
@@ -1564,7 +1547,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:675
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:666
msgid ""
"To view the info pages for GNU make, you will have to edit [.filename]#dir# "
"in the [.filename]#/usr/local/info# directory to add an entry for it. This "
@@ -1572,32 +1555,32 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:679
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:670
#, no-wrap
msgid " * Make: (make). The GNU Make utility.\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:682
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:673
msgid ""
"to the file. Once you have done this, you can type `info` and then select [."
"guimenuitem]#make# from the menu (or in Emacs, do `C-h i`)."
msgstr ""
#. type: Title ==
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:684
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:675
#, no-wrap
msgid "Debugging"
msgstr ""
#. type: Title ===
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:686
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:677
#, no-wrap
msgid "Introduction to Available Debuggers"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:692
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:683
msgid ""
"Using a debugger allows running the program under more controlled "
"circumstances. Typically, it is possible to step through the program a line "
@@ -1610,7 +1593,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:695
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:686
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 "
@@ -1619,7 +1602,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:699
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:690
msgid ""
"The standard debugger supplied with FreeBSD {rel121-current} is called "
"`lldb` (LLVM debugger). As it is part of the standard installation for that "
@@ -1629,15 +1612,15 @@ msgid ""
msgstr ""
#. type: delimited block = 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:704
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:695
msgid ""
"The `lldb` command is available for FreeBSD {rel113-current} extref:"
-"{handbook}[from ports or packages, ports-using] as package:devel/llvm[]. "
-"This will install the default version of lldb (currently 9.0)."
+"{handbook}ports/[from ports or packages, ports-using] as package:devel/"
+"llvm[]. This will install the default version of lldb (currently 9.0)."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:711
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:702
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 "
@@ -1648,7 +1631,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:716
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:707
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 "
@@ -1657,36 +1640,36 @@ msgid ""
msgstr ""
#. type: Title ===
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:717
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:708
#, no-wrap
msgid "Using lldb"
msgstr ""
#. type: Title ====
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:719
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:710
#, no-wrap
msgid "Starting lldb"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:722
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:713
msgid "Start up lldb by typing"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:726
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:717
#, no-wrap
msgid "% lldb -- progname\n"
msgstr ""
#. type: Title ====
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:728
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:719
#, no-wrap
msgid "Running a Program with lldb"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:733
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:724
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 "
@@ -1694,27 +1677,27 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:737
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:728
#, no-wrap
msgid "Breakpoint 1: where = temp`main, address = …\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:740
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:731
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:745
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:736
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:750
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:741
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 "
@@ -1725,7 +1708,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:754
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:745
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-"
@@ -1734,29 +1717,29 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:757
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:748
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:761
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1035
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:752
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1026
#, no-wrap
msgid "#include <stdio.h>\n"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:763
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1037
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:754
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1028
#, no-wrap
msgid "int bazz(int anint);\n"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:766
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1040
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:757
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1031
#, no-wrap
msgid ""
"main() {\n"
@@ -1764,8 +1747,8 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:771
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1045
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:762
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1036
#, no-wrap
msgid ""
"\tprintf(\"This is my program\\n\");\n"
@@ -1775,8 +1758,8 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:776
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1050
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:767
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1041
#, no-wrap
msgid ""
"int bazz(int anint) {\n"
@@ -1786,21 +1769,21 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:779
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1053
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:770
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1044
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:781
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1055
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:772
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1046
msgid "Compiling and running the program displays"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:788
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:779
#, no-wrap
msgid ""
"% cc -g -o temp temp.c\n"
@@ -1810,12 +1793,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:791
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:782
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:802
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:793
#, no-wrap
msgid ""
"% lldb -- temp\n"
@@ -1829,7 +1812,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:836
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:827
#, no-wrap
msgid ""
"Process 9992 stopped\n"
@@ -1868,14 +1851,14 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:839
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:830
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:853
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:844
#, no-wrap
msgid ""
"(lldb) up\t\tMove up call stack\n"
@@ -1892,15 +1875,15 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:857
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1098
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:848
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1089
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:863
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1104
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:854
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1095
#, no-wrap
msgid ""
"...\n"
@@ -1909,8 +1892,8 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:867
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1108
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:858
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1099
#, no-wrap
msgid ""
"\ti = 5;\n"
@@ -1919,7 +1902,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:872
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:863
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, "
@@ -1927,7 +1910,7 @@ msgid ""
msgstr ""
#. type: delimited block = 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:878
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:869
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 "
@@ -1938,14 +1921,14 @@ msgid ""
msgstr ""
#. type: Title ====
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:880
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:871
#, no-wrap
msgid "Examining a Core File with lldb"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:885
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1126
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:876
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1117
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 "
@@ -1956,7 +1939,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:888
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:879
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 -"
@@ -1964,12 +1947,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:890
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:881
msgid "The debugger will display something like this:"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:897
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:888
#, no-wrap
msgid ""
"% lldb -c [.filename]#progname.core# -- [.filename]#progname#\n"
@@ -1979,7 +1962,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:903
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:894
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 "
@@ -1988,7 +1971,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:912
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:903
#, no-wrap
msgid ""
"(lldb) thread backtrace all\n"
@@ -2000,7 +1983,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:917
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:908
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 "
@@ -2010,13 +1993,13 @@ msgid ""
msgstr ""
#. type: Title ====
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:918
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:909
#, no-wrap
msgid "Attaching to a Running Program with lldb"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:923
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:914
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 "
@@ -2025,34 +2008,34 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:925
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:916
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:929
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:920
#, no-wrap
msgid "(lldb) process attach -p pid\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:932
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:923
msgid "in `lldb`, and then debug as usual."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:934
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1189
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:925
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1180
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:942
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1197
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:933
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1188
#, no-wrap
msgid ""
"...\n"
@@ -2063,8 +2046,8 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:948
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1203
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:939
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1194
#, no-wrap
msgid ""
"\twhile (PauseMode)\n"
@@ -2075,20 +2058,20 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:951
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:942
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:952
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:943
#, no-wrap
msgid "Remote Debugging Using LLDB"
msgstr ""
#. type: delimited block = 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:958
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:949
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 "
@@ -2097,7 +2080,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:962
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:953
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, "
@@ -2105,87 +2088,87 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:964
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:955
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:968
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:959
#, no-wrap
msgid "% lldb-server g host:port -- progname\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:971
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:962
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:973
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:964
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:977
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:968
#, no-wrap
msgid "(lldb) gdb-remote host:port\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:981
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:972
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:985
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:976
#, 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:987
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:978
#, no-wrap
msgid "Using gdb"
msgstr ""
#. type: Title ====
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:989
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:980
#, no-wrap
msgid "Starting gdb"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:992
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:983
msgid "Start up gdb by typing"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:996
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:987
#, no-wrap
msgid "% gdb progname\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1000
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:991
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:1004
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:995
#, no-wrap
msgid " M-x gdb RET progname RET\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1007
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:998
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 "
@@ -2193,13 +2176,13 @@ msgid ""
msgstr ""
#. type: Title ====
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1008
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:999
#, no-wrap
msgid "Running a Program with gdb"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1013
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1004
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 "
@@ -2207,18 +2190,18 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1017
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1008
#, no-wrap
msgid "... (no debugging symbols found) ...\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1020
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1011
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:1024
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1015
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 "
@@ -2228,7 +2211,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1028
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1019
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 "
@@ -2236,14 +2219,14 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1031
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1022
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:1062
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1053
#, no-wrap
msgid ""
"% cc -g -o temp temp.c\n"
@@ -2253,12 +2236,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1065
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1056
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:1077
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1068
#, no-wrap
msgid ""
"% gdb temp\n"
@@ -2273,7 +2256,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1084
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1075
#, no-wrap
msgid ""
"Breakpoint 1, main () at temp.c:9\t\tgdb stops at main()\n"
@@ -2285,14 +2268,14 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1087
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1078
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:1094
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1085
#, no-wrap
msgid ""
"(gdb) up\t\t\t\t\tMove up call stack\n"
@@ -2302,7 +2285,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1113
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1104
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, "
@@ -2310,7 +2293,7 @@ msgid ""
msgstr ""
#. type: delimited block = 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1119
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1110
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 "
@@ -2321,38 +2304,38 @@ msgid ""
msgstr ""
#. type: Title ====
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1121
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1112
#, no-wrap
msgid "Examining a Core File with gdb"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1129
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1120
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:1133
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1124
#, no-wrap
msgid "(gdb) core progname.core\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1136
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1127
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:1138
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1129
msgid "The debugger should display something like this:"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1152
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1143
#, no-wrap
msgid ""
"% gdb [.filename]#progname#\n"
@@ -2369,7 +2352,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1156
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1147
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 "
@@ -2378,7 +2361,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1160
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1151
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 "
@@ -2386,7 +2369,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1168
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1159
#, no-wrap
msgid ""
"(gdb) bt\n"
@@ -2397,20 +2380,20 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1172
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1163
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:1173
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1164
#, no-wrap
msgid "Attaching to a Running Program with gdb"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1178
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1169
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 "
@@ -2419,44 +2402,44 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1180
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1171
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:1184
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1175
#, no-wrap
msgid "(gdb) attach pid\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1187
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1178
msgid "in `gdb`, and then debug as usual."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1206
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1197
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:1208
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1199
#, no-wrap
msgid "Using Emacs as a Development Environment"
msgstr ""
#. type: Title ===
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1210
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1201
#, no-wrap
msgid "Emacs"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1214
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1205
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 "
@@ -2465,14 +2448,14 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1216
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1207
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:1218
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1209
msgid ""
"Very powerful editor, allowing search-and-replace on both strings and "
"regular expressions (patterns), jumping to start/end of block expression, "
@@ -2480,58 +2463,58 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1219
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1210
msgid "Pull-down menus and online help."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1220
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1211
msgid "Language-dependent syntax highlighting and indentation."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1221
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1212
msgid "Completely customizable."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1222
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1213
msgid "You can compile and debug programs within Emacs."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1223
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1214
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:1224
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1215
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:1225
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1216
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:1227
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1218
msgid "And doubtless many more that have been overlooked."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1229
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1220
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:1232
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1223
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], "
@@ -2540,7 +2523,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1237
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1228
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 "
@@ -2552,7 +2535,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:1232
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, "
@@ -2562,7 +2545,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1244
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1235
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 "
@@ -2572,7 +2555,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1247
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1238
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-"
@@ -2584,7 +2567,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1250
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1241
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 "
@@ -2592,7 +2575,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1254
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1245
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] "
@@ -2604,20 +2587,20 @@ msgid ""
msgstr ""
#. type: Title ===
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1255
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1246
#, no-wrap
msgid "Configuring Emacs"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1258
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1249
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:1262
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1253
msgid ""
"Instead of using a proprietary macro language for configuration, Emacs uses "
"a version of Lisp specially adapted for editors, known as Emacs Lisp. "
@@ -2627,14 +2610,14 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1264
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1255
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:1269
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1260
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 "
@@ -2644,26 +2627,26 @@ msgid ""
msgstr ""
#. type: Block title
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1270
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1288
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1261
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1279
#, no-wrap
msgid "A Sample [.filename]#.emacs#"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1273
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1264
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:1275
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1266
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:1276
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1267
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 "
@@ -2672,7 +2655,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1277
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1268
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 "
@@ -2681,14 +2664,14 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1278
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1269
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:1279
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1270
msgid ""
"Emacs already has a pre-defined function called `next-error`. In a "
"compilation output window, this allows you to move from one compilation "
@@ -2699,20 +2682,20 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1280
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1271
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:1284
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1275
#, no-wrap
msgid "% emacsclient filename\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1287
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1278
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 "
@@ -2720,13 +2703,13 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1293
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1284
#, no-wrap
msgid ";; -*-Emacs-Lisp-*-\n"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1298
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1289
#, no-wrap
msgid ""
";; This file is designed to be re-evaled; use the variable first-time\n"
@@ -2736,7 +2719,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1306
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1297
#, no-wrap
msgid ""
";; Meta\n"
@@ -2749,7 +2732,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1327
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1318
#, no-wrap
msgid ""
";; Function keys\n"
@@ -2775,7 +2758,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1345
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1336
#, no-wrap
msgid ""
";; Keypad bindings\n"
@@ -2798,7 +2781,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:1339
#, no-wrap
msgid ""
";; Mouse\n"
@@ -2806,7 +2789,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:1343
#, no-wrap
msgid ""
";; Misc\n"
@@ -2815,7 +2798,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1357
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1348
#, no-wrap
msgid ""
";; Treat 'y' or <CR> as yes, 'n' as no.\n"
@@ -2825,7 +2808,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1361
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1352
#, no-wrap
msgid ""
";; Load packages\n"
@@ -2834,7 +2817,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:1358
#, no-wrap
msgid ""
";; Pretty diff mode\n"
@@ -2845,7 +2828,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1376
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1367
#, no-wrap
msgid ""
"(if first-time\n"
@@ -2859,7 +2842,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1381
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1372
#, no-wrap
msgid ""
";; Auto font lock mode\n"
@@ -2869,7 +2852,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1386
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1377
#, no-wrap
msgid ""
"(defvar font-lock-mode-keyword-alist\n"
@@ -2879,7 +2862,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1394
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1385
#, no-wrap
msgid ""
"(defun font-lock-auto-mode-select ()\n"
@@ -2892,13 +2875,13 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1396
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1387
#, 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:1413
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1404
#, no-wrap
msgid ""
";; New dabbrev stuff\n"
@@ -2920,7 +2903,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1425
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1416
#, no-wrap
msgid ""
";; C++ and C mode...\n"
@@ -2937,7 +2920,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1439
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1430
#, no-wrap
msgid ""
"(defun my-c-mode-hook ()\n"
@@ -2956,7 +2939,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1446
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1437
#, no-wrap
msgid ""
";; Perl mode\n"
@@ -2968,7 +2951,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1450
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1441
#, no-wrap
msgid ""
";; Scheme mode...\n"
@@ -2977,7 +2960,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1456
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1447
#, no-wrap
msgid ""
";; Emacs-Lisp mode...\n"
@@ -2988,7 +2971,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1464
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1455
#, no-wrap
msgid ""
";; Add all of the hooks...\n"
@@ -3001,7 +2984,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1470
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1461
#, no-wrap
msgid ""
";; Complement to next-error\n"
@@ -3012,7 +2995,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1483
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1474
#, no-wrap
msgid ""
";; Misc...\n"
@@ -3030,7 +3013,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:1480
#, no-wrap
msgid ""
";; Elisp archive searching\n"
@@ -3041,7 +3024,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1498
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1489
#, no-wrap
msgid ""
";; Font lock mode\n"
@@ -3055,7 +3038,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1511
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1502
#, no-wrap
msgid ""
"(if (eq window-system 'x)\n"
@@ -3073,7 +3056,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1519
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1510
#, no-wrap
msgid ""
" (setq baud-rate 1000000)\n"
@@ -3086,7 +3069,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:1527
#, no-wrap
msgid ""
";; X11 or PC using direct screen writes\n"
@@ -3108,7 +3091,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1545
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1536
#, no-wrap
msgid ""
";; TTY type terminal\n"
@@ -3122,7 +3105,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1551
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1542
#, no-wrap
msgid ""
";; Under UNIX\n"
@@ -3133,7 +3116,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:1550
#, no-wrap
msgid ""
";; Add any face changes here\n"
@@ -3146,7 +3129,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1565
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1556
#, no-wrap
msgid ""
";; Restore the \"desktop\" - do this as late as possible\n"
@@ -3157,7 +3140,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1568
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1559
#, no-wrap
msgid ""
";; Indicate that this file has been read at least once\n"
@@ -3165,19 +3148,19 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1570
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1561
#, no-wrap
msgid ";; No need to debug anything now\n"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1572
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1563
#, no-wrap
msgid "(setq debug-on-error nil)\n"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1575
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1566
#, no-wrap
msgid ""
";; All done\n"
@@ -3185,13 +3168,13 @@ msgid ""
msgstr ""
#. type: Title ===
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1578
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1569
#, no-wrap
msgid "Extending the Range of Languages Emacs Understands"
msgstr ""
#. type: delimited block = 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1581
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1572
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), "
@@ -3200,7 +3183,7 @@ msgid ""
msgstr ""
#. type: delimited block = 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1585
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1576
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 "
@@ -3209,42 +3192,42 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1589
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1580
#, 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:1593
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1584
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:1595
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1586
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:1599
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1590
#, 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:1602
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1593
msgid "we would do"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1606
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1597
#, 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:1611
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1602
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 "
@@ -3253,14 +3236,14 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1613
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1604
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:1621
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1612
#, no-wrap
msgid ""
"...\n"
@@ -3271,21 +3254,21 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1624
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1615
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:1627
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1618
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:1634
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1625
#, no-wrap
msgid ""
";; Auto font lock mode\n"
@@ -3295,14 +3278,14 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1637
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1628
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:1640
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1631
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-"
@@ -3311,66 +3294,66 @@ msgid ""
msgstr ""
#. type: Title ==
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1642
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1633
#, no-wrap
msgid "Further Reading"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1645
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1636
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:1647
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1638
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:1648
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1639
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:1649
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1640
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:1650
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1641
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:1651
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1642
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:1652
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1643
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:1653
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1644
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:1653
+#: documentation/content/en/books/developers-handbook/tools/_index.adoc:1644
msgid ""
"W. Richard Stevens _Unix Network Programming_ Prentice-Hall 1990 ISBN "
"0-13-949876-1"