[Emacs-diffs] /srv/bzr/emacs/emacs-24 r107919: * doc/misc/faq.texi: Convert @inforefs to @xrefs.

[Glenn Morris]

------------------------------------------------------------
revno: 107919
committer: Glenn Morris <address@hidden>
branch nick: emacs-24
timestamp: Sat 2012-04-28 11:43:55 -0700
message:
  * doc/misc/faq.texi: Convert @inforefs to @xrefs.
  Fix some malformed cross-references.
modified:
  doc/misc/ChangeLog
  doc/misc/faq.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2012-04-26 17:30:04 +0000
+++ b/doc/misc/ChangeLog        2012-04-28 18:43:55 +0000
@@ -1,3 +1,8 @@
+2012-04-28  Glenn Morris  <address@hidden>
+
+       * faq.texi: Convert @inforefs to @xrefs.
+       Fix some malformed cross-references.
+
 2012-04-26  Ippei Furuhashi  <address@hidden>  (tiny change)
 
        * org.texi (Agenda commands): Fix two typos: give corresponding

=== modified file 'doc/misc/faq.texi'
--- a/doc/misc/faq.texi 2012-04-21 00:52:08 +0000
+++ b/doc/misc/faq.texi 2012-04-28 18:43:55 +0000
@@ -195,8 +195,7 @@
 Also, on very few keyboards does @kbd{C-?} generate @acronym{ASCII} code 127.
 @c FIXME I cannot understand the previous sentence.
 
address@hidden, Keys, emacs}, for more information.  (@xref{Emacs
-manual}, for more information about Info.)
address@hidden,,, emacs, The GNU Emacs Manual}.
 
 @node Extended commands
 @section What does @file{M-x @var{command}} mean?
@@ -1338,7 +1337,7 @@
 @cindex Init file, setting up
 @cindex Customization file, setting up
 
address@hidden File, Init File, emacs}.
address@hidden File,,, emacs, The GNU Emacs Manual}.
 
 In general, new Emacs users should not be provided with @file{.emacs}
 files, because this can cause confusing non-standard behavior.  Then
@@ -1353,8 +1352,8 @@
 While Customize might indeed make it easier to configure Emacs,
 consider taking a bit of time to learn Emacs Lisp and modifying your
 @file{.emacs} directly.  Simple configuration options are described
-rather completely in @inforef{Init File, Init File, emacs}, for users
-interested in performing frequently requested, basic tasks.
+rather completely in @ref{Init File,,, emacs, The GNU Emacs Manual},
+for users interested in performing frequently requested, basic tasks.
 
 Sometimes users are unsure as to where their @file{.emacs} file should
 be found.  Visiting the file as @file{~/.emacs} from Emacs will find
@@ -1370,7 +1369,7 @@
 command takes you to a buffer listing all the available Customize
 groups.  From there, you can access all customizable options and faces,
 change their values, and save your changes to your init file.
address@hidden Customization, Easy Customization, emacs}.
address@hidden Customization,,, emacs, The GNU Emacs Manual}.
 
 If you know the name of the group in advance (e.g. ``shell''), use
 @kbd{M-x customize-group @key{RET}}.
@@ -1675,16 +1674,16 @@
 @cindex Searching for newlines
 @cindex Replacing newlines
 
-Use @kbd{C-q C-j}.  For more information, see @inforef{Special Isearch,
-Special Input for Incremental Search, emacs}.
-
+Use @kbd{C-q C-j}.  For more information,
address@hidden Isearch,, Special Input for Incremental Search, emacs,
+The GNU Emacs Manual}.
 
 @node Yanking text in isearch
 @section How do I copy text from the kill ring into the search string?
 @cindex Yanking text into the search string
 @cindex isearch yanking
 
-Use @kbd{M-y}.  @inforef{Isearch Yank, Isearch Yanking, emacs}.
+Use @kbd{M-y}.  @xref{Isearch Yank,,, emacs, The GNU Emacs Manual}.
 
 @node Wrapping words automatically
 @section How do I make Emacs wrap words for me?
@@ -2133,7 +2132,7 @@
 
 To repeat a set of commands, use keyboard macros.  Use @kbd{C-x (} and
 @kbd{C-x )} to make a keyboard macro that invokes the command and then
-type @kbd{C-x e}.  (@inforef{Keyboard Macros, Keyboard Macros, emacs}.)
+type @kbd{C-x e}.  @xref{Keyboard Macros,,, emacs, The GNU Emacs Manual}.
 
 If you're really desperate for the @code{.} command in @code{vi} that
 redoes the last insertion/deletion, use VIPER, a @code{vi} emulation
@@ -2145,7 +2144,7 @@
 @cindex X resources
 @cindex Setting X resources
 
address@hidden Resources, X Resources, emacs}.
address@hidden Resources,,, emacs, The GNU Emacs Manual}.
 
 You can also use a resource editor, such as editres (for X11R5 and
 onwards), to look at the resource names for the menu bar, assuming Emacs
@@ -2256,7 +2255,7 @@
 @cindex Suspending Emacs
 
 @kbd{C-z} iconifies Emacs when running under X and suspends Emacs
-otherwise.  @inforef{Frame Commands, Frame Commands, emacs}.
+otherwise.  @xref{Frame Commands,,, emacs, The GNU Emacs Manual}.
 
 @node Using regular expressions
 @section How do I use regexps (regular expressions) in Emacs?
@@ -2266,7 +2265,7 @@
 @cindex Unix regexps, differences from Emacs
 @cindex Text strings, putting regexps in
 
address@hidden Backslash, Regexp Backslash, emacs}.
address@hidden Backslash,,, emacs, The GNU Emacs Manual}.
 
 The @code{or} operator is @samp{\|}, not @samp{|}, and the grouping operators
 are @samp{\(} and @samp{\)}.  Also, the string syntax for a backslash is
@@ -2323,7 +2322,7 @@
 Another way to do the same thing is to use the ``tags'' feature of
 Emacs: it includes the command @code{tags-query-replace} which performs
 a query-replace across all the files mentioned in the @file{TAGS} file.
address@hidden Search, Tags Search, emacs}.
address@hidden Search,,, emacs, The GNU Emacs Manual}.
 
 @node Documentation for etags
 @section Where is the documentation for @code{etags}?
@@ -2366,8 +2365,8 @@
 @code{ls} is part of the GNU Fileutils package, available from
 @samp{ftp.gnu.org} and its mirrors (@pxref{Current GNU distributions}).
 
-To disable or change the way backups are made, @inforef{Backup Names, ,
-emacs}.
+To disable or change the way backups are made,
address@hidden Names,,, emacs, The GNU Emacs Manual}.
 
 @cindex Backup files in a single directory
 Beginning with Emacs 21.1, you can control where Emacs puts backup files
@@ -2397,8 +2396,8 @@
 package also allows you to place all auto-save files in one directory,
 such as @file{/tmp}.
 
-To disable or change how @code{auto-save-mode} works, @inforef{Auto
-Save, , emacs}.
+To disable or change how @code{auto-save-mode} works,
address@hidden Save,,, emacs, The GNU Emacs Manual}.
 
 @node Going to a line by number
 @section How can I go to a certain line given its number?
@@ -2621,7 +2620,7 @@
 Customize the @code{scroll-conservatively} variable with @kbd{M-x
 customize-variable @key{RET} scroll-conservatively @key{RET}} and set it
 to a large value like, say, 10000.  For an explanation of what this
-means, @inforef{Auto Scrolling, Auto Scrolling, emacs}.
+means, @pxref{Auto Scrolling,,, emacs, The GNU Emacs Manual}.
 
 Alternatively, use the following Lisp form in your @file{.emacs}:
 
@@ -2692,8 +2691,8 @@
 
 To avoid the slightly distracting visual effect of Emacs starting with
 its default frame size and then growing to fullscreen, you can add an
address@hidden entry to the Windows registry settings (see
address@hidden(emacs)X Resources}).
address@hidden entry to the Windows registry settings.
address@hidden Resources,,, emacs, The GNU Emacs Manual}.
 
 To compute the correct values for width and height, first maximize the
 Emacs frame and then evaluate @code{(frame-height)} and
@@ -3058,7 +3057,7 @@
 code found at the bottom of files by setting the variable
 @code{enable-local-eval}.
 
-For more information, @inforef{File Variables, File Variables, emacs}.
address@hidden Variables,,, emacs, The GNU Emacs Manual}.
 
 @item
 Synthetic X events.  (Yes, a risk; use @samp{MIT-MAGIC-COOKIE-1} or
@@ -3501,7 +3500,7 @@
 To bind a key just in the current major mode, type @kbd{M-x
 local-set-key @key{RET} @var{key} @var{cmd} @key{RET}}.
 
address@hidden Bindings, Key Bindings, emacs}, for further details.
address@hidden Bindings,,, emacs, The GNU Emacs Manual}.
 
 To make the process of binding keys interactively easier, use the
 following ``trick'': First bind the key interactively, then immediately
@@ -3766,8 +3765,8 @@
 
 However, in the specific case of @kbd{C-h} and @key{DEL}, you should
 toggle @code{normal-erase-is-backspace-mode} instead of calling
address@hidden  @inforef{DEL Does Not Delete, DEL Does Not Delete,
-emacs}.
address@hidden
address@hidden Does Not Delete,,, emacs, The GNU Emacs Manual}.
 
 Keyboard translations are not the same as key bindings in keymaps.
 Emacs contains numerous keymaps that apply in different situations, but
@@ -3895,7 +3894,7 @@
 @cindex @key{Meta} key and @code{xterm}
 @cindex Xterm and @key{Meta} key
 
address@hidden Mode, Single-Byte Character Set Support, emacs}.
address@hidden Mode,, Single-Byte Character Set Support, emacs, The GNU Emacs 
Manual}.
 
 If the advice in the Emacs manual fails, try all of these methods before
 asking for further help:
@@ -4019,8 +4018,8 @@
 @cindex Displaying eight-bit characters
 @cindex Eight-bit characters, displaying
 
address@hidden Mode, Single-byte Character Set
-Support, emacs}.  On a Unix, when Emacs runs on a text-only terminal
address@hidden Mode,, Single-byte Character Set Support, emacs, The GNU
+Emacs Manual}.  On a Unix, when Emacs runs on a text-only terminal
 display or is invoked with @samp{emacs -nw}, you typically need to use
 @code{set-terminal-coding-system} to tell Emacs what the terminal can
 display, even after setting the language environment; otherwise
@@ -4035,10 +4034,10 @@
 @cindex Eight-bit characters, entering
 @cindex Input, 8-bit characters
 
-Various methods are available for input of eight-bit characters.  See
address@hidden Mode, Single-byte Character Set
-Support, emacs}.  For more sophisticated methods, @inforef{Input
-Methods, Input Methods, emacs}.
+Various methods are available for input of eight-bit characters.
address@hidden Mode,, Single-byte Character Set Support, emacs, The GNU
+Emacs Manual}.  For more sophisticated methods,
address@hidden Methods,,, emacs, The GNU Emacs Manual}.
 
 @node Right-to-left alphabets
 @section Where is an Emacs that can handle Semitic (right-to-left) alphabets?
@@ -4377,7 +4376,7 @@
 
 Use @kbd{M-x gnus}.  For more information on Gnus, @pxref{Top,, the Gnus
 Manual, gnus, The Gnus Manual}, which includes @ref{Frequently Asked
-Questions,, the Gnus FAQ, gnus}.
+Questions,, the Gnus FAQ, gnus, The Gnus Manual}.
 
 
 @node Gnus does not work with NNTP