[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo/doc texinfo.txi
|
From: |
karl |
|
Subject: |
texinfo/doc texinfo.txi |
|
Date: |
Mon, 14 Jan 2013 17:24:32 +0000 |
CVSROOT: /sources/texinfo
Module name: texinfo
Changes by: karl <karl> 13/01/14 17:24:32
Modified files:
doc : texinfo.txi
Log message:
fix more xrefs for new names
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.522&r2=1.523
Patches:
Index: texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.522
retrieving revision 1.523
diff -u -b -r1.522 -r1.523
--- texinfo.txi 14 Jan 2013 17:08:58 -0000 1.522
+++ texinfo.txi 14 Jan 2013 17:24:00 -0000 1.523
@@ -1,5 +1,5 @@
\input texinfo.tex @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.522 2013/01/14 17:08:58 karl Exp $
address@hidden $Id: texinfo.txi,v 1.523 2013/01/14 17:24:00 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.
@@ -3366,7 +3366,7 @@
For HTML output, each @code{@@titlefont} command produces an
@code{<h1>} heading, but the HTML document @code{<title>} is not
affected. For that, you must put an @code{@@settitle} command before
-the @code{@@titlefont} command (@pxref{settitle}).
+the @code{@@titlefont} command (@address@hidden@@settitle}}).
@need 700
For example:
@@ -3724,8 +3724,7 @@
@findex top
It is conventional and desirable to write an @code{@@top} sectioning
command line containing the title of the document immediately after
-the @code{@@node Top} line (@pxref{top command,, The @code{@@top}
-Sectioning Command}).
+the @code{@@node Top} line (@address@hidden@@top} Command}).
The contents of the `Top' node should appear only in the online output;
none of it should appear in printed output, so enclose it between
@@ -3879,10 +3878,10 @@
When producing HTML output for a document, @command{makeinfo} writes a
@samp{<meta>} element in the @samp{<head>} to give some idea of the
-content of the document. By default, this @dfn{description} is the title
-of the document, taken from the @code{@@settitle} command
-(@pxref{settitle}). To change this, use the @code{@@documentdescription}
-environment, as in:
+content of the document. By default, this @dfn{description} is the
+title of the document, taken from the @code{@@settitle} command
+(@address@hidden@@settitle}}). To change this, use the
address@hidden@@documentdescription} environment, as in:
@example
@@documentdescription
@@ -4426,9 +4425,8 @@
The @code{@@unnumbered} series of commands produce unnumbered entries
both in the body of a document and in its table of contents. The
@code{@@top} command, which has a special use, is a member of this
-series (@pxref{top command,, The @code{@@top} Sectioning Command}).
-An @code{@@unnumbered} section is a normal part of the document
-structure.
+series (@address@hidden@@top} Command}). An @code{@@unnumbered} section
+is a normal part of the document structure.
@item
The @code{@@heading} series of commands produce simple unnumbered
@@ -4734,7 +4732,7 @@
@code{@@appendixsubsubsec} do not need to be used in ordinary
circumstances, because @code{@@subsubsection} may also be used within
subsections of @code{@@unnumbered} and @code{@@appendix} chapters
-(@pxref{section,, @code{section}}).
+(@address@hidden@@section}}).
In Info, `subsub' titles are underlined with periods. For example,
@@ -4963,7 +4961,7 @@
* Writing a Node:: How to write an @code{@@node} line.
* Node Line Requirements:: Keep names unique.
* First Node:: How to write a `Top' node.
-* @code{@@top} command:: How to use the @code{@@top} command.
+* @code{@@top} Command:: How to use the @code{@@top} command.
@end menu
@@ -5240,7 +5238,7 @@
@end example
address@hidden @code{@@top} command
address@hidden @code{@@top} Command
@subsection The @code{@@top} Sectioning Command
@anchor{top address@hidden old name
@@ -5313,7 +5311,7 @@
Finally, you must follow the `Top' @code{@@node} line with a line
beginning with @code{@@top} to mark the top-level node in the file.
address@hidden command,, The @code{@@top} Sectioning Command}.
address@hidden@code{@@top} Command}.
@cindex Detail menu
@findex detailmenu
@@ -7197,7 +7195,7 @@
For Info, the quotes are omitted in the output of the @code{@@code}
command and related commands (e.g., @code{@@kbd}, @code{@@command}),
in typewriter-like contexts such as the @code{@@example} environment
-(@pxref{example,,@code{@@example}}) and @code{@@code} itself, etc.
+(@address@hidden@@example}}) and @code{@@code} itself, etc.
@node kbd
@@ -8238,7 +8236,7 @@
@findex smallquotation
Texinfo also provides a command @code{@@smallquotation}, which is just
like @code{@@quotation} but uses a smaller font size where possible.
address@hidden
address@hidden@code{@@address@hidden
@node @code{@@indentedblock}
@@ -8270,7 +8268,7 @@
@findex smallindentedblock
Texinfo also provides a command @code{@@smallindentedblock}, which is
just like @code{@@indentedblock} but uses a smaller font size where
-possible. @xref{small}.
+possible. @address@hidden@@address@hidden
@node @code{@@example}
@@ -8431,11 +8429,11 @@
@end example
The contents of @var{filename} is printed in a verbatim environment
-(@pxref{verbatim,,@code{@@verbatim}}). Generally, the file is printed
-exactly as it is, with all special characters and white space
-retained. No indentation is added; if you want indentation, enclose
-the @code{@@verbatiminclude} within @code{@@example}
-(@pxref{example,,@code{@@example}}).
+(@address@hidden@@verbatim}}). Generally, the file is printed exactly
+as it is, with all special characters and white space retained. No
+indentation is added; if you want indentation, enclose the
address@hidden@@verbatiminclude} within @code{@@example}
+(@address@hidden@@example}}).
The name of the file is taken literally, with a single exception:
@code{@@address@hidden@address@hidden references are expanded. This makes it
@@ -8585,7 +8583,8 @@
@findex smallformat
Texinfo also provides the environment @code{@@smallformat}, which is
-like @code{@@format} but uses a smaller font size. @xref{small}.
+like @code{@@format} but uses a smaller font size.
address@hidden@code{@@address@hidden
@node @code{@@exdent}
@@ -9090,8 +9089,8 @@
@findex enumerate
@cindex Enumeration
address@hidden@@enumerate} is like @code{@@itemize} (@pxref{itemize,,
address@hidden@@itemize}}), except that the labels on the items are
address@hidden@@enumerate} is like @code{@@itemize}
+(@address@hidden@@itemize}}), except that the labels on the items are
successive integers or letters instead of bullets.
Write the @code{@@enumerate} command at the beginning of a line. The
@@ -9208,11 +9207,11 @@
@cindex Tables, making two-column
@findex table
address@hidden@@table} is similar to @code{@@itemize} (@pxref{itemize,,
address@hidden@@itemize}}), but allows you to specify a name or heading line for
-each item. The @code{@@table} command is used to produce two-column
-tables, and is especially useful for glossaries, explanatory
-exhibits, and command-line option summaries.
address@hidden@@table} is similar to @code{@@itemize}
+(@address@hidden@@itemize}}), but allows you to specify a name or
+heading line for each item. The @code{@@table} command is used to
+produce two-column tables, and is especially useful for glossaries,
+explanatory exhibits, and command-line option summaries.
@menu
* @code{@@table}:: How to construct a two-column table.
@@ -11446,7 +11445,7 @@
@menu
* @code{@@TeX @@LaTeX}:: The @TeX{} logos.
* @code{@@copyright}:: The copyright symbol (c in a circle).
-* @code{@@registered}:: The registered symbol (R in a circle).
+* @code{@@registeredsymbol}:: The registered symbol (R in a circle).
* @code{@@dots}:: How to insert ellipses: @dots{} and
@enddots{}
* @code{@@bullet}:: How to insert a bullet: @bullet{}
* @code{@@euro}:: How to insert the euro currency symbol.
@@ -11497,7 +11496,7 @@
word `Copyright' suffices, according to international treaty.
address@hidden @code{@@registered}
address@hidden @code{@@registeredsymbol}
@subsection @code{@@address@hidden@}} (@registeredsymbol{})
@anchor{registered address@hidden old name
@@ -16429,8 +16428,8 @@
region formatting command, @code{texinfo-tex-region}, will format the
region in ``small'' book size (@pxref{Start of Header}).
address@hidden, for information about
-commands that make it easier to produce examples for a smaller manual.
address@hidden@code{@@address@hidden, for information about commands that make
+it easier to produce examples for a smaller manual.
@xref{Format with @code{texi2dvi}}, and @ref{Preparing for @TeX{}},
for other ways to format with @code{@@smallbook} that do not require
@@ -16823,8 +16822,8 @@
@item -D @var{var}
@opindex -D @var{var}
Cause the Texinfo variable @var{var} to be defined. This is
-equivalent to @code{@@set @var{var}} in the Texinfo file (@pxref{set
-clear value}).
+equivalent to @code{@@set @var{var}} in the Texinfo file
+(@address@hidden@@set @@clear @@value}}).
@item --disable-encoding
@itemx --enable-encoding
@@ -16950,8 +16949,8 @@
Generate Info output. By default, if the output file contains more
than about 300,000 bytes, it is split into shorter subfiles of about
that size. The name of the output file and any subfiles is determined
-by @code{@@setfilename} (@pxref{setfilename}). @xref{Tag and Split
-Files}.
+by @code{@@setfilename} (@address@hidden@@setfilename}}). @xref{Tag and
+Split Files}.
@item address@hidden
@opindex address@hidden
@@ -17896,9 +17895,10 @@
@item PREFIX
The output file prefix, which is prepended to some output file names.
By default it is set by @code{@@setfilename} or from the input file
-(@pxref{setfilename}). How this value is used depends on the value of
-other customization variables or command line options, such as whether
-the output is split and @code{NODE_FILENAMES}. The default is unset.
+(@address@hidden@@setfilename}}). How this value is used depends on the
+value of other customization variables or command line options, such
+as whether the output is split and @code{NODE_FILENAMES}. The default
+is unset.
@item PROGRAM
Name of the program used. By default, it is set to the name of the
@@ -18407,7 +18407,7 @@
When you invoke @code{makeinfo-region} the output goes to a temporary
buffer. When you invoke @code{makeinfo-buffer} output goes to the
-file set with @code{@@setfilename} (@pxref{setfilename}).
+file set with @code{@@setfilename} (@address@hidden@@setfilename}}).
The Emacs @code{makeinfo-region} and @code{makeinfo-buffer} commands
run the @code{makeinfo} program in a temporary shell buffer. If
@@ -19308,7 +19308,8 @@
Monolithic output (@code{--no-split}) is named according to
@code{@@setfilename} (with any @samp{.info} extension is replaced with
@samp{.html}), @code{--output} (the argument is used literally), or
-based on the input file name as a last resort (@pxref{setfilename}).
+based on the input file name as a last resort
+(@address@hidden@@setfilename}}).
@node HTML CSS
@@ -20105,7 +20106,7 @@
@item @@address@hidden@address@hidden
Define @var{name} as the current location for use as a cross reference
-target. @xref{anchor,, @code{@@anchor}}.
+target. @address@hidden@@anchor}}.
@item @@appendix @var{title}
Begin an appendix. The title appears in the table of contents. In
@@ -20140,9 +20141,8 @@
@address@hidden@@asis}}.
@item @@author @var{author}
-Typeset @var{author} flushleft and underline it. @xref{title
-subtitle author, , The @code{@@title} and @code{@@author}
-Commands}.
+Typeset @var{author} flushleft and underline it. @address@hidden@@title
+@@subtitle @@author}}.
@item @@address@hidden@address@hidden
Set @var{text} in a @b{bold} font. No effect in Info. @xref{Fonts}.
@@ -20245,8 +20245,8 @@
with @code{@@end cartouche}. @address@hidden@@copying}}.
@item @@address@hidden@}
-Generate the copyright symbol @copyright{}. @xref{copyright symbol,,
address@hidden@@address@hidden@}}}.
+Generate the copyright symbol @copyright{}.
address@hidden@code{@@copyright}}.
@item @@defcodeindex @var{index-name}
Define a new index and its indexing command. Print entries in an
@@ -20497,7 +20497,7 @@
@item @@example
Begin an example. Indent text, do not fill, and select fixed-width
-font. Pair with @code{@@end example}. @xref{example,, @code{@@example}}.
+font. Pair with @code{@@end example}. @address@hidden@@example}}.
@item @@exampleindent @var{indent}
Indent example-like environments by @var{indent} number of spaces
@@ -20557,7 +20557,7 @@
@item @@format
Begin a kind of example. Like @code{@@display}, but do not indent.
-Pair with @code{@@end format}. @xref{example,, @code{@@example}}.
+Pair with @code{@@end format}. @address@hidden@@example}}.
@item @@frenchspacing @var{on-off}
Control spacing after punctuation. @address@hidden@@frenchspacing}}.
@@ -20602,8 +20602,7 @@
@item @@headings @var{on-off-single-double}
Turn page headings on or off, and/or specify single-sided or double-sided
-page headings for printing. @xref{headings on off, , The
address@hidden@@headings} Command}.
+page headings for printing. @address@hidden@@headings}}.
@item @@headitem
Begin a heading row in a multitable. @xref{Multitable Rows}.
@@ -20756,7 +20755,7 @@
respectively: @L{}, @l{}.
@item @@address@hidden@}
-Generate the @LaTeX{} logo. @xref{tex, , @TeX{} and @LaTeX{}}.
+Generate the @LaTeX{} logo. @address@hidden@@TeX @@LaTeX}}.
@item @@address@hidden@}
Generate a less-than-or-equal sign, address@hidden'. @address@hidden@@geq
@@leq}}.
@@ -20893,8 +20892,7 @@
@item @@quotation
Narrow the margins to indicate text that is quoted from another work.
Takes optional argument specifying prefix text, e.g., an author name.
-Pair with @code{@@end quotation}. @xref{quotation, ,
address@hidden@@quotation}}.
+Pair with @code{@@end quotation}. @address@hidden@@quotation}}.
@item @@address@hidden@}
@itemx @@address@hidden@}
@@ -20932,8 +20930,8 @@
it in the source to some manuals, as it does no harm.
@item @@address@hidden@}
-Generate the legal symbol @registeredsymbol{}. @xref{registered
-symbol,, @code{@@address@hidden@}}}.
+Generate the legal symbol @registeredsymbol{}.
address@hidden@code{@@registeredsymbol}}.
@item @@address@hidden@}
Indicate the result of an expression to the reader with a special
@@ -20960,7 +20958,7 @@
table of contents. In Info, the title is underlined with equal signs.
Within @code{@@chapter} and @code{@@appendix}, the section title is
numbered; within @code{@@unnumbered}, the section is unnumbered.
address@hidden, , @code{@@section}}.
address@hidden@code{@@section}}.
@item @@set @var{txivar} address@hidden
Define the Texinfo variable @var{txivar}, optionally to the value
@@ -21008,33 +21006,35 @@
@item @@smallbook
Cause @TeX{} to produce a printed manual in a 7 by 9.25 inch format
rather than the regular 8.5 by 11 inch format. @xref{smallbook, ,
-Printing Small Books}. Also, see @ref{small}.
+Printing Small Books}. Also, see @address@hidden@@address@hidden
@item @@smalldisplay
Begin a kind of example. Like @code{@@display}, but use a smaller
font size where possible. Pair with @code{@@end smalldisplay}.
address@hidden
address@hidden@code{@@address@hidden
@item @@smallexample
Begin an example. Like @code{@@example}, but use a smaller font size
-where possible. Pair with @code{@@end smallexample}. @xref{small}.
+where possible. Pair with @code{@@end smallexample}.
address@hidden@code{@@address@hidden
@item @@smallformat
Begin a kind of example. Like @code{@@format}, but use a smaller font
size where possible. Pair with @code{@@end smallformat}.
address@hidden
address@hidden@code{@@address@hidden
@item @@smallindentedblock
Like @code{@@indentedblock}, but use a smaller font size where
-possible. Pair with @code{@@end smallindentedblock}. @xref{small}.
+possible. Pair with @code{@@end smallindentedblock}.
address@hidden@code{@@address@hidden
@item @@smalllisp
Begin an example of Lisp code. Same as @code{@@smallexample}. Pair
-with @code{@@end smalllisp}. @xref{small}.
+with @code{@@end smalllisp}. @address@hidden@@address@hidden
@item @@smallquotation
Like @code{@@quotation}, but use a smaller font size where possible.
-Pair with @code{@@end smallquotation}. @xref{small}.
+Pair with @code{@@end smallquotation}. @address@hidden@@address@hidden
@item @@sp @var{n}
Skip @var{n} blank lines. @address@hidden@@sp}}.
@@ -21104,7 +21104,7 @@
@address@hidden@@ftable @@vtable}}, and @address@hidden@@itemx}}.
@item @@address@hidden@}
-Generate the @TeX{} logo. @xref{tex, , @TeX{} and @LaTeX{}}.
+Generate the @TeX{} logo. @address@hidden@@TeX @@LaTeX}}.
@item @@tex
Enter @TeX{} completely. Pair with @code{@@end tex}. @xref{Raw
@@ -21146,9 +21146,8 @@
@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} Commands}.
+Not relevant to Info, which does not have title pages.
address@hidden@code{@@title @@subtitle @@author}}.
@item @@address@hidden@address@hidden
In a printed manual, print @var{text} in a larger than normal font.
@@ -21942,7 +21941,7 @@
as:
@example
-$Id: texinfo.txi,v 1.522 2013/01/14 17:08:58 karl Exp $
+$Id: texinfo.txi,v 1.523 2013/01/14 17:24:00 karl Exp $
@end example
(This is potentially useful in all sources that use version control,
@@ -22301,11 +22300,11 @@
Specify the single-sided heading format, with chapters on new pages.
@item @code{@@setchapternewpage off}
-Cause @TeX{} to start a new chapter on the same page as the last page of
-the preceding chapter, after skipping some vertical whitespace. Also
-cause @TeX{} to typeset for single-sided printing. (You can override
-the headers format with the @code{@@headings double} command; see
address@hidden on off, , The @code{@@headings} Command}.)
+Cause @TeX{} to start a new chapter on the same page as the last page
+of the preceding chapter, after skipping some vertical whitespace.
+Also cause @TeX{} to typeset for single-sided printing. (You can
+override the headers format with the @code{@@headings double} command;
address@hidden@code{@@headings}}.)
@item @code{@@setchapternewpage odd}
Specify the double-sided heading format, with chapters on new pages.