aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorPaul Eggert2016-05-26 12:55:06 -0700
committerPaul Eggert2016-05-26 12:55:06 -0700
commit0bf5739b77c75f13d46fc49d5e3c098fe49a5070 (patch)
treed342da7bc9065197736a8184e55c9925a40f04f0 /doc
parent764f04871d67a5aad8943136d5142ed59bfa9a51 (diff)
parentc3489d050405ccb026cd44a280ead3a5f6b456d9 (diff)
downloademacs-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.texi2
-rw-r--r--doc/emacs/misc.texi9
-rw-r--r--doc/emacs/search.texi8
-rw-r--r--doc/emacs/trouble.texi2
-rw-r--r--doc/lispintro/emacs-lisp-intro.texi189
-rw-r--r--doc/misc/efaq.texi4
-rw-r--r--doc/misc/eww.texi2
-rw-r--r--doc/misc/sem-user.texi6
-rw-r--r--doc/misc/texinfo.tex56
-rw-r--r--doc/misc/url.texi4
-rw-r--r--doc/misc/vhdl-mode.texi14
-rw-r--r--doc/misc/viper.texi2
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
1285information about the @command{diff} program. 1285information 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
1635each one a unique @dfn{server name}, using the variable 1635each 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}
1637server-name @key{RET} foo @key{RET}} sets the server name to 1637server-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
1639name, using the @samp{-s} option (@pxref{emacsclient Options}). 1639name, using the @samp{-s} option (@pxref{emacsclient Options}).
1640 1640
1641 If you want to run multiple Emacs daemons (@pxref{Initial Options}),
1642you 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
1643to connect to the server from another Emacs instance and evaluate Lisp 1650to 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
1264character sequences}. 1264character 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
1269character folding in order to match equivalent character sequences. 1269character folding in order to match equivalent character sequences.
1270You can enable this behavior by customizing the variable 1270You 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
1274folding, but only for that search. (Replace commands have a different 1274folding, but only for that search. (Replace commands have a different
1275default, controlled by a separate option; see @ref{Replacement and Lax 1275default, controlled by a separate option; see @ref{Replacement and Lax
1276Matches}.) 1276Matches}.)
@@ -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
1482replace. To enable character folding for matching in 1482replace. 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
1485setting does not affect the replacement text, only how Emacs finds the 1485setting does not affect the replacement text, only how Emacs finds the
1486text to replace. It also doesn't affect @code{replace-regexp}.) 1486text 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,
1181Change Log Concepts, gnu-coding-standards, GNU Coding Standards}. 1181Change Log Concepts, standards, GNU Coding Standards}.
1182 1182
1183@item 1183@item
1184When you write the fix, keep in mind that we can't install a change that 1184When 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
4585More generally, if you want to see a function in its original source 4584More generally, if you want to see a function in its original source
4586file, you can use the @code{find-tag} function to jump to it. 4585file, 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 4586it. @code{xref-find-definitions} works with a wide variety of
4588Lisp, and C, and it works with non-programming text as well. For 4587languages, not just Lisp, and C, and it works with non-programming
4589example, @code{find-tag} will jump to the various nodes in the 4588text as well. For example, @code{xref-find-definitions} will jump to
4590Texinfo source file of this document. 4589the various nodes in the Texinfo source file of this document.
4591The @code{find-tag} function depends on @dfn{tags tables} that record 4590
4592the locations of the functions, variables, and other items to which 4591To 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 4593else type the @key{ESC} key and then type the period key), and then,
4595To use the @code{find-tag} command, type @kbd{M-.} (i.e., press the 4594at the prompt, type in the name of the function whose source code you
4596period key while holding down the @key{META} key, or else type the 4595want 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
4598type in the name of the function whose source code you want to see, 4597the function on your screen. To switch back to your current buffer,
4599such as @code{mark-whole-buffer}, and then type @key{RET}. Emacs will 4598type @kbd{C-x b @key{RET}}. (On some keyboards, the @key{META} key is
4600switch buffers and display the source code for the function on your 4599labeled @key{ALT}.)
4601screen. 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
4608Depending on how the initial default values of your copy of Emacs are
4609set, you may also need to specify the location of your tags table,
4610which is a file called @file{TAGS}. For example, if you are
4611interested in Emacs sources, the tags table you will most likely want,
4612if it has already been created for you, will be in a subdirectory of
4613the @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
4616has not already been created, you will have to create it yourself. It
4617will be in a file such as @file{/usr/local/src/emacs/src/TAGS}.
4618
4619@need 1250
4620To create a @file{TAGS} file in a specific directory, switch to that
4621directory in Emacs using @kbd{M-x cd} command, or list the directory
4622with @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
4626M-x compile RET etags *.el RET
4627@end smallexample
4628
4629For more information, see @ref{etags, , Create Your Own @file{TAGS} File}.
4630
4631After you become more familiar with Emacs Lisp, you will find that you will
4632frequently use @code{find-tag} to navigate your way around source code;
4633and you will create your own @file{TAGS} tables.
4634 4600
4635@cindex Library, as term for ``file'' 4601@cindex Library, as term for ``file''
4636Incidentally, the files that contain Lisp code are conventionally 4602Incidentally, 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
13294your sources! Without them, you are like a person who tries to drive 13259your sources! Without them, you are like a person who tries to drive
13295a car with his eyes shut!) 13260a 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
13302Besides @kbd{C-h f} (@code{describe-function}), another way to see the
13303source of a function is to type @kbd{M-.} (@code{find-tag}) and the
13304name of the function when prompted for it. This is a good habit to
13305get into. The @kbd{M-.} (@code{find-tag}) command takes you directly
13306to the source for a function, variable, or node. The function depends
13307on tags tables to tell it where to go.
13308
13309If 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
13313just told you the location that provides both my C and my Emacs Lisp
13314sources.)
13315
13316You can also create your own @file{TAGS} file for directories that
13317lack one.
13318
13319You often need to build and install tags tables yourself. They are
13320not built automatically. A tags table is called a @file{TAGS} file;
13321the name is in upper case letters.
13322
13323You can create a @file{TAGS} file by calling the @code{etags} program
13324that comes as a part of the Emacs distribution. Usually, @code{etags}
13325is compiled and installed when Emacs is built. (@code{etags} is not
13326an Emacs Lisp function or a part of Emacs; it is a C program.)
13327
13328@need 1250
13329To create a @file{TAGS} file, first switch to the directory in which
13330you 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
13332listing the directory with @kbd{C-x d} (@code{dired}). Then run the
13333compile command, with @w{@code{etags *.el}} as the command to execute
13334
13335@smallexample
13336M-x compile RET etags *.el RET
13337@end smallexample
13338
13339@noindent
13340to create a @file{TAGS} file for Emacs Lisp.
13341
13342For 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,
13344of which I load 12---you can create a @file{TAGS} file for the Emacs
13345Lisp files in that directory.
13346
13347@need 1250
13348The @code{etags} program takes all the usual shell wildcards. For
13349example, 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
13354M-x compile RET etags *.el ../elisp/*.el RET
13355@end smallexample
13356
13357@need 1250
13358Type
13359
13360@smallexample
13361M-x compile RET etags --help RET
13362@end smallexample
13363
13364@noindent
13365to see a list of the options accepted by @code{etags} as well as a
13366list of supported languages.
13367
13368The @code{etags} program handles more than 20 languages, including
13369Emacs Lisp, Common Lisp, Scheme, C, C++, Ada, Fortran, HTML, Java,
13370LaTeX, Pascal, Perl, PostScript, Python, TeX, Texinfo, makefiles, and
13371most assemblers. The program has no switches for specifying the
13372language; it recognizes the language in an input file according to its
13373file name and contents.
13374
13375@file{etags} is very helpful when you are writing code yourself and
13376want to refer back to functions you have already written. Just run
13377@code{etags} again at intervals as you write new functions, so they
13378become part of the @file{TAGS} file.
13379
13380If you think an appropriate @file{TAGS} file already exists for what
13381you want, but do not know where it is, you can use the @code{locate}
13382program to attempt to find it.
13383
13384Type @w{@kbd{M-x locate @key{RET} TAGS @key{RET}}} and Emacs will list
13385for you the full path names of all your @file{TAGS} files. On my
13386system, this command lists 34 @file{TAGS} files. On the other hand, a
13387plain vanilla system I recently installed did not contain any
13388@file{TAGS} files.
13389
13390If the tags table you want has been created, you can use the @code{M-x
13391visit-tags-table} command to specify it. Otherwise, you will need to
13392create the tag table yourself and then use @code{M-x
13393visit-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
13400The GNU Emacs sources come with a @file{Makefile} that contains a
13401sophisticated @code{etags} command that creates, collects, and merges
13402tags tables from all over the Emacs sources and puts the information
13403into 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
13407To build this @file{TAGS} file, go to the top level of your Emacs
13408source directory and run the compile command @code{make tags}:
13409
13410@smallexample
13411M-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,
13416as well as with some other source packages.)
13417
13418For more information, see @ref{Tags, , Tag Tables, emacs, The GNU Emacs
13419Manual}.
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
2292Dired mode (@kbd{M-x dired @key{RET}}, or @kbd{C-x d}) supports the 2292Dired mode (@kbd{M-x dired @key{RET}}, or @kbd{C-x d}) supports the
2293command @code{dired-do-query-replace-regexp} (@kbd{Q}), which allows 2293command @code{dired-do-find-regexp-and-replace} (@kbd{Q}), which allows
2294users to replace regular expressions in multiple files. 2294users to replace regular expressions in multiple files.
2295 2295
2296You can use this command to perform search/replace operations on 2296You can use this command to perform search/replace operations on
@@ -2315,7 +2315,7 @@ To accept all replacements in each file, hit @kbd{!}.
2315Another way to do the same thing is to use the ``tags'' feature of 2315Another way to do the same thing is to use the ``tags'' feature of
2316Emacs: it includes the command @code{tags-query-replace} which performs 2316Emacs: it includes the command @code{tags-query-replace} which performs
2317a query-replace across all the files mentioned in the @file{TAGS} file. 2317a 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
262save the partial state of its buffers (the URIs and the titles of the 262save the partial state of its buffers (the URIs and the titles of the
263pages visited) in the desktop file if one is used. @xref{Saving Emacs 263pages visited) in the desktop file if one is used. @xref{Saving Emacs
264Sessions, , emacs, The GNU Emacs Manual}. 264Sessions,,, 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
877These commands are often more accurate than the @code{find-tag} 877These commands are often more accurate than the @code{xref-find-definitions}
878command (@pxref{Tags,,,emacs,Emacs manual}), because the Semantic 878command (@pxref{Looking Up Identifiers,,,emacs,Emacs manual}), because
879Analyzer is context-sensitive. 879the Semantic Analyzer is context-sensitive.
880 880
881You can also use @kbd{C-c , j} (@code{semantic-complete-jump-local}) 881You can also use @kbd{C-c , j} (@code{semantic-complete-jump-local})
882and @kbd{C-c , J} (@code{semantic-complete-jump}) to navigate tags. 882and @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
831The secure shell protocol. @xref{Inline Methods,,, tramp, The Tramp 831The secure shell protocol. @xref{Inline methods,,, tramp, The Tramp
832Manual}. 832Manual}.
833 833
834@item scp 834@item scp
835@cindex scp 835@cindex scp
836The secure file copy protocol. @xref{External Methods,,, tramp, The 836The secure file copy protocol. @xref{External methods,,, tramp, The
837Tramp Manual}. 837Tramp 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}
484file to make the changes described in the previous section 484file 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
486manuals for more information on customizing Emacs via hooks. 486manuals 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
600institutes the new style in the current buffer. 600institutes the new style in the current buffer.
601 601
602The sample @file{.emacs} file provides a concrete example of how a new 602The sample @file{.emacs} file provides a concrete example of how a new
603style can be added and automatically set. @xref{Sample .emacs File}. 603style 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
877See the sample @file{.emacs} file @ref{Sample .emacs File} for 877See the sample @file{.emacs} file @ref{Sample Init File} for
878details. 878details.
879 879
880@end quotation 880@end quotation
@@ -894,9 +894,9 @@ either of these lists.
894The official Emacs VHDL Mode Home Page can be found at 894The 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
901Most customizations can be done using the ``Customize'' entry in the 901Most customizations can be done using the ``Customize'' entry in the
902VHDL Mode menu, which requires no editing of the .emacs file. 902VHDL 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
2569Even though these commands are sometimes useful, they are no substitute for 2569Even though these commands are sometimes useful, they are no substitute for
2570the powerful @emph{tag table} facility of Emacs. Viper's @kbd{:tag} command 2570the powerful @emph{tag table} facility of Emacs. Viper's @kbd{:tag} command
2571in a primitive interface to Emacs tags. @xref{Tags,Tags,Tags,emacs, 2571in a primitive interface to Emacs tags. @xref{Tags Tables,,,emacs,
2572The GNU Emacs Manual}, for more information on tags. 2572The GNU Emacs Manual}, for more information on tags.
2573 2573
2574The following two commands are normally bound to a mouse click and are part 2574The following two commands are normally bound to a mouse click and are part