diff options
author | Danilo G. Baio <dbaio@FreeBSD.org> | 2023-09-09 21:15:57 +0000 |
---|---|---|
committer | Danilo G. Baio <dbaio@FreeBSD.org> | 2023-09-09 21:15:57 +0000 |
commit | c54e4009208857f850f93f0ab3a6f3575c5edb7e (patch) | |
tree | e87f605b49d379746107c618eb784dbcb31d94e5 /documentation/content/en/books/developers-handbook/tools | |
parent | 435e67c9c3631f536256dc7da76827e2c2b78d95 (diff) |
Diffstat (limited to 'documentation/content/en/books/developers-handbook/tools')
-rw-r--r-- | documentation/content/en/books/developers-handbook/tools/_index.po | 475 |
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" |