texinfo ChangeLog doc/info-stnd.texi

[karl]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     karl <karl>     13/01/20 18:04:48

Modified files:
        .              : ChangeLog 
        doc            : info-stnd.texi 

Log message:
        @t in node names, reduce footnotes

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1525&r2=1.1526
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/info-stnd.texi?cvsroot=texinfo&r1=1.37&r2=1.38

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1525
retrieving revision 1.1526
diff -u -b -r1.1525 -r1.1526
--- ChangeLog   19 Jan 2013 21:12:08 -0000      1.1525
+++ ChangeLog   20 Jan 2013 18:04:48 -0000      1.1526
@@ -1,3 +1,8 @@
+2013-01-20  Karl Berry  <address@hidden>
+
+       * doc/info-stnd.texi: @t in node names, merge footnote text
+       where reasonable.
+
 2013-01-19  Patrice Dumas  <address@hidden>
 
        * util/texinfo.dtd: add number attribute for float and indexterm.

Index: doc/info-stnd.texi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/info-stnd.texi,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -b -r1.37 -r1.38
--- doc/info-stnd.texi  17 Apr 2012 18:23:25 -0000      1.37
+++ doc/info-stnd.texi  20 Jan 2013 18:04:48 -0000      1.38
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: info-stnd.texi,v 1.37 2012/04/17 18:23:25 karl Exp $
address@hidden $Id: info-stnd.texi,v 1.38 2013/01/20 18:04:48 karl Exp $
 @c We must \input texinfo.tex instead of texinfo, otherwise make
 @c distcheck in the Texinfo distribution fails, because the texinfo Info
 @c file is made first, and texi2dvi must include . first in the path.
@@ -18,7 +18,7 @@
 (usually created from Texinfo source files).
 
 Copyright @copyright{} 1992, 1993, 1996, 1997, 1998, 1999, 2001, 2002,
-2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012 Free Software
+2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 Free Software
 Foundation, Inc.
 
 @quotation
@@ -51,6 +51,7 @@
 @title Stand-alone GNU Info
 @subtitle for version @value{VERSION}, @value{UPDATED}
 @author Brian J. Fox
address@hidden and Texinfo maintainers
 @page
 @vskip 0pt plus 1filll
 @insertcopying
@@ -85,8 +86,7 @@
 * Miscellaneous Commands::      A few commands that defy categorization.
 * Variables::                   How to change the default behavior of Info.
 * Custom Key Bindings::         How to define your own key-to-command bindings.
-* Index::                       Global index with keystrokes, command names,
-                                  variable names, and general concepts.
+* Index::                       Global index.
 @end menu
 
 
@@ -117,9 +117,9 @@
 works in the stand-alone Info reader.)
 
 @cindex bugs, reporting
-Please report bugs in this Info program to
address@hidden@@gnu.org}.  (Bugs in the Emacs Info reader should
-be sent to @email{bug-gnu-emacs@@gnu.org}.)
+Please report bugs in this stand-alone Info program to
address@hidden@@gnu.org}.  Bugs in the Emacs Info reader should be
+sent to @email{bug-gnu-emacs@@gnu.org}.
 
 
 @node Invoking Info
@@ -131,10 +131,9 @@
 @cindex options, command line
 @cindex arguments, command line
 
-GNU Info 
-accepts several options to control the initial node being
-viewed, and to specify which directories to search for Info files.  Here
-is a template showing an invocation of GNU Info from the shell:
+GNU Info accepts several options to control the initial node being
+viewed, and to specify which directories to search for Info files.
+Here is a template showing an invocation of GNU Info from the shell:
 
 @example
 info address@hidden@dots{} address@hidden@dots{}]
@@ -214,10 +213,10 @@
 @cindex files, compressed
 @cindex Info files, compressed
 In every directory Info tries, if @var{filename} is not found, Info
-looks for it with a number of known extensions of Info address@hidden
address@hidden, @file{-info}, @file{/index}, and @file{.inf}.}.  For
-every known extension, Info looks for a compressed file, if a regular
-file isn't found.  Info supports files compressed with @code{gzip},
+looks for it with a number of known extensions of Info files, namely
address@hidden, @file{-info}, @file{/index}, and @file{.inf}.  For every
+known extension, Info looks for a compressed file, if a regular file
+isn't found.  Info supports files compressed with @code{gzip},
 @code{xz}, @code{bzip2}, @code{lzma}, @code{compress} and @code{yabba}
 programs, assumed to have @file{.z}, @file{.gz}, @file{.xz},
 @file{.bz2}, @file{.lzma}, @file{.Z}, or @file{.Y} extensions,
@@ -255,15 +254,17 @@
 @itemx -n @var{nodename}
 @cindex node, selecting from the command line
 Specify a particular node to visit in the initial file that Info
-loads.  This is especially useful in conjunction with
address@hidden@footnote{Of course, you can specify both the file and node
-in a @code{--node} command; but don't forget to escape the open and
-close parentheses and whitespace from the shell as in: @code{info --node
-"(emacs)Buffers"}.}.  You may specify @code{--node} multiple times; for
-an interactive Info, each @var{nodename} is visited in its own window,
-for a non-interactive Info (such as when @code{--output} is given) each
+loads.  This is especially useful in conjunction with @code{--file}.
+You may specify @code{--node} multiple times; for an interactive Info,
+each @var{nodename} is visited in its own window, for a
+non-interactive Info (such as when @code{--output} is given) each
 @var{nodename} is processed sequentially.
 
+You can specify both the file and node to the @code{--node} option
+using the usual Info syntax, but don't forget to escape the open and
+close parentheses and whitespace from the shell; for example:@*
address@hidden --node "(emacs)Buffers"}
+
 @item --output @var{filename}
 @itemx -o @var{filename}
 @cindex file, outputting to
@@ -417,19 +418,19 @@
 
 The following table lists the basic cursor movement commands in Info.
 Each entry consists of the key sequence you should type to execute the
-cursor movement, the @address@hidden@code{M-x} is also a command; it
-invokes @code{execute-extended-command}.  @xref{M-x, , Executing an
-extended command, emacs, The GNU Emacs Manual}, for more detailed
-information.} command name (displayed in parentheses), and a short
-description of what the command does.  All of the cursor motion commands
-can take a @dfn{numeric} argument (see @ref{Miscellaneous Commands,
address@hidden, to find out how to supply them}.  With a
-numeric argument, the motion commands are simply executed that
-many times; for example, a numeric argument of 4 given to
address@hidden causes the cursor to move down 4 lines.  With a
-negative numeric argument, the motion is reversed; an argument of -4
-given to the @code{next-line} command would cause the cursor to move
address@hidden 4 lines.
+cursor movement, the @address@hidden@code{M-x} is also a command;
+it invokes @code{execute-extended-command}, letting you run a command
+by name.  @xref{M-x, , Executing an extended command, emacs, The GNU
+Emacs Manual}, for more detailed information.} command name (displayed
+in parentheses), and a short description of what the command does.
+All of the cursor motion commands can take a @dfn{numeric} argument
+(see @ref{Miscellaneous Commands, @code{universal-argument}, to find
+out how to supply them}.  With a numeric argument, the motion commands
+are simply executed that many times; for example, a numeric argument
+of 4 given to @code{next-line} causes the cursor to move down 4 lines.
+With a negative numeric argument, the motion is reversed; an argument
+of -4 given to the @code{next-line} command would cause the cursor to
+move @emph{up} 4 lines.
 
 @table @asis
 @item @kbd{C-n} (@code{next-line})
@@ -1551,11 +1552,9 @@
 @end table
 
 The next group of commands deal with @dfn{killing}, and @dfn{yanking}
address@hidden
-Some people are used to calling these operations @dfn{cut} and
address@hidden, respectively.}.   For an in-depth discussion of killing and
-yanking, see @ref{Killing, , Killing and Deleting, emacs, the GNU Emacs
-Manual}.
+text.  (Sometimes these operations are called @dfn{cut} and
address@hidden, respectively.)  For an in-depth discussion, see
address@hidden, , Killing and Deleting, emacs, the GNU Emacs Manual}.
 
 @table @asis
 @item @kbd{M-d} (@code{echo-area-kill-word})
@@ -2064,10 +2063,8 @@
 @cindex overriding default key bindings
 @cindex customizing key bindings
 @cindex key bindings, customizing
address@hidden infokey
address@hidden .info
address@hidden .infokey
address@hidden _info file (MS-DOS)
address@hidden @command{infokey}, program for customizing key bindings
address@hidden @file{_info} file (MS-DOS)
 
 GNU Info provides a way to define arbitrary key-to-command bindings
 and variable settings, overriding the defaults described in this
@@ -2075,13 +2072,13 @@
 @pxref{--vi-keys}.)
 
 On startup, GNU Info looks for a configuration file in the invoker's
-HOME directory called @address@hidden to the limitations of
-DOS filesystems, the MS-DOS version of Info looks for a file
address@hidden instead.  If the @env{HOME} variable is not defined, Info
-additionally looks in the current directory.}.  If it is present, and
-appears to contain Info configuration data, and was created with the
-current version of the @code{infokey} command, then Info adopts the
-key bindings and variable settings contained therein.
+HOME directory called @file{.info}.  (Due to the limitations of DOS
+filesystems, the MS-DOS version of Info looks for a file @file{_info}
+instead.  If the @env{HOME} variable is not defined, Info additionally
+looks in the current directory.)  If it is present, and appears to
+contain Info configuration data, and was created with the current
+version of the @code{infokey} command, then Info adopts the key
+bindings and variable settings contained therein.
 
 The @file{.info} file contains compact, non-textual data for reasons of
 efficiency and because its design was lifted wholesale from the GNU Less
@@ -2089,24 +2086,24 @@
 textual source file using the @code{infokey} command.
 
 @menu
-* Invoking infokey::
-* infokey source format::
+* Invoking @t{infokey}::
+* @t{infokey} source format::
 @end menu
 
 
address@hidden Invoking infokey
address@hidden Invoking @t{infokey}
 @section Invoking @command{infokey}
 
address@hidden invoking infokey
address@hidden infokey, invoking
address@hidden _infokey file (MS-DOS)
-
address@hidden compiles a source file
-(@file{$HOME/address@hidden file is named @file{_infokey} in
-the MS-DOS version, and is looked for in the current directory if
address@hidden is undefined.} by default) containing Info customizations
-into a binary format (@file{$HOME/.info} by default).  GNU Info reads
-the binary file at startup to override the default key bindings and
address@hidden invoking @command{infokey}
address@hidden @command{infokey}, invoking
address@hidden @file{_infokey} file (MS-DOS)
+
+By default, @command{infokey} reads a source file
+(@file{$HOME/.infokey} containing Info customizations.  (This file is
+named @file{_infokey} in the MS-DOS version, and is looked for in the
+current directory if @env{HOME} is undefined.)  It compiles this into
+a binary format, @file{$HOME/.info} by default.  GNU Info reads the
+binary file at startup to override the default key bindings and
 variable definitions.  Synopsis:
 
 @example
@@ -2118,12 +2115,12 @@
 write the binary data to @var{file} instead of @file{$HOME/.info}.
 
 
address@hidden infokey source format
address@hidden @t{infokey} source format
 @section @command{infokey} source format
 
address@hidden infokey source format
address@hidden .infokey source format
address@hidden format of .infokey source
address@hidden @command{infokey} source format
address@hidden @file{.infokey} source format
address@hidden format of @file{.infokey} source
 
 The format of the source file read by @command{infokey} is most easily
 illustrated by example.  For instance, here is a sample @file{.infokey}
@@ -2265,53 +2262,6 @@
 is bound to each command.
 
 
address@hidden the following is incomplete
address@hidden
address@hidden node Info for Sys Admins
address@hidden chapter Info for System Administrators
-
-This text describes some common ways of setting up an Info hierarchy
-from scratch, and details the various options that are available when
-installing Info.  This text is designed for the person who is installing
-GNU Info on the system; although users may find the information present
-in this section interesting, none of it is vital to understanding how to
-use GNU Info.
-
address@hidden
-* Setting the INFOPATH::        Where are my Info files kept?
-* Editing the DIR node::        What goes in `DIR', and why?
-* Storing Info files::          Alternate formats allow flexibility in setups.
-* Using `localdir'::            Building DIR on the fly.
-* Example setups::              Some common ways to organize Info files.
address@hidden menu
-
address@hidden node Setting the INFOPATH
address@hidden section Setting the INFOPATH
-
-Where are my Info files kept?
-
address@hidden node Editing the DIR node
address@hidden section Editing the DIR node
-
-What goes in `DIR', and why?
-
address@hidden node Storing Info files
address@hidden section Storing Info files
-
-Alternate formats allow flexibility in setups.
-
address@hidden node Using `localdir'
address@hidden section Using `localdir'
-
-Building DIR on the fly.
-
address@hidden node Example setups
address@hidden section Example setups
-
-Some common ways to organize Info files.
address@hidden ignore
-
-
 @node Index
 @appendix Index