texinfo NEWS TODO doc/texinfo.tex doc/texinfo.t...

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       10/04/04 17:51:35

Modified files:
        .              : NEWS TODO 
        doc            : texinfo.tex texinfo.txi 
        doc/refcard    : txirefcard.tex 
        util           : texinfo.dtd 

Log message:
        @part documentation, dtd

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/NEWS?cvsroot=texinfo&r1=1.193&r2=1.194
http://cvs.savannah.gnu.org/viewcvs/texinfo/TODO?cvsroot=texinfo&r1=1.50&r2=1.51
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.tex?cvsroot=texinfo&r1=1.312&r2=1.313
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.251&r2=1.252
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/refcard/txirefcard.tex?cvsroot=texinfo&r1=1.10&r2=1.11
http://cvs.savannah.gnu.org/viewcvs/texinfo/util/texinfo.dtd?cvsroot=texinfo&r1=1.15&r2=1.16

Patches:
Index: NEWS
===================================================================
RCS file: /sources/texinfo/texinfo/NEWS,v
retrieving revision 1.193
retrieving revision 1.194
diff -u -b -r1.193 -r1.194
--- NEWS        17 Mar 2010 18:35:56 -0000      1.193
+++ NEWS        4 Apr 2010 17:51:34 -0000       1.194
@@ -1,4 +1,4 @@
-$Id: NEWS,v 1.193 2010/03/17 18:35:56 karl Exp $
+$Id: NEWS,v 1.194 2010/04/04 17:51:34 karl Exp $
 This NEWS file records noteworthy changes, very tersely.
 See the manual for detailed information.
 
@@ -24,6 +24,7 @@
 -------------------------------------------------------------------------------
 
 * Language:
+  . new command @part for a group of chapters.
   . new environments @smallquotation and @raggedright.
   . new command @headitemfont for the sake of template rows.
   . new diacritic command @ogonek.

Index: TODO
===================================================================
RCS file: /sources/texinfo/texinfo/TODO,v
retrieving revision 1.50
retrieving revision 1.51
diff -u -b -r1.50 -r1.51
--- TODO        17 Mar 2010 18:35:56 -0000      1.50
+++ TODO        4 Apr 2010 17:51:34 -0000       1.51
@@ -1,4 +1,4 @@
-$Id: TODO,v 1.50 2010/03/17 18:35:56 karl Exp $
+$Id: TODO,v 1.51 2010/04/04 17:51:34 karl Exp $
 This is the todo list for GNU Texinfo.
 If you are interested in working on any of these, email address@hidden
 
@@ -60,7 +60,6 @@
     into M columns (see eplain).
   - support bibliographies with BibTeX (see web2c/doc for kludge prototype).
   - @flushboth to combine @flushleft and @flushright, for RFC's.
-  - @part sectioning command.
   - @exercise/@answer command for, e.g., gawk.
   - Allow @hsep/@vsep at @item, instead of just in template.
   - Support automatic line numbering of examples.
@@ -76,7 +75,6 @@
   - Add support for other Latin 9 (and Latin 2 and Latin 1) characters.
 
 * Makeinfo:
-  - Translation of "Appendix" etc. should depend on @doclang not $LANG.
   - Really support UTF-8 instead of just passing through the bytes.
   - lang.c setup doesn't support @v{S} (S with caron) -- no named entity.
   - Automatically do -I of directory of main source file.
@@ -174,9 +172,6 @@
     and/or @documentencoding, and change the sorting appropriately.
   From: Wojciech Polak, 26 Apr 2003 11:30:59 +0200.
 
-* texi2html:
-  - @smallquotation
-
 * Distribution:
   - generate txi-??.tex from .po's to make translators' jobs easier.
     From Akim and Karl E.

Index: doc/texinfo.tex
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.tex,v
retrieving revision 1.312
retrieving revision 1.313
diff -u -b -r1.312 -r1.313
--- doc/texinfo.tex     22 Mar 2010 00:26:48 -0000      1.312
+++ doc/texinfo.tex     4 Apr 2010 17:51:34 -0000       1.313
@@ -3,7 +3,7 @@
 % Load plain if necessary, i.e., if running under initex.
 \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi
 %
-\def\texinfoversion{2010-03-21.17}
+\def\texinfoversion{2010-03-25.16}
 %
 % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995,
 % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
@@ -2105,8 +2105,8 @@
 \font\reducedsy=cmsy10
 \def\reducedecsize{1000}
 
-% reset the current fonts
-\textfonts
+\textleading = 13.2pt % line spacing for 11pt CM
+\textfonts            % reset the current fonts
 \rm
 } % end of 11pt text font size definitions
 
@@ -2236,11 +2236,9 @@
 \font\reducedsy=cmsy9
 \def\reducedecsize{0900}
 
-% reduce space between paragraphs
-\divide\parskip by 2
-
-% reset the current fonts
-\textfonts
+\divide\parskip by 2  % reduce space between paragraphs
+\textleading = 12pt   % line spacing for 10pt CM
+\textfonts            % reset the current fonts
 \rm
 } % end of 10pt text font size definitions
 
@@ -4751,7 +4749,7 @@
     % When reading the text of entry, convert explicit line breaks
     % from @* into spaces.  The user might give these in long section
     % titles, for instance.
-    \let\* = \space
+    \def\*{\unskip\space\ignorespaces}%
     %
     % Swallow the left brace of the text (first parameter):
     \afterassignment\doentry

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.251
retrieving revision 1.252
diff -u -b -r1.251 -r1.252
--- doc/texinfo.txi     17 Mar 2010 18:39:26 -0000      1.251
+++ doc/texinfo.txi     4 Apr 2010 17:51:34 -0000       1.252
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.251 2010/03/17 18:39:26 karl Exp $
address@hidden $Id: texinfo.txi,v 1.252 2010/04/04 17:51:34 karl Exp $
 @c Ordinarily, Texinfo files have the extension .texi.  But texinfo.texi
 @c clashes with texinfo.tex on 8.3 filesystems, so we use texinfo.txi.
 
@@ -274,7 +274,7 @@
 
 * Tree Structuring::            A manual is like an upside down tree @dots{}
 * Structuring Command Types::   How to divide a manual into parts.
-* makeinfo top::                The @code{@@top} command, part of the `Top' 
node.
+* makeinfo top::                The @code{@@top} command for the `Top' node.
 * chapter::
 * unnumbered & appendix::
 * majorheading & chapheading::
@@ -283,6 +283,7 @@
 * subsection::
 * unnumberedsubsec appendixsubsec subheading::
 * subsubsection::               Commands for the lowest level sections.
+* part::                        Collections of chapters.
 * Raise/lower sections::        How to change commands' hierarchical level.
 
 Nodes
@@ -3572,7 +3573,7 @@
 @node Contents
 @section Generating a Table of Contents
 @cindex Table of contents
address@hidden Contents, Table of
address@hidden Contents, table of
 @cindex Short table of contents
 @findex contents
 @findex summarycontents
@@ -4234,7 +4235,7 @@
 @menu
 * Tree Structuring::            A manual is like an upside down tree @dots{}
 * Structuring Command Types::   How to divide a manual into parts.
-* makeinfo top::                The @code{@@top} command, part of the `Top' 
node.
+* makeinfo top::                The @code{@@top} command for the `Top' node.
 * chapter::
 * unnumbered & appendix::
 * majorheading & chapheading::
@@ -4243,6 +4244,7 @@
 * subsection::
 * unnumberedsubsec appendixsubsec subheading::
 * subsubsection::               Commands for the lowest level sections.
+* part::                        Collections of chapters.
 * Raise/lower sections::        How to change commands' hierarchical level.
 @end menu
 
@@ -4365,21 +4367,25 @@
 @section @code{@@top}
 
 The @code{@@top} command is a special sectioning command that you use
-only after an @samp{@@node Top} line at the beginning of a Texinfo file.
-The @code{@@top} command tells the @code{makeinfo} formatter which node
-is the `Top' node, so it can use it as the root of the node tree if your
-manual uses implicit node pointers.  It has the same typesetting effect as
address@hidden@@unnumbered} (@pxref{unnumbered & appendix, , @code{@@unnumbered}
-and @code{@@appendix}}).  For detailed information, see @ref{makeinfo
-top command, , The @code{@@top} Command}.
+only after an @samp{@@node Top} line at the beginning of a Texinfo
+file.  The @code{@@top} command tells the @code{makeinfo} formatter
+which node is the `Top' node, so it can use it as the root of the node
+tree if your manual uses implicit node pointers.  It has the same
+effect as @code{@@unnumbered} (@pxref{unnumbered & appendix, ,
address@hidden@@unnumbered} and @code{@@appendix}}).  For detailed
+information, see @ref{makeinfo top command, , The @code{@@top}
+Command}.
 
 The @code{@@top} node and its menu (if any) is conventionally wrapped in
 an @code{@@ifnottex} conditional so that it will appear only in Info and
 HTML output, not @TeX{}.
 
address@hidden@@top} is ignored when raising or lowering sections
+(@pxref{Raise/lower sections}).  That is, it is never lowered and
+nothing can be raised to it.
+
 
 @node chapter
address@hidden  node-name,  next,  previous,  up
 @section @code{@@chapter}
 @findex chapter
 
@@ -4645,6 +4651,65 @@
 @end example
 
 
address@hidden part
address@hidden @code{@@part}: Groups of Chapters
address@hidden part
address@hidden Part pages
+
+The final sectioning command is @code{@@part}, to mark a @dfn{part} of
+a manual, that is, a group of chapters or (more unusually) appendices.
+This behaves quite differently from the other sectioning commands, to
+fit with the way such parts are conventionally used in books.
+
+No @code{@@node} command is associated with @code{@@part}.  Just write
+the command on a line by itself, including the part title, at the
+place in the document you want to mark off as starting that part.  For
+example:
+
address@hidden
+@@part Part I:@* The beginning
address@hidden example
+
+As can be inferred from this example, no automatic numbering or
+labeling of the @code{@@part} text is done.  The text is taken as-is.
+
+Because parts are not associated with nodes, no general text can
+follow the @code{@@part} line.  To produce the intended output, must
+be followed by a chapter-level command (including its node).  Thus, to
+continue the example:
+
address@hidden
+@@part Part I:@* The beginning
+
+@@node Introduction
+@@chapter Introduction
+...
address@hidden example
+
+In the @TeX{} output, the @code{@@part} text is included in both the
+normal and short tables of contents (@pxref{Contents}), without a page
+number (since that is the normal convention).  In addition, a ``part
+page'' is output in the body of the document, with just the
address@hidden@@part} text.  In the example above, the @code{@@*} causes a
+line break on the part page (but is replaced with a space in the
+tables of contents).  This part page is always forced to be on an odd
+(right-hand) page, regardless of the chapter pagination
+(@pxref{setchapternewpage,, @code{@@setchapternewpage}}).
+
+In the HTML output, the @code{@@part} text is similarly included in
+the tables of contents, and a heading is included in the main document
+text, as part of the following chapter or appendix node.
+
+In the XML and Docbook output, the @code{<part>} element includes all
+the following chapters, up to the next @code{<part>}.  A @code{<part>}
+containing chapters is also closed at an appendix.
+
+In the Info and ASCII output, @code{@@part} has no effect.
+
address@hidden@@part} is ignored when raising or lowering sections (see next
+section).  That is, it is never lowered and nothing can be raised to it.
+
+
 @node Raise/lower sections
 @section @code{@@raisesections} and @code{@@lowersections}
 @findex raisesections
@@ -4655,7 +4720,7 @@
 
 The @code{@@raisesections} and @code{@@lowersections} commands
 implicitly raise and lower the hierarchical level of following
-chapters, sections and the other sectioning commands.
+chapters, sections and the other sectioning commands (excluding parts).
 
 That is, the @code{@@raisesections} command changes sections to
 chapters, subsections to sections, and so on.  Conversely, the
@@ -5181,15 +5246,15 @@
 
 @node makeinfo top command
 @subsection The @code{@@top} Sectioning Command
address@hidden top @r{(@@-command)}
address@hidden top
 
-A special sectioning command, @code{@@top} should be used with the
+A special sectioning command, @code{@@top} should be used after the
 @code{@@node Top} line.  The @code{@@top} sectioning command tells
 @code{makeinfo} that it marks the `Top' node in the file.  It provides
 the information that @code{makeinfo} needs to insert node pointers
 automatically.  Write the @code{@@top} command at the beginning of the
-line immediately following the @code{@@node Top} line.  Write the title
-on the remaining part of the same line as the @code{@@top} command.
+line immediately following the @code{@@node Top} line, followed by the
+text of the title (on the same line).
 
 In Info, the @code{@@top} sectioning command causes the title to appear
 on a line by itself, with a line of asterisks inserted underneath, as
@@ -5198,17 +5263,20 @@
 In @TeX{} and @code{texinfo-format-buffer}, the @code{@@top}
 sectioning command is merely a synonym for @code{@@unnumbered}.
 Neither of these formatters require an @code{@@top} command, and do
-nothing special with it.  You can use @code{@@chapter} or
address@hidden@@unnumbered} after the @code{@@node Top} line when you use
-these formatters.  Also, you can use @code{@@chapter} or
address@hidden@@unnumbered} when you use the Texinfo updating commands to
-create or update pointers and menus.
+nothing special with it.  Indeed, it's conventional for the `Top' node
+to be delimited by @code{@@ifnottex}, so that @TeX{} will not see it
+(@pxref{Conditionals}).
 
-Thus, in practice, a Top node starts like this:
+Thus, in practice, a Top node usually looks like this:
 
 @example
+@@ifnottex
 @@node Top
-@@top Your Manual Title
+@@top @var{your-manual-title}
+
address@hidden
+@@end ifnottex
+
 @end example
 
 
@@ -16929,16 +16997,18 @@
 @code{install-info} creates it if possible (with no entries).
 
 @cindex Compressed dir files, reading
address@hidden XZ-compressed dir files, reading
 @cindex Bzipped dir files, reading
 @cindex LZMA-compressed dir files, reading
 @cindex Dir files, compressed
 If any input file is compressed with @code{gzip} (@pxref{Top,,,gzip,
-Gzip}), @code{install-info} automatically uncompresses it
-for reading.  And if @var{dir-file} is compressed, @code{install-info}
-also automatically leaves it compressed after writing any changes.
-If @var{dir-file} itself does not exist, @code{install-info} tries to
-open @address@hidden, @address@hidden, and
address@hidden@var{dir-file}.lzma}, in that order.
+Gzip}), @code{install-info} automatically uncompresses it for reading.
+And if @var{dir-file} is compressed, @code{install-info} also
+automatically leaves it compressed after writing any changes.  If
address@hidden itself does not exist, @code{install-info} tries to
+open @address@hidden, @address@hidden,
address@hidden@var{dir-file}.bz2}, and @address@hidden, in that
+order.
 
 Options:
 
@@ -17918,7 +17988,7 @@
 @item @@author @var{author}
 Typeset @var{author} flushleft and underline it.  @xref{title
 subtitle author, , The @code{@@title} and @code{@@author}
address@hidden
+Commands}.
 
 @item @@address@hidden@address@hidden
 Set @var{text} in a @b{bold} font.  No effect in Info.  @xref{Fonts}.
@@ -17926,7 +17996,7 @@
 @ignore
 @item @@br
 Force a paragraph break.  If used within a line, follow @code{@@br}
-with braces.  @xref{br, , @code{@@address@hidden
+with braces.  @xref{br, , @code{@@br}}.
 @end ignore
 
 @item @@address@hidden@}
@@ -17952,7 +18022,7 @@
 
 @item @@center @var{line-of-text}
 Center the line of text following the command.
address@hidden center sp, , @code{@@address@hidden
address@hidden center sp, , @code{@@center}}.
 
 @item @@centerchap @var{line-of-text}
 Like @code{@@chapter}, but centers the chapter title.  @xref{chapter,,
@@ -17971,7 +18041,7 @@
 
 @item @@cindex @var{entry}
 Add @var{entry} to the index of concepts.  @xref{Index Entries, ,
-Defining the Entries of an address@hidden
+Defining the Entries of an Index}.
 
 @item @@address@hidden@address@hidden
 Highlight the name of a book or other reference that has no companion
@@ -17995,7 +18065,7 @@
 and @code{@@end ifset} commands, and preventing
 @code{@@address@hidden@address@hidden from expanding to the value to which
 @var{flag} is set.
address@hidden clear value, , @code{@@set} @code{@@clear} @code{@@address@hidden
address@hidden clear value, , @code{@@set} @code{@@clear} @code{@@value}}.
 
 @item @@address@hidden@address@hidden
 Indicate an expression, a syntactically complete token of a program,
@@ -18018,7 +18088,7 @@
 @item @@contents
 Print a complete table of contents.  Has no effect in Info, which uses
 menus instead.  @xref{Contents, , Generating a Table of
address@hidden
+Contents}.
 
 @item @@address@hidden@}
 Generate the copyright symbol @copyright{}.  @xref{copyright symbol,,
@@ -18046,11 +18116,11 @@
 Format a description for a function, interactive command, or similar
 entity that may take arguments.  @code{@@deffn} takes as arguments the
 category of entity being described, the name of this particular
-entity, and its arguments, if any.  @xref{Definition address@hidden
+entity, and its arguments, if any.  @xref{Definition Commands}.
 
 @item @@defindex @var{index-name}
 Define a new index and its indexing command.  Print entries in a roman
-font.  @xref{New Indices, , Defining New address@hidden
+font.  @xref{New Indices, , Defining New Indices}.
 
 @item @@definfoenclose @var{newcmd}, @var{before}, @var{after}
 Must be used within @code{@@ifinfo}; create a new command
@@ -18224,7 +18294,7 @@
 
 @item @@address@hidden@}
 Generate an ellipsis, @address@hidden
address@hidden, , @code{@@address@hidden
address@hidden, , @code{@@dots}}.
 
 @item @@address@hidden@var{address}[, @address@hidden
 Indicate an electronic mail address.
@@ -18250,11 +18320,11 @@
 Begin a numbered list, using @code{@@item} for each entry.
 Optionally, start list with @var{number-or-letter}.  Pair with
 @code{@@end enumerate}.  @xref{enumerate, ,
address@hidden@@address@hidden
address@hidden@@enumerate}}.
 
 @item @@address@hidden@}
 Indicate to the reader the exact equivalence of two forms with a
-glyph: @address@hidden  @address@hidden
+glyph: @address@hidden  @xref{Equivalence}.
 
 @item @@address@hidden@}
 Generate the Euro currency sign.
@@ -18262,13 +18332,13 @@
 
 @item @@address@hidden@}
 Indicate to the reader with a glyph that the following text is
-an error message: @address@hidden  @xref{Error address@hidden
+an error message: @address@hidden  @xref{Error Glyph}.
 
 @item  @@evenfooting address@hidden @@| address@hidden @@| address@hidden
 @itemx @@evenheading address@hidden @@| address@hidden @@| address@hidden
 Specify page footings resp.@: headings for even-numbered (left-hand)
 pages.  @xref{Custom Headings, ,
-How to Make Your Own address@hidden
+How to Make Your Own Headings}.
 
 @item @@everyfooting address@hidden @@| address@hidden @@| address@hidden
 @itemx @@everyheading address@hidden @@| address@hidden @@| address@hidden
@@ -18288,12 +18358,12 @@
 
 @item @@exdent @var{line-of-text}
 Remove any indentation a line might have.  @xref{exdent, ,
-Undoing the Indentation of a address@hidden
+Undoing the Indentation of a Line}.
 
 @item @@address@hidden@}
 Indicate the result of a macro expansion to the reader with a special
 glyph: @address@hidden
address@hidden, , @expansion{} Indicating an address@hidden
address@hidden, , @expansion{} Indicating an Expansion}.
 
 @item @@address@hidden@address@hidden
 Highlight the name of a file, buffer, node, directory, etc.  @xref{file, ,
@@ -18301,11 +18371,11 @@
 
 @item @@finalout
 Prevent @TeX{} from printing large black warning rectangles beside
-over-wide lines.  @xref{Overfull address@hidden
+over-wide lines.  @xref{Overfull hboxes}.
 
 @item @@findex @var{entry}
 Add @var{entry} to the index of functions.  @xref{Index Entries, ,
-Defining the Entries of an address@hidden
+Defining the Entries of an Index}.
 
 @item @@firstparagraphindent @var{word}
 Control indentation of the first paragraph after section headers
@@ -18343,7 +18413,7 @@
 Automatically enter each of the items in the first column into the
 index of functions.  Pair with @code{@@end ftable}.  The same as
 @code{@@table}, except for indexing.  @xref{ftable vtable, ,
address@hidden@@ftable} and @code{@@address@hidden
address@hidden@@ftable} and @code{@@vtable}}.
 
 @item @@address@hidden@}
 Generate a greater-than-or-equal sign, address@hidden'.  @xref{geq leq}.
@@ -18431,7 +18501,7 @@
 
 @item @@iftex
 Begin text to appear only in the @TeX{} output.  Pair with @code{@@end
-iftex}.  @xref{Conditionals, , Conditionally Visible address@hidden
+iftex}.  @xref{Conditionals, , Conditionally Visible Text}.
 
 @item @@ifxml
 Begin text that will appear only in the XML output.  Pair with
@@ -18456,7 +18526,7 @@
 @item @@address@hidden@var{node-name}, address@hidden, @address@hidden
 Make a cross reference to an Info file for which there is no printed
 manual.  @xref{inforef, , Cross references using
address@hidden@@address@hidden
address@hidden@@inforef}}.
 
 @item \input @var{macro-definitions-file}
 Use the specified macro definitions file.  This command is used only
@@ -18497,7 +18567,7 @@
 
 @item @@kindex @var{entry}
 Add @var{entry} to the index of keys.
address@hidden Entries, , Defining the Entries of an address@hidden
address@hidden Entries, , Defining the Entries of an Index}.
 
 @item @@address@hidden@}
 @itemx @@address@hidden@}
@@ -18521,7 +18591,7 @@
 @item @@lowersections
 Change subsequent chapters to sections, sections to subsections, and so
 on. @xref{Raise/lower sections, , @code{@@raisesections} and
address@hidden@@address@hidden
address@hidden@@lowersections}}.
 
 @item @@macro @var{macroname} @address@hidden@}
 Define a new Texinfo command @code{@@@address@hidden@address@hidden
@@ -18575,7 +18645,7 @@
 @itemx @@oddheading address@hidden @@| address@hidden @@| address@hidden
 Specify page footings resp.@: headings for odd-numbered (right-hand)
 pages.  @xref{Custom Headings, ,
-How to Make Your Own address@hidden
+How to Make Your Own Headings}.
 
 @item @@address@hidden@}
 @itemx @@address@hidden@}
@@ -18597,7 +18667,7 @@
 
 @item @@page
 Start a new page in a printed manual.  No effect in Info.
address@hidden, , @code{@@address@hidden
address@hidden, , @code{@@page}}.
 
 @item @@pagesizes address@hidden, @var{height}]
 Change page dimensions.  @xref{pagesizes}.
@@ -18607,14 +18677,19 @@
 source file indentation if @var{indent} is @code{asis}.
 @xref{paragraphindent,, Paragraph Indenting}.
 
address@hidden @@part @var{title}
+Begin a group of chapters or appendixes; included in the tables of
+contents and produces a page of its own in printed output.
address@hidden,, @code{@@part}}.
+
 @item @@pindex @var{entry}
 Add @var{entry} to the index of programs.  @xref{Index Entries, , Defining
-the Entries of an address@hidden
+the Entries of an Index}.
 
 @item @@address@hidden@}
 Indicate the position of point in a buffer to the reader with a
 glyph: @address@hidden  @xref{Point Glyph, , Indicating
-Point in a address@hidden
+Point in a Buffer}.
 
 @item @@address@hidden@}
 Generate the pounds sterling currency sign.
@@ -18622,7 +18697,7 @@
 
 @item @@address@hidden@}
 Indicate printed output to the reader with a glyph:
address@hidden@print{}}.  @xref{Print address@hidden
address@hidden@print{}}.  @xref{Print Glyph}.
 
 @item @@printindex @var{index-name}
 Generate the alphabetized index for @var{index-name} (using two columns in a 
printed
@@ -18664,7 +18739,7 @@
 @item @@raisesections
 Change subsequent sections to chapters, subsections to sections, and so
 on.  @xref{Raise/lower sections, , @code{@@raisesections} and
address@hidden@@address@hidden
address@hidden@@lowersections}}.
 
 @item @@address@hidden@var{node}, address@hidden, address@hidden, 
address@hidden, address@hidden@}
 Make a plain reference that does not start with any special text.
@@ -18683,7 +18758,7 @@
 
 @item @@address@hidden@}
 Indicate the result of an expression to the reader with a special
-glyph: @address@hidden  @xref{result, , @code{@@address@hidden
+glyph: @address@hidden  @xref{result, , @code{@@result}}.
 
 @item @@address@hidden@address@hidden
 Generate a ring accent over the next character, as in @ringaccent{o}.
@@ -18781,7 +18856,7 @@
 @xref{small}.
 
 @item @@sp @var{n}
-Skip @var{n} blank lines.  @xref{sp, , @code{@@address@hidden
+Skip @var{n} blank lines.  @xref{sp, , @code{@@sp}}.
 
 @item @@address@hidden@}
 Generate the German sharp-S es-zet letter, @ss{}.  @xref{Inserting Accents}.
@@ -18829,7 +18904,7 @@
 @item @@syncodeindex @var{from-index} @var{to-index}
 Merge the index named in the first argument into the index named in
 the second argument, formatting the entries from the first index with
address@hidden@@code} .  @xref{Combining address@hidden
address@hidden@@code} .  @xref{Combining Indices}.
 
 @item @@synindex @var{from-index} @var{to-index}
 Merge the index named in the first argument into the index named in
@@ -18891,14 +18966,14 @@
 
 @item @@tindex @var{entry}
 Add @var{entry} to the index of data types.  @xref{Index Entries, ,
-Defining the Entries of an address@hidden
+Defining the Entries of an Index}.
 
 @item @@title @var{title}
 In a printed manual, set a title flush to the left-hand side of the
 page in a larger than normal font and underline it with a black rule.
 Not relevant to Info, which does not have title pages.  @xref{title
 subtitle author, , The @code{@@title} @code{@@subtitle} and
address@hidden@@author} address@hidden
address@hidden@@author} Commands}.
 
 @item @@address@hidden@address@hidden
 In a printed manual, print @var{text} in a larger than normal font.
@@ -18909,11 +18984,11 @@
 Begin the title page.  Write the command on a line of its own, paired
 with @code{@@end titlepage}.  Nothing between @code{@@titlepage} and
 @code{@@end titlepage} appears in Info.  @xref{titlepage, ,
address@hidden@@address@hidden
address@hidden@@titlepage}}.
 
 @item @@address@hidden@}
 Insert the current date, in `1 Jan 1900' style.  @xref{Custom
-Headings, , How to Make Your Own address@hidden
+Headings, , How to Make Your Own Headings}.
 
 @item @@top @var{title}
 Mark the topmost @code{@@node} in the file, which must be defined on
@@ -18990,7 +19065,7 @@
 
 @item @@vindex @var{entry}
 Add @var{entry} to the index of variables.  @xref{Index Entries, ,
-Defining the Entries of an address@hidden
+Defining the Entries of an Index}.
 
 @item @@vskip @var{amount}
 In a printed manual, insert whitespace so as to push text on the
@@ -19004,7 +19079,7 @@
 Automatically enter each of the items in the first column into the
 index of variables.  Pair with @code{@@end vtable}.  The same as
 @code{@@table}, except for indexing.  @xref{ftable vtable, ,
address@hidden@@ftable} and @code{@@address@hidden
address@hidden@@ftable} and @code{@@vtable}}.
 
 @item @@address@hidden@address@hidden
 Disallow line breaks within @var{text}.  @xref{w, , @code{@@w}}.
@@ -19046,7 +19121,7 @@
 document; they do not require arguments.  For example,
 @code{@@address@hidden@}} @result{} @address@hidden, @code{@@address@hidden@}}
 @result{} @address@hidden, @code{@@address@hidden@}} @result{} address@hidden',
-and @code{@@address@hidden@}} @result{} @address@hidden@refill
+and @code{@@address@hidden@}} @result{} @address@hidden
 
 @item 3. Alphabetic commands that require arguments within braces.
 These commands start with @@ followed by a letter or a word, followed by an
@@ -19059,7 +19134,7 @@
 followed by the name of the command (a word); for example, @code{@@center}
 or @code{@@cindex}.  If no argument is needed, the word is followed by
 the end of the line.  If there is an argument, it is separated from
-the command name by a space.  Braces are not address@hidden
+the command name by a space.  Braces are not used.
 @end table
 
 @cindex Braces and argument syntax
@@ -19071,7 +19146,7 @@
 command together with other text as part of a paragraph, the command
 is in class 3 and must be followed by an argument in braces;
 otherwise, it is in class 4 and uses the rest of the line as its
address@hidden
+argument.
 
 The purpose of having a different syntax for commands of classes 3 and
 4 is to make Texinfo files easier to read, and also to help the GNU
@@ -19625,7 +19700,7 @@
 (@url{http://www.gnu.org/software/rcs}) version control systems, which
 expand it into a string such as:
 @example
-$Id: texinfo.txi,v 1.251 2010/03/17 18:39:26 karl Exp $
+$Id: texinfo.txi,v 1.252 2010/04/04 17:51:34 karl Exp $
 @end example
 (This is useful in all sources that use version control, not just manuals.)
 You may wish to include the @samp{$Id:} comment in the @code{@@copying}
@@ -19704,7 +19779,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.251 2010/03/17 18:39:26 karl Exp $
address@hidden $Id: texinfo.txi,v 1.252 2010/04/04 17:51:34 karl Exp $
 @comment %**start of header
 @setfilename sample.info
 @include version.texi

Index: doc/refcard/txirefcard.tex
===================================================================
RCS file: /sources/texinfo/texinfo/doc/refcard/txirefcard.tex,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -b -r1.10 -r1.11
--- doc/refcard/txirefcard.tex  10 May 2009 21:31:02 -0000      1.10
+++ doc/refcard/txirefcard.tex  4 Apr 2010 17:51:34 -0000       1.11
@@ -1,5 +1,5 @@
 % Texinfo reference card.
-% $Id: txirefcard.tex,v 1.10 2009/05/10 21:31:02 karl Exp $
+% $Id: txirefcard.tex,v 1.11 2010/04/04 17:51:34 karl Exp $
 %
 %**start of header
 % This file can be printed with 1, 2, or 3 columns per page (see below).
@@ -14,7 +14,7 @@
 \newcount\letterpaper
 \ifx\undefined\afour\letterpaper=1 \else\letterpaper=0 \fi
 
-% Copyright 2008, 2009 Free Software Foundation, Inc.
+% Copyright 2008, 2009, 2010 Free Software Foundation, Inc.
 %
 % This file is part of GNU Texinfo.
 %
@@ -455,11 +455,8 @@
 \section{Nodes}
 
 address@hidden, next, previous, up}{Begin a new node.  The \var{next}, 
\var{previous}, and \var{up} pointers are usually omitted in a 
normally-structured document.}
-
 address@hidden the topmost address@hidden in the file, which must be defined 
on the line immediately preceding address@hidden The \var{title} is formatted 
as a chapter-level heading.  The entire top node, including the address@hidden 
and address@hidden lines, are normally enclosed with address@hidden ... @end 
ifnottex}.}
-
 address@hidden \var{name} as the current location, for use as a 
cross-reference target.}
-
 address@hidden validation of node references and omit creation of auxiliary 
files with \TeX. Use before address@hidden
 
 
@@ -467,6 +464,7 @@
 
 address@hidden subsequent chapters to sections, sections to subsections, and 
so on.}
 address@hidden subsequent sections to chapters, subsections to sections, and 
so on.}
address@hidden part page, beginning a group of chapters; included in contents.}
 
 \subsection{Numbered, included in contents}
 

Index: util/texinfo.dtd
===================================================================
RCS file: /sources/texinfo/texinfo/util/texinfo.dtd,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -b -r1.15 -r1.16
--- util/texinfo.dtd    12 Jan 2009 13:52:23 -0000      1.15
+++ util/texinfo.dtd    4 Apr 2010 17:51:35 -0000       1.16
@@ -1,19 +1,15 @@
-<!-- $Id: texinfo.dtd,v 1.15 2009/01/12 13:52:23 karl Exp $
+<!-- $Id: texinfo.dtd,v 1.16 2010/04/04 17:51:35 karl Exp $
    Document Type Definition for Texinfo XML output (the '-'-xml option).
 
-  Copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
+  Copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
   Free Software Foundation, Inc.
 
   Copying and distribution of this file, with or without modification,
   are permitted in any medium without royalty provided the copyright
   notice and this notice are preserved.
 
-   Author: Philippe Martin
-   Contributors:
-           Karl Eichwalder
-           Alper Ersoy
-           Karl Berry
-           Torsten Bronger
+   Original author: Philippe Martin
+   Contributors: Karl Eichwalder, Alper Ersoy, Karl Berry, Torsten Bronger
 -->
 
 <!-- * ENTITIES * -->
@@ -56,7 +52,7 @@
 
 
 <!-- Sectioning -->
-<!ENTITY % section.level1 "top | chapter | unnumbered | appendix">
+<!ENTITY % section.level1 "top | part | chapter | unnumbered | appendix">
 
 <!ENTITY % section.level2 "section | unnumberedsec | appendixsec">
 
@@ -118,11 +114,11 @@
             | %Inline.footnote; | %option.cmds; ">
 
 
-<!-- * ELEMENTS * -->
+<!-- ELEMENTS -->
 
 <!-- TOP Level Element -->
-<!ELEMENT texinfo ((%metainformation; | titlepage | node | synindex | %block; 
| %toc;
-                    | %variables; | %lang;)* )>
+<!ELEMENT texinfo ((%metainformation; | titlepage | node | synindex
+                    | %block; | %toc; | %variables; | %lang;)* )>
 <!ATTLIST texinfo xml:lang (%languagecodes;) 'en'>
 
 <!-- meta-information -->
@@ -163,6 +159,7 @@
 
 <!-- SECTIONING -->
 <!ELEMENT top           (title?, (%section.level1.content;))>
+<!ELEMENT part          (title?, (%section.level1.content;))>
 
 <!ELEMENT chapter       (title?, (%section.level1.content;))>
 <!ELEMENT section       (title?, (%section.level2.content;))>