diff options
| author | Paul Eggert | 2016-05-26 12:55:06 -0700 |
|---|---|---|
| committer | Paul Eggert | 2016-05-26 12:55:06 -0700 |
| commit | 0bf5739b77c75f13d46fc49d5e3c098fe49a5070 (patch) | |
| tree | d342da7bc9065197736a8184e55c9925a40f04f0 /doc | |
| parent | 764f04871d67a5aad8943136d5142ed59bfa9a51 (diff) | |
| parent | c3489d050405ccb026cd44a280ead3a5f6b456d9 (diff) | |
| download | emacs-0bf5739b77c75f13d46fc49d5e3c098fe49a5070.tar.gz emacs-0bf5739b77c75f13d46fc49d5e3c098fe49a5070.zip | |
Merge from origin/emacs-25
c3489d0 * lisp/w32-fns.el (set-message-beep, w32-get-locale-info) (w3...
a4d882c Correct old cell name unbinding when renaming cell.
6c12c53 Merge branch 'emacs-25' of git.sv.gnu.org:/srv/git/emacs into...
0be6725 Document problem: slow screen refresh on missing font.
853b9b9 * admin/admin.el (add-release-logs): Basic check of existing ...
5fa80cf * build-aux/gitlog-to-emacslog: Handle empty generated Change...
3c79e51 * admin/admin.el (add-release-logs): Generate ChangeLog if ne...
42275df * doc/misc/texinfo.tex: Revert previous change (Bug#23611).
3f4a9d9 * admin/authors.el (authors): First update the ChangeLog.
897fb6f ; 'Changes from the pre-25.1 API' copyedits
825ca25 Rename vc-stay-local back to vc-cvs-stay-local
4efb3e8 * doc/emacs/files.texi (Comparing Files): * doc/emacs/trouble...
b995d1e * doc/misc/eww.texi (Advanced): Fix xref.
2e589c0 Fix cross-references between manuals
f3d2ded * doc/misc/vhdl-mode.texi (Sample Init File): Rename node to ...
906c810 ; * admin/release-process: Move etc/HISTORY from here... ; * ...
bea1b65 * admin/admin.el (add-release-logs): Also update etc/HISTORY.
503e752 ; * CONTRIBUTE: Fix a typo.
fbfd478 Avoid aborting due to errors in arguments of 'set-face-attrib...
bdfbe6d ; * admin/release-process: Copyedits.
44a6aed ; * test/automated/data-tests.el: Standardize license notice.
c33ed39 ; * test/automated/viper-tests.el: Standardize license notice.
df4a14b Add automated test for viper-tests.el
c0139e3 Fix viper undo breakage from undo-boundary changes
920d76c Fix reference to obsolete fn ps-eval-switch
18a9bc1 Do not trash symlinks to init file
2671179 Don't print the "decomposition" line for control chars in wha...
869092c Bring back xterm pasting with middle mouse
5ab0830 Provide workaround for xftfont rendering problem
c9f7ec7 * lisp/desktop.el: Disable restore frameset if in non-graphic...
30989a0 Mention GTK+ problems in etc/PROBLEMS
421e3c4 * lisp/emacs-lisp/package.el (package-refresh-contents):
dadfc30 Revert "epg: Add a way to detect gpg1 executable for tests"
e41a5cb Avoid errors with Czech and Slovak input methods
d4ae6d7 epg: Add a way to detect gpg1 executable for tests
ebc3a94 * lisp/emacs-lisp/package.el: Fix free variable warnings.
6e71295 * lisp/emacs-lisp/package.el (package--with-response-buffer):
c45d9f6 Improve documentation of 'server-name'
3b5e38c Modernize ASLR advice in etc/PROBLEMS
1fe1e0a * lisp/char-fold.el: Rename from character-fold.el.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/emacs/files.texi | 2 | ||||
| -rw-r--r-- | doc/emacs/misc.texi | 9 | ||||
| -rw-r--r-- | doc/emacs/search.texi | 8 | ||||
| -rw-r--r-- | doc/emacs/trouble.texi | 2 | ||||
| -rw-r--r-- | doc/lispintro/emacs-lisp-intro.texi | 189 | ||||
| -rw-r--r-- | doc/misc/efaq.texi | 4 | ||||
| -rw-r--r-- | doc/misc/eww.texi | 2 | ||||
| -rw-r--r-- | doc/misc/sem-user.texi | 6 | ||||
| -rw-r--r-- | doc/misc/texinfo.tex | 56 | ||||
| -rw-r--r-- | doc/misc/url.texi | 4 | ||||
| -rw-r--r-- | doc/misc/vhdl-mode.texi | 14 | ||||
| -rw-r--r-- | doc/misc/viper.texi | 2 |
12 files changed, 67 insertions, 231 deletions
diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi index af9d4d50306..ec227e9c2c9 100644 --- a/doc/emacs/files.texi +++ b/doc/emacs/files.texi | |||
| @@ -1281,7 +1281,7 @@ The value of @code{diff-switches} should be a string; the default is | |||
| 1281 | @c Note that the actual name of the info file is diffutils.info, | 1281 | @c Note that the actual name of the info file is diffutils.info, |
| 1282 | @c but it adds a dir entry for diff too. | 1282 | @c but it adds a dir entry for diff too. |
| 1283 | @c On older systems, only "info diff" works, not "info diffutils". | 1283 | @c On older systems, only "info diff" works, not "info diffutils". |
| 1284 | @xref{Top,, Diff, diff, Comparing and Merging Files}, for more | 1284 | @xref{Top,, Diff, diffutils, Comparing and Merging Files}, for more |
| 1285 | information about the @command{diff} program. | 1285 | information about the @command{diff} program. |
| 1286 | 1286 | ||
| 1287 | The output of the @code{diff} command is shown using a major mode | 1287 | The output of the @code{diff} command is shown using a major mode |
diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi index 5786bc40709..b614ed221a0 100644 --- a/doc/emacs/misc.texi +++ b/doc/emacs/misc.texi | |||
| @@ -1634,10 +1634,17 @@ variable to @samp{emacsclient +%d %s}.} | |||
| 1634 | You can run multiple Emacs servers on the same machine by giving | 1634 | You can run multiple Emacs servers on the same machine by giving |
| 1635 | each one a unique @dfn{server name}, using the variable | 1635 | each one a unique @dfn{server name}, using the variable |
| 1636 | @code{server-name}. For example, @kbd{M-x set-variable @key{RET} | 1636 | @code{server-name}. For example, @kbd{M-x set-variable @key{RET} |
| 1637 | server-name @key{RET} foo @key{RET}} sets the server name to | 1637 | server-name @key{RET} "foo" @key{RET}} sets the server name to |
| 1638 | @samp{foo}. The @code{emacsclient} program can specify a server by | 1638 | @samp{foo}. The @code{emacsclient} program can specify a server by |
| 1639 | name, using the @samp{-s} option (@pxref{emacsclient Options}). | 1639 | name, using the @samp{-s} option (@pxref{emacsclient Options}). |
| 1640 | 1640 | ||
| 1641 | If you want to run multiple Emacs daemons (@pxref{Initial Options}), | ||
| 1642 | you can give each daemon its own server name like this: | ||
| 1643 | |||
| 1644 | @example | ||
| 1645 | emacs --eval "(setq server-name \"foo\")" --daemon | ||
| 1646 | @end example | ||
| 1647 | |||
| 1641 | @findex server-eval-at | 1648 | @findex server-eval-at |
| 1642 | If you have defined a server by a unique server name, it is possible | 1649 | If you have defined a server by a unique server name, it is possible |
| 1643 | to connect to the server from another Emacs instance and evaluate Lisp | 1650 | to connect to the server from another Emacs instance and evaluate Lisp |
diff --git a/doc/emacs/search.texi b/doc/emacs/search.texi index 7958a4a2bfa..d841934c855 100644 --- a/doc/emacs/search.texi +++ b/doc/emacs/search.texi | |||
| @@ -1264,13 +1264,13 @@ but match under character folding are known as @dfn{equivalent | |||
| 1264 | character sequences}. | 1264 | character sequences}. |
| 1265 | 1265 | ||
| 1266 | @kindex M-s ' @r{(Incremental Search)} | 1266 | @kindex M-s ' @r{(Incremental Search)} |
| 1267 | @findex isearch-toggle-character-fold | 1267 | @findex isearch-toggle-char-fold |
| 1268 | Generally, search commands in Emacs do not by default perform | 1268 | Generally, search commands in Emacs do not by default perform |
| 1269 | character folding in order to match equivalent character sequences. | 1269 | character folding in order to match equivalent character sequences. |
| 1270 | You can enable this behavior by customizing the variable | 1270 | You can enable this behavior by customizing the variable |
| 1271 | @code{search-default-mode} to @code{character-fold-to-regexp}. | 1271 | @code{search-default-mode} to @code{char-fold-to-regexp}. |
| 1272 | @xref{Search Customizations}. Within an incremental search, typing | 1272 | @xref{Search Customizations}. Within an incremental search, typing |
| 1273 | @kbd{M-s '} (@code{isearch-toggle-character-fold}) toggles character | 1273 | @kbd{M-s '} (@code{isearch-toggle-char-fold}) toggles character |
| 1274 | folding, but only for that search. (Replace commands have a different | 1274 | folding, but only for that search. (Replace commands have a different |
| 1275 | default, controlled by a separate option; see @ref{Replacement and Lax | 1275 | default, controlled by a separate option; see @ref{Replacement and Lax |
| 1276 | Matches}.) | 1276 | Matches}.) |
| @@ -1481,7 +1481,7 @@ replacement is done without case conversion. | |||
| 1481 | (@pxref{Lax Search, character folding}) when looking for the text to | 1481 | (@pxref{Lax Search, character folding}) when looking for the text to |
| 1482 | replace. To enable character folding for matching in | 1482 | replace. To enable character folding for matching in |
| 1483 | @code{query-replace} and @code{replace-string}, set the variable | 1483 | @code{query-replace} and @code{replace-string}, set the variable |
| 1484 | @code{replace-character-fold} to a non-@code{nil} value. (This | 1484 | @code{replace-char-fold} to a non-@code{nil} value. (This |
| 1485 | setting does not affect the replacement text, only how Emacs finds the | 1485 | setting does not affect the replacement text, only how Emacs finds the |
| 1486 | text to replace. It also doesn't affect @code{replace-regexp}.) | 1486 | text to replace. It also doesn't affect @code{replace-regexp}.) |
| 1487 | 1487 | ||
diff --git a/doc/emacs/trouble.texi b/doc/emacs/trouble.texi index f4e3393ea9d..25f296e52c3 100644 --- a/doc/emacs/trouble.texi +++ b/doc/emacs/trouble.texi | |||
| @@ -1178,7 +1178,7 @@ see | |||
| 1178 | @url{http://www.gnu.org/prep/standards/html_node/Change-Log-Concepts.html}, | 1178 | @url{http://www.gnu.org/prep/standards/html_node/Change-Log-Concepts.html}, |
| 1179 | @end ifset | 1179 | @end ifset |
| 1180 | @xref{Change Log Concepts, Change Log Concepts, | 1180 | @xref{Change Log Concepts, Change Log Concepts, |
| 1181 | Change Log Concepts, gnu-coding-standards, GNU Coding Standards}. | 1181 | Change Log Concepts, standards, GNU Coding Standards}. |
| 1182 | 1182 | ||
| 1183 | @item | 1183 | @item |
| 1184 | When you write the fix, keep in mind that we can't install a change that | 1184 | When you write the fix, keep in mind that we can't install a change that |
diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi index eea46af6b19..10162b35467 100644 --- a/doc/lispintro/emacs-lisp-intro.texi +++ b/doc/lispintro/emacs-lisp-intro.texi | |||
| @@ -584,7 +584,6 @@ Regular Expression Searches | |||
| 584 | * re-search-forward:: Very similar to @code{search-forward}. | 584 | * re-search-forward:: Very similar to @code{search-forward}. |
| 585 | * forward-sentence:: A straightforward example of regexp search. | 585 | * forward-sentence:: A straightforward example of regexp search. |
| 586 | * forward-paragraph:: A somewhat complex example. | 586 | * forward-paragraph:: A somewhat complex example. |
| 587 | * etags:: How to create your own @file{TAGS} table. | ||
| 588 | * Regexp Review:: | 587 | * Regexp Review:: |
| 589 | * re-search Exercises:: | 588 | * re-search Exercises:: |
| 590 | 589 | ||
| @@ -4583,54 +4582,21 @@ definition. | |||
| 4583 | @end ignore | 4582 | @end ignore |
| 4584 | 4583 | ||
| 4585 | More generally, if you want to see a function in its original source | 4584 | More generally, if you want to see a function in its original source |
| 4586 | file, you can use the @code{find-tag} function to jump to it. | 4585 | file, you can use the @code{xref-find-definitions} function to jump to |
| 4587 | @code{find-tag} works with a wide variety of languages, not just | 4586 | it. @code{xref-find-definitions} works with a wide variety of |
| 4588 | Lisp, and C, and it works with non-programming text as well. For | 4587 | languages, not just Lisp, and C, and it works with non-programming |
| 4589 | example, @code{find-tag} will jump to the various nodes in the | 4588 | text as well. For example, @code{xref-find-definitions} will jump to |
| 4590 | Texinfo source file of this document. | 4589 | the various nodes in the Texinfo source file of this document. |
| 4591 | The @code{find-tag} function depends on @dfn{tags tables} that record | 4590 | |
| 4592 | the locations of the functions, variables, and other items to which | 4591 | To use the @code{xref-find-definitions} command, type @kbd{M-.} |
| 4593 | @code{find-tag} jumps. | 4592 | (i.e., press the period key while holding down the @key{META} key, or |
| 4594 | 4593 | else type the @key{ESC} key and then type the period key), and then, | |
| 4595 | To use the @code{find-tag} command, type @kbd{M-.} (i.e., press the | 4594 | at the prompt, type in the name of the function whose source code you |
| 4596 | period key while holding down the @key{META} key, or else type the | 4595 | want to see, such as @code{mark-whole-buffer}, and then type |
| 4597 | @key{ESC} key and then type the period key), and then, at the prompt, | 4596 | @key{RET}. Emacs will switch buffers and display the source code for |
| 4598 | type in the name of the function whose source code you want to see, | 4597 | the function on your screen. To switch back to your current buffer, |
| 4599 | such as @code{mark-whole-buffer}, and then type @key{RET}. Emacs will | 4598 | type @kbd{C-x b @key{RET}}. (On some keyboards, the @key{META} key is |
| 4600 | switch buffers and display the source code for the function on your | 4599 | labeled @key{ALT}.) |
| 4601 | screen. To switch back to your current buffer, type @kbd{C-x b | ||
| 4602 | @key{RET}}. (On some keyboards, the @key{META} key is labeled | ||
| 4603 | @key{ALT}.) | ||
| 4604 | |||
| 4605 | @c !!! 22.1.1 tags table location in this paragraph | ||
| 4606 | @cindex TAGS table, specifying | ||
| 4607 | @findex find-tag | ||
| 4608 | Depending on how the initial default values of your copy of Emacs are | ||
| 4609 | set, you may also need to specify the location of your tags table, | ||
| 4610 | which is a file called @file{TAGS}. For example, if you are | ||
| 4611 | interested in Emacs sources, the tags table you will most likely want, | ||
| 4612 | if it has already been created for you, will be in a subdirectory of | ||
| 4613 | the @file{/usr/local/share/emacs/} directory; thus you would use the | ||
| 4614 | @code{M-x visit-tags-table} command and specify a pathname such as | ||
| 4615 | @file{/usr/local/share/emacs/22.1.1/lisp/TAGS}. If the tags table | ||
| 4616 | has not already been created, you will have to create it yourself. It | ||
| 4617 | will be in a file such as @file{/usr/local/src/emacs/src/TAGS}. | ||
| 4618 | |||
| 4619 | @need 1250 | ||
| 4620 | To create a @file{TAGS} file in a specific directory, switch to that | ||
| 4621 | directory in Emacs using @kbd{M-x cd} command, or list the directory | ||
| 4622 | with @kbd{C-x d} (@code{dired}). Then run the compile command, with | ||
| 4623 | @w{@code{etags *.el}} as the command to execute: | ||
| 4624 | |||
| 4625 | @smallexample | ||
| 4626 | M-x compile RET etags *.el RET | ||
| 4627 | @end smallexample | ||
| 4628 | |||
| 4629 | For more information, see @ref{etags, , Create Your Own @file{TAGS} File}. | ||
| 4630 | |||
| 4631 | After you become more familiar with Emacs Lisp, you will find that you will | ||
| 4632 | frequently use @code{find-tag} to navigate your way around source code; | ||
| 4633 | and you will create your own @file{TAGS} tables. | ||
| 4634 | 4600 | ||
| 4635 | @cindex Library, as term for ``file'' | 4601 | @cindex Library, as term for ``file'' |
| 4636 | Incidentally, the files that contain Lisp code are conventionally | 4602 | Incidentally, the files that contain Lisp code are conventionally |
| @@ -12142,7 +12108,6 @@ introduces several new features. | |||
| 12142 | * re-search-forward:: Very similar to @code{search-forward}. | 12108 | * re-search-forward:: Very similar to @code{search-forward}. |
| 12143 | * forward-sentence:: A straightforward example of regexp search. | 12109 | * forward-sentence:: A straightforward example of regexp search. |
| 12144 | * forward-paragraph:: A somewhat complex example. | 12110 | * forward-paragraph:: A somewhat complex example. |
| 12145 | * etags:: How to create your own @file{TAGS} table. | ||
| 12146 | * Regexp Review:: | 12111 | * Regexp Review:: |
| 12147 | * re-search Exercises:: | 12112 | * re-search Exercises:: |
| 12148 | @end menu | 12113 | @end menu |
| @@ -13294,130 +13259,6 @@ key; you will be taken directly to the source. (Be sure to install | |||
| 13294 | your sources! Without them, you are like a person who tries to drive | 13259 | your sources! Without them, you are like a person who tries to drive |
| 13295 | a car with his eyes shut!) | 13260 | a car with his eyes shut!) |
| 13296 | 13261 | ||
| 13297 | @node etags | ||
| 13298 | @section Create Your Own @file{TAGS} File | ||
| 13299 | @findex etags | ||
| 13300 | @cindex @file{TAGS} file, create own | ||
| 13301 | |||
| 13302 | Besides @kbd{C-h f} (@code{describe-function}), another way to see the | ||
| 13303 | source of a function is to type @kbd{M-.} (@code{find-tag}) and the | ||
| 13304 | name of the function when prompted for it. This is a good habit to | ||
| 13305 | get into. The @kbd{M-.} (@code{find-tag}) command takes you directly | ||
| 13306 | to the source for a function, variable, or node. The function depends | ||
| 13307 | on tags tables to tell it where to go. | ||
| 13308 | |||
| 13309 | If the @code{find-tag} function first asks you for the name of a | ||
| 13310 | @file{TAGS} table, give it the name of a @file{TAGS} file such as | ||
| 13311 | @file{/usr/local/src/emacs/src/TAGS}. (The exact path to your | ||
| 13312 | @file{TAGS} file depends on how your copy of Emacs was installed. I | ||
| 13313 | just told you the location that provides both my C and my Emacs Lisp | ||
| 13314 | sources.) | ||
| 13315 | |||
| 13316 | You can also create your own @file{TAGS} file for directories that | ||
| 13317 | lack one. | ||
| 13318 | |||
| 13319 | You often need to build and install tags tables yourself. They are | ||
| 13320 | not built automatically. A tags table is called a @file{TAGS} file; | ||
| 13321 | the name is in upper case letters. | ||
| 13322 | |||
| 13323 | You can create a @file{TAGS} file by calling the @code{etags} program | ||
| 13324 | that comes as a part of the Emacs distribution. Usually, @code{etags} | ||
| 13325 | is compiled and installed when Emacs is built. (@code{etags} is not | ||
| 13326 | an Emacs Lisp function or a part of Emacs; it is a C program.) | ||
| 13327 | |||
| 13328 | @need 1250 | ||
| 13329 | To create a @file{TAGS} file, first switch to the directory in which | ||
| 13330 | you want to create the file. In Emacs you can do this with the | ||
| 13331 | @kbd{M-x cd} command, or by visiting a file in the directory, or by | ||
| 13332 | listing the directory with @kbd{C-x d} (@code{dired}). Then run the | ||
| 13333 | compile command, with @w{@code{etags *.el}} as the command to execute | ||
| 13334 | |||
| 13335 | @smallexample | ||
| 13336 | M-x compile RET etags *.el RET | ||
| 13337 | @end smallexample | ||
| 13338 | |||
| 13339 | @noindent | ||
| 13340 | to create a @file{TAGS} file for Emacs Lisp. | ||
| 13341 | |||
| 13342 | For example, if you have a large number of files in your | ||
| 13343 | @file{~/emacs} directory, as I do---I have 137 @file{.el} files in it, | ||
| 13344 | of which I load 12---you can create a @file{TAGS} file for the Emacs | ||
| 13345 | Lisp files in that directory. | ||
| 13346 | |||
| 13347 | @need 1250 | ||
| 13348 | The @code{etags} program takes all the usual shell wildcards. For | ||
| 13349 | example, if you have two directories for which you want a single | ||
| 13350 | @file{TAGS} file, type @w{@code{etags *.el ../elisp/*.el}}, where | ||
| 13351 | @file{../elisp/} is the second directory: | ||
| 13352 | |||
| 13353 | @smallexample | ||
| 13354 | M-x compile RET etags *.el ../elisp/*.el RET | ||
| 13355 | @end smallexample | ||
| 13356 | |||
| 13357 | @need 1250 | ||
| 13358 | Type | ||
| 13359 | |||
| 13360 | @smallexample | ||
| 13361 | M-x compile RET etags --help RET | ||
| 13362 | @end smallexample | ||
| 13363 | |||
| 13364 | @noindent | ||
| 13365 | to see a list of the options accepted by @code{etags} as well as a | ||
| 13366 | list of supported languages. | ||
| 13367 | |||
| 13368 | The @code{etags} program handles more than 20 languages, including | ||
| 13369 | Emacs Lisp, Common Lisp, Scheme, C, C++, Ada, Fortran, HTML, Java, | ||
| 13370 | LaTeX, Pascal, Perl, PostScript, Python, TeX, Texinfo, makefiles, and | ||
| 13371 | most assemblers. The program has no switches for specifying the | ||
| 13372 | language; it recognizes the language in an input file according to its | ||
| 13373 | file name and contents. | ||
| 13374 | |||
| 13375 | @file{etags} is very helpful when you are writing code yourself and | ||
| 13376 | want to refer back to functions you have already written. Just run | ||
| 13377 | @code{etags} again at intervals as you write new functions, so they | ||
| 13378 | become part of the @file{TAGS} file. | ||
| 13379 | |||
| 13380 | If you think an appropriate @file{TAGS} file already exists for what | ||
| 13381 | you want, but do not know where it is, you can use the @code{locate} | ||
| 13382 | program to attempt to find it. | ||
| 13383 | |||
| 13384 | Type @w{@kbd{M-x locate @key{RET} TAGS @key{RET}}} and Emacs will list | ||
| 13385 | for you the full path names of all your @file{TAGS} files. On my | ||
| 13386 | system, this command lists 34 @file{TAGS} files. On the other hand, a | ||
| 13387 | plain vanilla system I recently installed did not contain any | ||
| 13388 | @file{TAGS} files. | ||
| 13389 | |||
| 13390 | If the tags table you want has been created, you can use the @code{M-x | ||
| 13391 | visit-tags-table} command to specify it. Otherwise, you will need to | ||
| 13392 | create the tag table yourself and then use @code{M-x | ||
| 13393 | visit-tags-table}. | ||
| 13394 | |||
| 13395 | @subsubheading Building Tags in the Emacs sources | ||
| 13396 | @cindex Building Tags in the Emacs sources | ||
| 13397 | @cindex Tags in the Emacs sources | ||
| 13398 | @findex make tags | ||
| 13399 | |||
| 13400 | The GNU Emacs sources come with a @file{Makefile} that contains a | ||
| 13401 | sophisticated @code{etags} command that creates, collects, and merges | ||
| 13402 | tags tables from all over the Emacs sources and puts the information | ||
| 13403 | into one @file{TAGS} file in the @file{src/} directory. (The | ||
| 13404 | @file{src/} directory is below the top level of your Emacs directory.) | ||
| 13405 | |||
| 13406 | @need 1250 | ||
| 13407 | To build this @file{TAGS} file, go to the top level of your Emacs | ||
| 13408 | source directory and run the compile command @code{make tags}: | ||
| 13409 | |||
| 13410 | @smallexample | ||
| 13411 | M-x compile RET make tags RET | ||
| 13412 | @end smallexample | ||
| 13413 | |||
| 13414 | @noindent | ||
| 13415 | (The @code{make tags} command works well with the GNU Emacs sources, | ||
| 13416 | as well as with some other source packages.) | ||
| 13417 | |||
| 13418 | For more information, see @ref{Tags, , Tag Tables, emacs, The GNU Emacs | ||
| 13419 | Manual}. | ||
| 13420 | |||
| 13421 | @node Regexp Review | 13262 | @node Regexp Review |
| 13422 | @section Review | 13263 | @section Review |
| 13423 | 13264 | ||
diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi index fd4fd4f3798..8eee9e1d869 100644 --- a/doc/misc/efaq.texi +++ b/doc/misc/efaq.texi | |||
| @@ -2290,7 +2290,7 @@ is actually typical for regexp syntax.) | |||
| 2290 | @cindex Recursive search/replace operations | 2290 | @cindex Recursive search/replace operations |
| 2291 | 2291 | ||
| 2292 | Dired mode (@kbd{M-x dired @key{RET}}, or @kbd{C-x d}) supports the | 2292 | Dired mode (@kbd{M-x dired @key{RET}}, or @kbd{C-x d}) supports the |
| 2293 | command @code{dired-do-query-replace-regexp} (@kbd{Q}), which allows | 2293 | command @code{dired-do-find-regexp-and-replace} (@kbd{Q}), which allows |
| 2294 | users to replace regular expressions in multiple files. | 2294 | users to replace regular expressions in multiple files. |
| 2295 | 2295 | ||
| 2296 | You can use this command to perform search/replace operations on | 2296 | You can use this command to perform search/replace operations on |
| @@ -2315,7 +2315,7 @@ To accept all replacements in each file, hit @kbd{!}. | |||
| 2315 | Another way to do the same thing is to use the ``tags'' feature of | 2315 | Another way to do the same thing is to use the ``tags'' feature of |
| 2316 | Emacs: it includes the command @code{tags-query-replace} which performs | 2316 | Emacs: it includes the command @code{tags-query-replace} which performs |
| 2317 | a query-replace across all the files mentioned in the @file{TAGS} file. | 2317 | a query-replace across all the files mentioned in the @file{TAGS} file. |
| 2318 | @xref{Tags Search,,, emacs, The GNU Emacs Manual}. | 2318 | @xref{Identifier Search,,, emacs, The GNU Emacs Manual}. |
| 2319 | 2319 | ||
| 2320 | @node Documentation for etags | 2320 | @node Documentation for etags |
| 2321 | @section Where is the documentation for @code{etags}? | 2321 | @section Where is the documentation for @code{etags}? |
diff --git a/doc/misc/eww.texi b/doc/misc/eww.texi index f15e2f2518e..81f97a9db85 100644 --- a/doc/misc/eww.texi +++ b/doc/misc/eww.texi | |||
| @@ -261,7 +261,7 @@ variables @code{shr-color-visible-distance-min} and | |||
| 261 | In addition to maintaining the history at run-time, EWW will also | 261 | In addition to maintaining the history at run-time, EWW will also |
| 262 | save the partial state of its buffers (the URIs and the titles of the | 262 | save the partial state of its buffers (the URIs and the titles of the |
| 263 | pages visited) in the desktop file if one is used. @xref{Saving Emacs | 263 | pages visited) in the desktop file if one is used. @xref{Saving Emacs |
| 264 | Sessions, , emacs, The GNU Emacs Manual}. | 264 | Sessions,,, emacs, The GNU Emacs Manual}. |
| 265 | 265 | ||
| 266 | @vindex eww-desktop-remove-duplicates | 266 | @vindex eww-desktop-remove-duplicates |
| 267 | EWW history may sensibly contain multiple entries for the same page | 267 | EWW history may sensibly contain multiple entries for the same page |
diff --git a/doc/misc/sem-user.texi b/doc/misc/sem-user.texi index a8684a40b3a..fd88c88c7eb 100644 --- a/doc/misc/sem-user.texi +++ b/doc/misc/sem-user.texi | |||
| @@ -874,9 +874,9 @@ command, like this: | |||
| 874 | @end example | 874 | @end example |
| 875 | @end defun | 875 | @end defun |
| 876 | 876 | ||
| 877 | These commands are often more accurate than the @code{find-tag} | 877 | These commands are often more accurate than the @code{xref-find-definitions} |
| 878 | command (@pxref{Tags,,,emacs,Emacs manual}), because the Semantic | 878 | command (@pxref{Looking Up Identifiers,,,emacs,Emacs manual}), because |
| 879 | Analyzer is context-sensitive. | 879 | the Semantic Analyzer is context-sensitive. |
| 880 | 880 | ||
| 881 | You can also use @kbd{C-c , j} (@code{semantic-complete-jump-local}) | 881 | You can also use @kbd{C-c , j} (@code{semantic-complete-jump-local}) |
| 882 | and @kbd{C-c , J} (@code{semantic-complete-jump}) to navigate tags. | 882 | and @kbd{C-c , J} (@code{semantic-complete-jump}) to navigate tags. |
diff --git a/doc/misc/texinfo.tex b/doc/misc/texinfo.tex index 314063cafe1..37e2de896ec 100644 --- a/doc/misc/texinfo.tex +++ b/doc/misc/texinfo.tex | |||
| @@ -3,7 +3,7 @@ | |||
| 3 | % Load plain if necessary, i.e., if running under initex. | 3 | % Load plain if necessary, i.e., if running under initex. |
| 4 | \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi | 4 | \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi |
| 5 | % | 5 | % |
| 6 | \def\texinfoversion{2016-05-07.20} | 6 | \def\texinfoversion{2016-04-14.07} |
| 7 | % | 7 | % |
| 8 | % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995, | 8 | % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995, |
| 9 | % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, | 9 | % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, |
| @@ -67,10 +67,6 @@ | |||
| 67 | \everyjob{\message{[Texinfo version \texinfoversion]}% | 67 | \everyjob{\message{[Texinfo version \texinfoversion]}% |
| 68 | \catcode`+=\active \catcode`\_=\active} | 68 | \catcode`+=\active \catcode`\_=\active} |
| 69 | 69 | ||
| 70 | % LaTeX's \typeout. This ensures that the messages it is used for | ||
| 71 | % are identical in format to the corresponding ones from latex/pdflatex. | ||
| 72 | \def\typeout{\immediate\write17}% | ||
| 73 | |||
| 74 | \chardef\other=12 | 70 | \chardef\other=12 |
| 75 | 71 | ||
| 76 | % We never want plain's \outer definition of \+ in Texinfo. | 72 | % We never want plain's \outer definition of \+ in Texinfo. |
| @@ -1538,6 +1534,7 @@ output) for that.)} | |||
| 1538 | % | 1534 | % |
| 1539 | % PDF outline support | 1535 | % PDF outline support |
| 1540 | % | 1536 | % |
| 1537 | \pdfmakepagedesttrue \relax | ||
| 1541 | % Emulate the primitive of pdfTeX | 1538 | % Emulate the primitive of pdfTeX |
| 1542 | \def\pdfdest name#1 xyz{% | 1539 | \def\pdfdest name#1 xyz{% |
| 1543 | \special{pdf:dest (name#1) [@thispage /XYZ @xpos @ypos]}% | 1540 | \special{pdf:dest (name#1) [@thispage /XYZ @xpos @ypos]}% |
| @@ -3273,8 +3270,8 @@ end | |||
| 3273 | % @{ @} @lbracechar{} @rbracechar{} all generate brace characters. | 3270 | % @{ @} @lbracechar{} @rbracechar{} all generate brace characters. |
| 3274 | % Unless we're in typewriter, use \ecfont because the CM text fonts do | 3271 | % Unless we're in typewriter, use \ecfont because the CM text fonts do |
| 3275 | % not have braces, and we don't want to switch into math. | 3272 | % not have braces, and we don't want to switch into math. |
| 3276 | \def\mylbrace{{\ifmonospace\char123\else\ensuremath\lbrace\fi}} | 3273 | \def\mylbrace{{\ifmonospace\else\ecfont\fi \char123}} |
| 3277 | \def\myrbrace{{\ifmonospace\char125\else\ensuremath\rbrace\fi}} | 3274 | \def\myrbrace{{\ifmonospace\else\ecfont\fi \char125}} |
| 3278 | \let\{=\mylbrace \let\lbracechar=\{ | 3275 | \let\{=\mylbrace \let\lbracechar=\{ |
| 3279 | \let\}=\myrbrace \let\rbracechar=\} | 3276 | \let\}=\myrbrace \let\rbracechar=\} |
| 3280 | \begingroup | 3277 | \begingroup |
| @@ -4756,7 +4753,7 @@ end | |||
| 4756 | \def\docodeindex#1{\edef\indexname{#1}\parsearg\docodeindexxxx} | 4753 | \def\docodeindex#1{\edef\indexname{#1}\parsearg\docodeindexxxx} |
| 4757 | \def\docodeindexxxx #1{\doind{\indexname}{\code{#1}}} | 4754 | \def\docodeindexxxx #1{\doind{\indexname}{\code{#1}}} |
| 4758 | 4755 | ||
| 4759 | % Used when writing an index entry out to an index file to prevent | 4756 | % Used when writing an index entry out to an index file, to prevent |
| 4760 | % expansion of Texinfo commands that can appear in an index entry. | 4757 | % expansion of Texinfo commands that can appear in an index entry. |
| 4761 | % | 4758 | % |
| 4762 | \def\indexdummies{% | 4759 | \def\indexdummies{% |
| @@ -4892,9 +4889,12 @@ end | |||
| 4892 | % | 4889 | % |
| 4893 | % We want to disable all macros so that they are not expanded by \write. | 4890 | % We want to disable all macros so that they are not expanded by \write. |
| 4894 | \macrolist | 4891 | \macrolist |
| 4895 | \definedummyword\value | ||
| 4896 | % | 4892 | % |
| 4897 | \normalturnoffactive | 4893 | \normalturnoffactive |
| 4894 | % | ||
| 4895 | % Handle some cases of @value -- where it does not contain any | ||
| 4896 | % (non-fully-expandable) commands. | ||
| 4897 | \makevalueexpandable | ||
| 4898 | } | 4898 | } |
| 4899 | 4899 | ||
| 4900 | % \commondummiesnofonts: common to \commondummies and \indexnofonts. | 4900 | % \commondummiesnofonts: common to \commondummies and \indexnofonts. |
| @@ -5159,10 +5159,9 @@ end | |||
| 5159 | \ifx\suffix\indexisfl\def\suffix{f1}\fi | 5159 | \ifx\suffix\indexisfl\def\suffix{f1}\fi |
| 5160 | % Open the file | 5160 | % Open the file |
| 5161 | \immediate\openout\csname#1indfile\endcsname \jobname.\suffix | 5161 | \immediate\openout\csname#1indfile\endcsname \jobname.\suffix |
| 5162 | % Using \immediate above here prevents an object entering into the current | 5162 | % Using \immediate here prevents an object entering into the current box, |
| 5163 | % box, which could confound checks such as those in \safewhatsit for | 5163 | % which could confound checks such as those in \safewhatsit for preceding |
| 5164 | % preceding skips. | 5164 | % skips. |
| 5165 | \typeout{Writing index file \jobname.\suffix}% | ||
| 5166 | \fi} | 5165 | \fi} |
| 5167 | \def\indexisfl{fl} | 5166 | \def\indexisfl{fl} |
| 5168 | 5167 | ||
| @@ -5370,7 +5369,6 @@ end | |||
| 5370 | % index. The easiest way to prevent this problem is to make sure | 5369 | % index. The easiest way to prevent this problem is to make sure |
| 5371 | % there is some text. | 5370 | % there is some text. |
| 5372 | \putwordIndexNonexistent | 5371 | \putwordIndexNonexistent |
| 5373 | \typeout{No file \jobname.\indexname s.}% | ||
| 5374 | \else | 5372 | \else |
| 5375 | \catcode`\\ = 0 | 5373 | \catcode`\\ = 0 |
| 5376 | % | 5374 | % |
| @@ -6684,14 +6682,7 @@ end | |||
| 6684 | % 1 and 2 (the page numbers aren't printed), and so are the first | 6682 | % 1 and 2 (the page numbers aren't printed), and so are the first |
| 6685 | % two pages of the document. Thus, we'd have two destinations named | 6683 | % two pages of the document. Thus, we'd have two destinations named |
| 6686 | % `1', and two named `2'. | 6684 | % `1', and two named `2'. |
| 6687 | \ifpdf | 6685 | \ifpdf \global\pdfmakepagedesttrue \fi |
| 6688 | \global\pdfmakepagedesttrue | ||
| 6689 | \else | ||
| 6690 | \ifx\XeTeXrevision\thisisundefined | ||
| 6691 | \else | ||
| 6692 | \global\pdfmakepagedesttrue | ||
| 6693 | \fi | ||
| 6694 | \fi | ||
| 6695 | } | 6686 | } |
| 6696 | 6687 | ||
| 6697 | 6688 | ||
| @@ -8871,7 +8862,6 @@ end | |||
| 8871 | % include an _ in the xref name, etc. | 8862 | % include an _ in the xref name, etc. |
| 8872 | \indexnofonts | 8863 | \indexnofonts |
| 8873 | \turnoffactive | 8864 | \turnoffactive |
| 8874 | \def\value##1{##1}% | ||
| 8875 | \expandafter\global\expandafter\let\expandafter\Xthisreftitle | 8865 | \expandafter\global\expandafter\let\expandafter\Xthisreftitle |
| 8876 | \csname XR#1-title\endcsname | 8866 | \csname XR#1-title\endcsname |
| 8877 | }% | 8867 | }% |
| @@ -9012,14 +9002,14 @@ end | |||
| 9012 | \fi\fi\fi | 9002 | \fi\fi\fi |
| 9013 | } | 9003 | } |
| 9014 | 9004 | ||
| 9015 | % \refx{NAME}{SUFFIX} - reference a cross-reference string named NAME. SUFFIX | 9005 | % Define \refx{NAME}{SUFFIX} to reference a cross-reference string named NAME. |
| 9016 | % is output afterwards if non-empty. | 9006 | % If its value is nonempty, SUFFIX is output afterward. |
| 9007 | % | ||
| 9017 | \def\refx#1#2{% | 9008 | \def\refx#1#2{% |
| 9018 | \requireauxfile | 9009 | \requireauxfile |
| 9019 | {% | 9010 | {% |
| 9020 | \indexnofonts | 9011 | \indexnofonts |
| 9021 | \otherbackslash | 9012 | \otherbackslash |
| 9022 | \def\value##1{##1}% | ||
| 9023 | \expandafter\global\expandafter\let\expandafter\thisrefX | 9013 | \expandafter\global\expandafter\let\expandafter\thisrefX |
| 9024 | \csname XR#1\endcsname | 9014 | \csname XR#1\endcsname |
| 9025 | }% | 9015 | }% |
| @@ -9044,18 +9034,16 @@ end | |||
| 9044 | #2% Output the suffix in any case. | 9034 | #2% Output the suffix in any case. |
| 9045 | } | 9035 | } |
| 9046 | 9036 | ||
| 9047 | % This is the macro invoked by entries in the aux file. Define a control | 9037 | % This is the macro invoked by entries in the aux file. Usually it's |
| 9048 | % sequence for a cross-reference target (we prepend XR to the control sequence | 9038 | % just a \def (we prepend XR to the control sequence name to avoid |
| 9049 | % name to avoid collisions). The value is the page number. If this is a float | 9039 | % collisions). But if this is a float type, we have more work to do. |
| 9050 | % type, we have more work to do. | ||
| 9051 | % | 9040 | % |
| 9052 | \def\xrdef#1#2{% | 9041 | \def\xrdef#1#2{% |
| 9053 | {% Expand the node or anchor name to remove control sequences. | 9042 | {% The node name might contain 8-bit characters, which in our current |
| 9054 | % \turnoffactive stops 8-bit characters being changed to commands | 9043 | % implementation are changed to commands like @'e. Don't let these |
| 9055 | % like @'e. \refx does the same to retrieve the value in the definition. | 9044 | % mess up the control sequence name. |
| 9056 | \indexnofonts | 9045 | \indexnofonts |
| 9057 | \turnoffactive | 9046 | \turnoffactive |
| 9058 | \def\value##1{##1}% | ||
| 9059 | \xdef\safexrefname{#1}% | 9047 | \xdef\safexrefname{#1}% |
| 9060 | }% | 9048 | }% |
| 9061 | % | 9049 | % |
diff --git a/doc/misc/url.texi b/doc/misc/url.texi index 097f626e718..06d2e559c38 100644 --- a/doc/misc/url.texi +++ b/doc/misc/url.texi | |||
| @@ -828,12 +828,12 @@ The file transfer protocol. @xref{file/ftp}. | |||
| 828 | 828 | ||
| 829 | @item ssh | 829 | @item ssh |
| 830 | @cindex ssh | 830 | @cindex ssh |
| 831 | The secure shell protocol. @xref{Inline Methods,,, tramp, The Tramp | 831 | The secure shell protocol. @xref{Inline methods,,, tramp, The Tramp |
| 832 | Manual}. | 832 | Manual}. |
| 833 | 833 | ||
| 834 | @item scp | 834 | @item scp |
| 835 | @cindex scp | 835 | @cindex scp |
| 836 | The secure file copy protocol. @xref{External Methods,,, tramp, The | 836 | The secure file copy protocol. @xref{External methods,,, tramp, The |
| 837 | Tramp Manual}. | 837 | Tramp Manual}. |
| 838 | 838 | ||
| 839 | @item rsync | 839 | @item rsync |
diff --git a/doc/misc/vhdl-mode.texi b/doc/misc/vhdl-mode.texi index ec83b7e62ee..e26ec5277c0 100644 --- a/doc/misc/vhdl-mode.texi +++ b/doc/misc/vhdl-mode.texi | |||
| @@ -65,7 +65,7 @@ modify this GNU manual.'' | |||
| 65 | * Syntactic Symbols:: | 65 | * Syntactic Symbols:: |
| 66 | * Frequently Asked Questions:: | 66 | * Frequently Asked Questions:: |
| 67 | * Getting the latest VHDL Mode release:: | 67 | * Getting the latest VHDL Mode release:: |
| 68 | * Sample .emacs File:: | 68 | * Sample Init File:: |
| 69 | * Limitations and Known Bugs:: | 69 | * Limitations and Known Bugs:: |
| 70 | * Mailing Lists and Submitting Bug Reports:: | 70 | * Mailing Lists and Submitting Bug Reports:: |
| 71 | * GNU Free Documentation License:: The license for this documentation. | 71 | * GNU Free Documentation License:: The license for this documentation. |
| @@ -484,7 +484,7 @@ Here's a simplified example of what you can add to your @file{.emacs} | |||
| 484 | file to make the changes described in the previous section | 484 | file to make the changes described in the previous section |
| 485 | (@ref{Interactive Customization}) more permanent. See the Emacs | 485 | (@ref{Interactive Customization}) more permanent. See the Emacs |
| 486 | manuals for more information on customizing Emacs via hooks. | 486 | manuals for more information on customizing Emacs via hooks. |
| 487 | @xref{Sample .emacs File}, for a more complete sample @file{.emacs} file. | 487 | @xref{Sample Init File}, for a more complete sample @file{.emacs} file. |
| 488 | 488 | ||
| 489 | @example | 489 | @example |
| 490 | @group | 490 | @group |
| @@ -600,7 +600,7 @@ optional third argument, which if non-@code{nil}, automatically | |||
| 600 | institutes the new style in the current buffer. | 600 | institutes the new style in the current buffer. |
| 601 | 601 | ||
| 602 | The sample @file{.emacs} file provides a concrete example of how a new | 602 | The sample @file{.emacs} file provides a concrete example of how a new |
| 603 | style can be added and automatically set. @xref{Sample .emacs File}. | 603 | style can be added and automatically set. @xref{Sample Init File}. |
| 604 | 604 | ||
| 605 | @node File Styles | 605 | @node File Styles |
| 606 | @subsection File Styles | 606 | @subsection File Styles |
| @@ -874,7 +874,7 @@ simply add the following to the top of your @file{.emacs} file: | |||
| 874 | 874 | ||
| 875 | @end example | 875 | @end example |
| 876 | 876 | ||
| 877 | See the sample @file{.emacs} file @ref{Sample .emacs File} for | 877 | See the sample @file{.emacs} file @ref{Sample Init File} for |
| 878 | details. | 878 | details. |
| 879 | 879 | ||
| 880 | @end quotation | 880 | @end quotation |
| @@ -894,9 +894,9 @@ either of these lists. | |||
| 894 | The official Emacs VHDL Mode Home Page can be found at | 894 | The official Emacs VHDL Mode Home Page can be found at |
| 895 | @uref{http://www.iis.ee.ethz.ch/~zimmi/emacs/vhdl-mode.html}. | 895 | @uref{http://www.iis.ee.ethz.ch/~zimmi/emacs/vhdl-mode.html}. |
| 896 | 896 | ||
| 897 | @node Sample .emacs File | 897 | @node Sample Init File |
| 898 | @chapter Sample @file{.emacs} file | 898 | @chapter Sample Init File |
| 899 | @cindex Sample @file{.emacs} file | 899 | @cindex Sample init file |
| 900 | 900 | ||
| 901 | Most customizations can be done using the ``Customize'' entry in the | 901 | Most customizations can be done using the ``Customize'' entry in the |
| 902 | VHDL Mode menu, which requires no editing of the .emacs file. | 902 | VHDL Mode menu, which requires no editing of the .emacs file. |
diff --git a/doc/misc/viper.texi b/doc/misc/viper.texi index 6b169f3c8e6..6b82653c629 100644 --- a/doc/misc/viper.texi +++ b/doc/misc/viper.texi | |||
| @@ -2568,7 +2568,7 @@ above block should be commented out. | |||
| 2568 | 2568 | ||
| 2569 | Even though these commands are sometimes useful, they are no substitute for | 2569 | Even though these commands are sometimes useful, they are no substitute for |
| 2570 | the powerful @emph{tag table} facility of Emacs. Viper's @kbd{:tag} command | 2570 | the powerful @emph{tag table} facility of Emacs. Viper's @kbd{:tag} command |
| 2571 | in a primitive interface to Emacs tags. @xref{Tags,Tags,Tags,emacs, | 2571 | in a primitive interface to Emacs tags. @xref{Tags Tables,,,emacs, |
| 2572 | The GNU Emacs Manual}, for more information on tags. | 2572 | The GNU Emacs Manual}, for more information on tags. |
| 2573 | 2573 | ||
| 2574 | The following two commands are normally bound to a mouse click and are part | 2574 | The following two commands are normally bound to a mouse click and are part |