[5330] mention docbook colophon etc.

[karl]

Revision: 5330
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=5330
Author:   karl
Date:     2013-08-19 17:24:02 +0000 (Mon, 19 Aug 2013)
Log Message:
-----------
mention docbook colophon etc.

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

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2013-08-19 14:50:31 UTC (rev 5329)
+++ trunk/ChangeLog     2013-08-19 17:24:02 UTC (rev 5330)
@@ -1,3 +1,8 @@
+2013-08-19  Karl Berry  <address@hidden>
+
+       * doc/texinfo.texi (@t{@@unnumbered @@appendix}): mention special
+       Docbook output for acknowledgements, colophon, etc.
+
 2013-08-19  Sergey Poznyakoff  <address@hidden>
 
        New interactive command "display-file".

Modified: trunk/TODO
===================================================================
--- trunk/TODO  2013-08-19 14:50:31 UTC (rev 5329)
+++ trunk/TODO  2013-08-19 17:24:02 UTC (rev 5330)
@@ -3,7 +3,7 @@
 If you are interested in working on any of these, email address@hidden
 
   Copyright 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2003, 
-  2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2010, 2011, 2012
+  2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2010, 2011, 2012, 2013
   Free Software Foundation.
 
   Copying and distribution of this file, with or without modification,
@@ -43,7 +43,8 @@
   - Support general reference card creation.
 
 * Language:
-  - Allow : in node names for info files, for names like
+  - Remove the need for @if[not]tex at the beginning of the document.
+  - Allow : in node names for info files, for names such as
     `class::method'.  Likewise index entries.  A quoting mechanism such
     as surrounding node names with SPACE BACKSPACE is probably the best
     solution, although this is an incompatible change to Info format.

Modified: trunk/doc/texinfo.texi
===================================================================
--- trunk/doc/texinfo.texi      2013-08-19 14:50:31 UTC (rev 5329)
+++ trunk/doc/texinfo.texi      2013-08-19 17:24:02 UTC (rev 5330)
@@ -4545,10 +4545,30 @@
 Texinfo also provides a command @code{@@centerchap}, which is analogous
 to @code{@@unnumbered}, but centers its argument in the printed and HTML
 outputs.  This kind of stylistic choice is not usually offered by
-Texinfo.
+Texinfo.  It may be suitable for short documents.
 @c but the Hacker's Dictionary wanted it, before they quit Texinfo.
 
address@hidden Docbook and prefatory sections
address@hidden Preface, etc., and Docbook
+With @code{@@unnumbered}, if the name of the associated node is one of
+these English words (case-insensitive):
 
address@hidden
+Acknowledgements  Colophon  Dedication  Preface
address@hidden example
+
address@hidden @code{<acknowledgements>} Docbook tag
address@hidden @code{<colophon>} Docbook tag
address@hidden @code{<dedication>} Docbook tag
address@hidden @code{<preface>} Docbook tag
address@hidden @code{<chapter>} Docbook tag
address@hidden @code{<title>} Docbook tag
address@hidden then the Docbook output uses corresponding special tags
+(@code{<preface>}, etc.)@: instead of the default @code{<chapter>}.
+The argument to @code{@@unnumbered} itself can be anything, and is
+output as the following @code{<title>} text as usual.
+
+
 @node @t{@@majorheading @@chapheading}
 @section @code{@@majorheading}, @code{@@chapheading}: Chapter-level Headings
 
@@ -8251,16 +8271,21 @@
 a foo.
 @end quotation
 
-If the @code{@@quotation} argument is exactly one of these English words:
+If the @code{@@quotation} argument is one of these English words
+(case-insensitive):
 
 @example
 Caution  Important  Note  Tip  Warning
 @end example
 
address@hidden @code{<caution>} Docbook tag
address@hidden @code{<important>} Docbook tag
 @cindex @code{<note>} Docbook tag
address@hidden @code{<tip>} Docbook tag
address@hidden @code{<warning>} Docbook tag
 @cindex @code{<blockquote>} HTML tag
 @noindent then the Docbook output uses corresponding special tags
-(@code{<note>}, etc.) instead of the default @code{<blockquote>}.
+(@code{<note>}, etc.)@: instead of the default @code{<blockquote>}.
 HTML output always uses @code{<blockquote>}.
 
 If the author of the quotation is specified in the @code{@@quotation}
@@ -18264,7 +18289,8 @@
 This will be remedied in a future release.)
 
 The following transformations are currently supported (many are used
-in the @code{pod2texi} utility distributed with Texinfo):
+in the @code{pod2texi} utility distributed with Texinfo;
address@hidden @t{pod2texi}}):
 
 @ftable @samp
 @item complete_tree_nodes_menus
@@ -18272,9 +18298,9 @@
 any level, based on the sectioning tree.
 
 @item fill_gaps_in_sectioning
-Adds empty @code{@@unnumbered} in a tree to fill gaps in sectioning.
-For example, an @code{@@unnumberedsec} will be inserted if an
address@hidden@@chapter} is followed by an @code{@@subsection}.
+Adds empty @code{@@unnumbered...} sections in a tree to fill gaps in
+sectioning.  For example, an @code{@@unnumberedsec} will be inserted
+if an @code{@@chapter} is followed by an @code{@@subsection}.
 
 @item indent_menu_descriptions
 Reformat menus so that descriptions start at column
@@ -18440,7 +18466,7 @@
 
 
 @node Invoking @t{pod2texi}
address@hidden Invoking @t{pod2texi}: 
address@hidden Invoking @t{pod2texi}: Convert POD to Texinfo
 
 @pindex pod2texi
 @cindex Invoking @code{pod2texi}