[6494] remove commented-out appendices

[Gavin D. Smith]

Revision: 6494
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=6494
Author:   gavin
Date:     2015-08-03 10:10:44 +0000 (Mon, 03 Aug 2015)
Log Message:
-----------
remove commented-out appendices

Modified Paths:
--------------
    trunk/ChangeLog
    trunk/doc/texinfo.texi

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2015-08-03 09:54:52 UTC (rev 6493)
+++ trunk/ChangeLog     2015-08-03 10:10:44 UTC (rev 6494)
@@ -1,5 +1,9 @@
 2015-08-03  Gavin Smith  <address@hidden>
 
+       * doc/texinfo.texi: Remove commented-out appendices.
+
+2015-08-03  Gavin Smith  <address@hidden>
+
        * doc/texinfo.tex (\initialfonts): New macro.
        (\initial): Split into \initial and \initialx.  Use 
        \initialfonts in \initial, and use \egroup at the end of 

Modified: trunk/doc/texinfo.texi
===================================================================
--- trunk/doc/texinfo.texi      2015-08-03 09:54:52 UTC (rev 6493)
+++ trunk/doc/texinfo.texi      2015-08-03 10:10:44 UTC (rev 6494)
@@ -24399,532 +24399,6 @@
 @xref{Cross References}.
 
 
address@hidden The simple description in the command summary seems sufficient 
to me
address@hidden these days, so ignore this appendix.  --karl, 13mar04.
address@hidden
address@hidden @node Refilling Paragraphs
address@hidden @appendix Refilling Paragraphs
address@hidden @cindex Refilling paragraphs
address@hidden @cindex Filling paragraphs
address@hidden @cindex Paragraphs, filling
address@hidden @findex refill
address@hidden
address@hidden The @code{@@refill} command refills and, optionally, indents the 
first
address@hidden line of a address@hidden the command should have been
address@hidden called the @code{@@refillandindent} command, but @code{@@refill} 
is
address@hidden shorter and the name was chosen before indenting was possible.} 
The
address@hidden @code{@@refill} command is no longer important, but we describe 
it here
address@hidden because you once needed it.  You will see it in many old Texinfo
address@hidden files.
address@hidden
address@hidden Without refilling, paragraphs containing long @@-constructs may 
look
address@hidden bad after formatting because the formatter removes @@-commands 
and
address@hidden shortens some lines more than others.  In the past, neither the
address@hidden @code{texinfo-format-region} command nor the
address@hidden @code{texinfo-format-buffer} command refilled paragraphs
address@hidden automatically.  The @code{@@refill} command had to be written at 
the
address@hidden end of every paragraph to cause these formatters to fill them.  
(Both
address@hidden @TeX{} and @code{makeinfo} have always refilled paragraphs
address@hidden automatically.)  Now, all the Info formatters automatically fill 
and
address@hidden indent those paragraphs that need to be filled and indented.
address@hidden
address@hidden The @code{@@refill} command causes @code{texinfo-format-region} 
and
address@hidden @code{texinfo-format-buffer} to refill a paragraph in the Info 
file
address@hidden @emph{after} all the other processing has been done.  For this 
reason,
address@hidden you can not use @code{@@refill} with a paragraph containing 
either
address@hidden @code{@@*} or @code{@@address@hidden @dots{} @}} since the 
refilling action will
address@hidden override those two commands.
address@hidden
address@hidden The @code{texinfo-format-region} and @code{texinfo-format-buffer}
address@hidden commands now automatically append @code{@@refill} to the end of 
each
address@hidden paragraph that should be filled.  They do not append 
@code{@@refill} to
address@hidden the ends of paragraphs that contain @code{@@*} or 
@address@hidden@@address@hidden @address@hidden
address@hidden and therefore do not refill or indent them.
-
-
address@hidden These are no longer ``new'', and the explanations
address@hidden are all given elsewhere anyway.  So ignore the entire appendix.
address@hidden --karl, 25apr97.
address@hidden node New Features, Command and Variable Index, Obtaining TeX, Top
address@hidden appendix Second Edition Features
-
address@hidden @tex
address@hidden % Widen the space for the first column so three 
control-character %
address@hidden strings fit in the first column.  Switched back to default .8in %
address@hidden value at end of chapter.  \global\tableindent=1.0in
address@hidden @end tex
address@hidden
address@hidden The second edition of the Texinfo manual describes more than 20 
new
address@hidden Texinfo mode commands and more than 50 previously undocumented 
Texinfo
address@hidden @@-commands.  This edition is more than twice the length of the 
first
address@hidden edition.
address@hidden
address@hidden Here is a brief description of the new commands.
address@hidden
address@hidden @c menu
address@hidden * New Texinfo Mode Commands::   The updating commands are 
especially useful.
address@hidden * New Commands::                Many newly described @@-commands.
address@hidden @c end menu
address@hidden
address@hidden @c node New Texinfo Mode Commands, New Commands, Obtaining TeX, 
Obtaining TeX
address@hidden @c appendixsec New Texinfo Mode Commands
address@hidden
address@hidden Texinfo mode provides commands and features especially designed 
for
address@hidden working with Texinfo files.  More than 20 new commands have been
address@hidden added, including commands for automatically creating and updating
address@hidden both nodes and menus.  This is a tedious task when done by hand.
address@hidden
address@hidden The keybindings are intended to be somewhat mnemonic.
address@hidden
address@hidden @c subheading Update all nodes and menus
address@hidden
address@hidden The @code{texinfo-master-menu} command is the primary command:
address@hidden
address@hidden @table @kbd
address@hidden @item C-c C-u m
address@hidden @itemx M-x texinfo-master-menu
address@hidden Create or update a master menu.
address@hidden With @kbd{C-u} as a prefix argument,
address@hidden first create or update all nodes
address@hidden and regular menus.
address@hidden @end table
address@hidden
address@hidden @c subheading Update Pointers
address@hidden
address@hidden @noindent
address@hidden Create or update `Next', `Previous', and `Up' node pointers.
address@hidden
address@hidden @noindent
address@hidden @xref{Updating Nodes and Menus}.
address@hidden
address@hidden @table @kbd
address@hidden @item C-c C-u C-n
address@hidden @itemx M-x texinfo-update-node
address@hidden Update a node.
address@hidden
address@hidden @item C-c C-u C-e
address@hidden @itemx M-x texinfo-every-node-update
address@hidden Update every node in the buffer.
address@hidden @end table
address@hidden
address@hidden @c subheading Update Menus
address@hidden
address@hidden @noindent
address@hidden Create or update menus.
address@hidden
address@hidden @noindent
address@hidden @xref{Updating Nodes and Menus}.
address@hidden
address@hidden @table @kbd
address@hidden @item C-c C-u C-m
address@hidden @itemx M-x texinfo-make-menu
address@hidden Make or update a menu.
address@hidden
address@hidden @item C-c C-u C-a
address@hidden @itemx M-x texinfo-all-menus-update
address@hidden Make or update all the menus in a buffer.
address@hidden With @kbd{C-u} as a prefix argument,
address@hidden first update all the nodes.
address@hidden @end table
address@hidden
address@hidden @c subheading Insert Title as Description
address@hidden
address@hidden @noindent
address@hidden Insert a node's chapter or section title in the space for the
address@hidden description in a menu entry line; position point so you can edit 
the
address@hidden insert.  (This command works somewhat differently than the other
address@hidden insertion commands, which insert only a predefined string.)
address@hidden
address@hidden @noindent
address@hidden @xref{Inserting, Inserting Frequently Used Commands}.
address@hidden
address@hidden @table @kbd
address@hidden @item C-c C-c C-d
address@hidden Insert title.
address@hidden @end table
address@hidden
address@hidden @c subheading Format for Info
address@hidden
address@hidden @noindent
address@hidden Provide keybindings both for the Info formatting commands that 
are
address@hidden written in Emacs Lisp and for @code{makeinfo} that is written in
address@hidden C.
address@hidden
address@hidden @noindent
address@hidden @xref{Info Formatting}.
address@hidden
address@hidden @noindent
address@hidden Use the Emacs lisp @address@hidden commands:
address@hidden
address@hidden @table @kbd
address@hidden @item C-c C-e C-r
address@hidden Format the region.
address@hidden
address@hidden @item C-c C-e C-b
address@hidden Format the buffer.
address@hidden @end table
address@hidden
address@hidden @noindent
address@hidden Use @code{makeinfo}:
address@hidden
address@hidden @table @kbd
address@hidden @item C-c C-m C-r
address@hidden Format the region.
address@hidden
address@hidden @item C-c C-m C-b
address@hidden Format the buffer.
address@hidden
address@hidden @item C-c C-m C-l
address@hidden Recenter the @code{makeinfo} output buffer.
address@hidden
address@hidden @item C-c C-m C-k
address@hidden Kill the @code{makeinfo} formatting job.
address@hidden @end table
address@hidden
address@hidden @c subheading Typeset and Print
address@hidden
address@hidden @noindent
address@hidden Typeset and print Texinfo documents from within Emacs.
address@hidden
address@hidden @noindent
address@hidden @xref{Printing}.
address@hidden
address@hidden @table @kbd
address@hidden @item C-c C-t C-b
address@hidden Run @code{texi2dvi} on the buffer.
address@hidden
address@hidden @item C-c C-t C-r
address@hidden Run @TeX{} on the region.
address@hidden
address@hidden @item C-c C-t C-i
address@hidden Run @code{texindex}.
address@hidden
address@hidden @item C-c C-t C-p
address@hidden Print the DVI file.
address@hidden
address@hidden @item C-c C-t C-q
address@hidden Show the print queue.
address@hidden
address@hidden @item C-c C-t C-d
address@hidden Delete a job from the print queue.
address@hidden
address@hidden @item C-c C-t C-k
address@hidden Kill the current @TeX{} formatting job.
address@hidden
address@hidden @item C-c C-t C-x
address@hidden Quit a currently stopped @TeX{} formatting job.
address@hidden
address@hidden @item C-c C-t C-l
address@hidden Recenter the output buffer.
address@hidden @end table
address@hidden
address@hidden @c subheading Other Updating Commands
address@hidden
address@hidden @noindent
address@hidden The ``other updating commands'' do not have standard keybindings 
because
address@hidden they are used less frequently.
address@hidden
address@hidden @noindent
address@hidden @xref{Other Updating Commands}.
address@hidden
address@hidden @table @kbd
address@hidden @item M-x texinfo-insert-node-lines
address@hidden Insert missing @code{@@node} lines using
address@hidden section titles as node names.
address@hidden
address@hidden @item M-x texinfo-multiple-files-update
address@hidden Update a multi-file document.
address@hidden With a numeric prefix, such as @kbd{C-u 8},
address@hidden update  @strong{every} pointer and
address@hidden menu in @strong{all} the files and
address@hidden then insert a master menu.
address@hidden
address@hidden @item M-x texinfo-indent-menu-description
address@hidden Indent descriptions in menus.
address@hidden
address@hidden @item M-x texinfo-sequential-node-update
address@hidden Insert node pointers in strict sequence.
address@hidden @end table
address@hidden
address@hidden @c no.de New Commands,  , New Texinfo Mode Commands, Obtaining 
TeX
address@hidden @c appendix.sec New Texinfo @@-Commands
address@hidden
address@hidden The second edition of the Texinfo manual describes more than 50
address@hidden commands that were not described in the first edition.  A third 
or so
address@hidden of these commands existed in Texinfo but were not documented in 
the
address@hidden manual; the others are new.  Here is a listing, with brief
address@hidden descriptions of them:
address@hidden
address@hidden @c subheading Indexing
address@hidden
address@hidden @noindent
address@hidden Create your own index, and merge indices.
address@hidden
address@hidden @noindent
address@hidden @xref{Indices}.
address@hidden
address@hidden @table @kbd
address@hidden @item @@defindex @var{index-name}
address@hidden Define a new index and its indexing command.
address@hidden See also the @code{@@defcodeindex} command.
address@hidden
address@hidden @c written verbosely to avoid overfull hbox
address@hidden @item @@synindex @var{from-index} @var{into-index}
address@hidden Merge the @var{from-index} index into the @var{into-index} index.
address@hidden See also the @code{@@syncodeindex} command.
address@hidden @end table
address@hidden
address@hidden @c subheading Definitions
address@hidden
address@hidden @noindent
address@hidden Describe functions, variables, macros,
address@hidden commands, user options, special forms, and other such artifacts 
in a
address@hidden uniform format.
address@hidden
address@hidden @noindent
address@hidden @xref{Definition Commands}.
address@hidden
address@hidden @table @kbd
address@hidden @item @@deffn @var{category} @var{name} @address@hidden
address@hidden Format a description for functions, interactive
address@hidden commands, and similar entities.
address@hidden
address@hidden @item @@defvr, @@defop, @dots{}
address@hidden 15 other related commands.
address@hidden @end table
address@hidden
address@hidden @c subheading Glyphs
address@hidden
address@hidden @noindent
address@hidden Indicate the results of evaluation, expansion,
address@hidden printed output, an error message, equivalence of expressions, 
and the
address@hidden location of point.
address@hidden
address@hidden @noindent
address@hidden @xref{Glyphs}.
address@hidden
address@hidden @table @kbd
address@hidden @item @@address@hidden@}
address@hidden @itemx @equiv{}
address@hidden Equivalence:
address@hidden
address@hidden @item @@address@hidden@}
address@hidden @itemx @error{}
address@hidden Error message
address@hidden
address@hidden @item @@address@hidden@}
address@hidden @itemx @expansion{}
address@hidden Macro expansion
address@hidden
address@hidden @item @@address@hidden@}
address@hidden @itemx @point{}
address@hidden Position of point
address@hidden
address@hidden @item @@address@hidden@}
address@hidden @itemx @print{}
address@hidden Printed output
address@hidden
address@hidden @item @@address@hidden@}
address@hidden @itemx @result{}
address@hidden Result of an expression
address@hidden @end table
address@hidden
address@hidden @c subheading Page Headings
address@hidden
address@hidden @noindent
address@hidden Customize page headings.
address@hidden
address@hidden @noindent
address@hidden @xref{Headings}.
address@hidden
address@hidden @table @kbd
address@hidden @item @@headings @var{on-off-single-double}
address@hidden Headings on or off, single, or double-sided.
address@hidden
address@hidden @item @@evenfooting address@hidden @@| address@hidden @@| 
address@hidden
address@hidden Footings for even-numbered (left-hand) pages.
address@hidden
address@hidden @item @@evenheading, @@everyheading, @@oddheading, @dots{}
address@hidden Five other related commands.
address@hidden
address@hidden @item @@thischapter
address@hidden Insert name of chapter and chapter number.
address@hidden
address@hidden @item @@thischaptername, @@thisfile, @@thistitle, @@thispage
address@hidden Related commands.
address@hidden @end table
address@hidden
address@hidden @c subheading Formatting
address@hidden
address@hidden @noindent
address@hidden Format blocks of text.
address@hidden
address@hidden @noindent
address@hidden @xref{Quotations and Examples}, address@hidden
address@hidden @ref{Lists and Tables, , Making Lists and Tables}.
address@hidden
address@hidden @table @kbd
address@hidden @item @@cartouche
address@hidden Draw rounded box surrounding text (no effect in Info).
address@hidden
address@hidden @item @@enumerate @var{optional-arg}
address@hidden Enumerate a list with letters or numbers.
address@hidden
address@hidden @item @@exdent @var{line-of-text}
address@hidden Remove indentation.
address@hidden
address@hidden @item @@flushleft
address@hidden Left justify.
address@hidden
address@hidden @item @@flushright
address@hidden Right justify.
address@hidden
address@hidden @item @@format
address@hidden Do not narrow nor change font.
address@hidden
address@hidden @item @@ftable @var{formatting-command}
address@hidden @itemx @@vtable @var{formatting-command}
address@hidden Two-column table with indexing.
address@hidden
address@hidden @item @@lisp
address@hidden For an example of Lisp code.
address@hidden
address@hidden @item @@smallexample
address@hidden @itemx @@smalllisp
address@hidden Like @@table and @@lisp, but for (originally) @@smallbook.
address@hidden @end table
address@hidden
address@hidden @c subheading Conditionals
address@hidden
address@hidden @noindent
address@hidden Conditionally format text.
address@hidden
address@hidden @noindent
address@hidden @xref{set clear value, , @code{@@set} @code{@@clear} 
@code{@@value}}.
address@hidden
address@hidden @table @kbd
address@hidden @item @@set @var{flag} address@hidden
address@hidden Set a flag.  Optionally, set value
address@hidden of @var{flag} to @var{string}.
address@hidden
address@hidden @item @@clear @var{flag}
address@hidden Clear a flag.
address@hidden
address@hidden @item @@address@hidden@address@hidden
address@hidden Replace with value to which @var{flag} is set.
address@hidden
address@hidden @item @@ifset @var{flag}
address@hidden Format, if @var{flag} is set.
address@hidden
address@hidden @item @@ifclear @var{flag}
address@hidden Ignore, if @var{flag} is set.
address@hidden @end table
address@hidden
address@hidden @c subheading @@heading series for Titles
address@hidden
address@hidden @noindent
address@hidden Produce unnumbered headings that do not appear in a table of 
contents.
address@hidden
address@hidden @noindent
address@hidden @xref{Structuring}.
address@hidden
address@hidden @table @kbd
address@hidden @item @@heading @var{title}
address@hidden Unnumbered section-like heading not listed
address@hidden in the table of contents of a printed manual.
address@hidden
address@hidden @item @@chapheading, @@majorheading, @@c subheading, 
@@subsubheading
address@hidden Related commands.
address@hidden @end table
address@hidden
address@hidden @need 1000
address@hidden @c subheading Font commands
address@hidden
address@hidden @need 1000
address@hidden @noindent
address@hidden @xref{Smallcaps}, and @*
address@hidden @ref{Fonts}.
address@hidden
address@hidden @table @kbd
address@hidden @item @@address@hidden@address@hidden
address@hidden Print in roman font.
address@hidden
address@hidden @item @@address@hidden@address@hidden
address@hidden Print in @sc{small caps} font.
address@hidden @end table
address@hidden
address@hidden @c subheading Miscellaneous
address@hidden
address@hidden @noindent
address@hidden See @ref{title subtitle author, , @code{@@title} 
@code{@@subtitle} and @code{@@author} Commands},@*
address@hidden see @ref{Customized Highlighting},@*
address@hidden see @ref{Overfull hboxes},@*
address@hidden see @ref{Footnotes},@*
address@hidden see @ref{dmn, , Format a Dimension},@*
address@hidden see @ref{Raise/lower sections, , @code{@@raisesections} and 
@code{@@lowersections}},@*
address@hidden see @ref{math, , @code{@@math}: Inserting Mathematical 
address@hidden
address@hidden see @ref{minus, , Inserting a Minus Sign},@*
address@hidden see @ref{paragraphindent, , Paragraph Indenting},@*
address@hidden see @ref{Cross Reference Commands},@*
address@hidden see @ref{title subtitle author, , @code{@@title} 
@code{@@subtitle} and @code{@@author}}, address@hidden
address@hidden see @ref{Custom Headings, , How to Make Your Own Headings}.
address@hidden
address@hidden @table @kbd
address@hidden @item @@author @var{author}
address@hidden Typeset author's name.
address@hidden
address@hidden @c @item @@definfoenclose @var{new-command}, @var{before}, 
@var{after},
address@hidden @c Define a highlighting command for Info.  (Info only.)
address@hidden
address@hidden @item @@finalout
address@hidden Produce cleaner printed output.
address@hidden
address@hidden @item @@footnotestyle @var{end-or-separate}
address@hidden Specify footnote style, either @samp{end} or @samp{separate}.
address@hidden @xref{Footnote Styles}.
address@hidden
address@hidden @item @@address@hidden@address@hidden
address@hidden Format a dimension.
address@hidden
address@hidden @item @@global@@address@hidden@var{existing-cmd}
address@hidden Define a highlighting command for @TeX{}. (@TeX{} only.)
address@hidden
address@hidden @item @@lowersections
address@hidden Reduce hierarchical level of sectioning commands.
address@hidden
address@hidden @item @@address@hidden@address@hidden
address@hidden Format a mathematical expression.
address@hidden
address@hidden @item @@address@hidden@}
address@hidden Generate a minus sign.
address@hidden
address@hidden @item @@paragraphindent @var{asis-or-number}
address@hidden Specify amount of paragraph indentation.
address@hidden
address@hidden @item @@raisesections
address@hidden Raise hierarchical level of sectioning commands.
address@hidden
address@hidden @item @@address@hidden@var{node-name}, @address@hidden@r{]}, 
@address@hidden@r{]}, @address@hidden@r{]}, @address@hidden@address@hidden
address@hidden Make a reference.  In the printed manual, the
address@hidden reference does not start with the word `see'.
address@hidden
address@hidden @item @@title @var{title}
address@hidden Typeset @var{title} in the alternative
address@hidden title page format.
address@hidden
address@hidden @item @@subtitle @var{subtitle}
address@hidden Typeset @var{subtitle} in the alternative
address@hidden title page format.
address@hidden
address@hidden @item @@address@hidden@}
address@hidden Insert the current date.
address@hidden @end table
address@hidden @tex
address@hidden % Switch width of first column of tables back to default value
address@hidden \global\tableindent=.8in
address@hidden @end tex
-
-
 @node GNU Free Documentation License
 @appendix GNU Free Documentation License