[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo/doc texinfo.txi
|
From: |
karl |
|
Subject: |
texinfo/doc texinfo.txi |
|
Date: |
Tue, 15 Jan 2013 23:12:58 +0000 |
CVSROOT: /sources/texinfo
Module name: texinfo
Changes by: karl <karl> 13/01/15 23:12:58
Modified files:
doc : texinfo.txi
Log message:
@t better than @code in node names, to avoid quotes
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.526&r2=1.527
Patches:
Index: texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.526
retrieving revision 1.527
diff -u -b -r1.526 -r1.527
--- texinfo.txi 15 Jan 2013 01:19:27 -0000 1.526
+++ texinfo.txi 15 Jan 2013 23:12:57 -0000 1.527
@@ -1,5 +1,5 @@
\input texinfo.tex @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.526 2013/01/15 01:19:27 karl Exp $
address@hidden $Id: texinfo.txi,v 1.527 2013/01/15 23:12:57 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.
@@ -158,7 +158,7 @@
* Include Files:: How to incorporate other Texinfo files.
* Hardcopy:: Output for paper, with @TeX{}.
-* Generic Translator @code{texi2any}:: @command{texi2any}, an all-purpose
converter.
+* Generic Translator @t{texi2any}:: @command{texi2any}, an all-purpose
converter.
* Creating and Installing Info Files:: Details on Info output.
* Generating HTML:: Details on HTML output.
@c * texi2any Output Customization:: Fine tuning with initialization files.
@@ -228,21 +228,21 @@
* First Line:: The first line of a Texinfo file.
* Start of Header:: Formatting a region requires this.
-* @code{@@setfilename}:: Tell Info the name of the Info file.
-* @code{@@settitle}:: Create a title for the printed work.
+* @t{@@setfilename}:: Tell Info the name of the Info file.
+* @t{@@settitle}:: Create a title for the printed work.
* End of Header:: Formatting a region requires this.
Document Permissions
-* @code{@@copying}:: Declare the document's copying
permissions.
-* @code{@@insertcopying}:: Where to insert the permissions.
+* @t{@@copying}:: Declare the document's copying
permissions.
+* @t{@@insertcopying}:: Where to insert the permissions.
Title and Copyright Pages
-* @code{@@titlepage}:: Create a title for the printed
document.
-* @code{@@titlefont @@center @@sp}:: The @code{@@titlefont},
@code{@@center},
+* @t{@@titlepage}:: Create a title for the printed document.
+* @t{@@titlefont @@center @@sp}:: The @code{@@titlefont},
@code{@@center},
and @code{@@sp} commands.
-* @code{@@title @@subtitle @@author}:: The @code{@@title},
@code{@@subtitle},
+* @t{@@title @@subtitle @@author}:: The @code{@@title},
@code{@@subtitle},
and @code{@@author} commands.
* Copyright:: How to write the copyright notice and
include copying permissions.
@@ -256,13 +256,13 @@
Global Document Commands
-* @code{@@documentdescription}:: Document summary for the HTML output.
-* @code{@@setchapternewpage}:: Start chapters on right-hand pages.
-* @code{@@headings}:: An option for turning headings on and off
+* @t{@@documentdescription}:: Document summary for the HTML output.
+* @t{@@setchapternewpage}:: Start chapters on right-hand pages.
+* @t{@@headings}:: An option for turning headings on and off
and double or single sided printing.
-* @code{@@paragraphindent}:: Specify paragraph indentation.
-* @code{@@firstparagraphindent}:: Suppressing first paragraph indentation.
-* @code{@@exampleindent}:: Specify environment indentation.
+* @t{@@paragraphindent}:: Specify paragraph indentation.
+* @t{@@firstparagraphindent}:: Suppressing first paragraph indentation.
+* @t{@@exampleindent}:: Specify environment indentation.
Ending a Texinfo File
@@ -274,22 +274,22 @@
* Tree Structuring:: A manual is like an upside down tree @dots{}
* Structuring Command Types:: How to divide a manual into parts.
-* @code{@@chapter}:: Chapter structuring.
-* @code{@@unnumbered @@appendix}::
-* @code{@@majorheading @@chapheading}::
-* @code{@@section}::
-* @code{@@unnumberedsec @@appendixsec @@heading}::
-* @code{@@subsection}::
-* @code{@@unnumberedsubsec @@appendixsubsec @@subheading}::
-* @code{@@subsubsection}:: Commands for the lowest level
sections.
-* @code{@@part}:: Collections of chapters.
+* @t{@@chapter}:: Chapter structuring.
+* @t{@@unnumbered @@appendix}::
+* @t{@@majorheading @@chapheading}::
+* @t{@@section}::
+* @t{@@unnumberedsec @@appendixsec @@heading}::
+* @t{@@subsection}::
+* @t{@@unnumberedsubsec @@appendixsubsec @@subheading}::
+* @t{@@subsubsection}:: Commands for the lowest level sections.
+* @t{@@part}:: Collections of chapters.
* Raise/lower sections:: How to change commands' hierarchical level.
Nodes
-* @code{@@node}:: Creating nodes, in detail.
-* @code{makeinfo} Pointer Creation:: Letting makeinfo determine node
pointers.
-* @code{@@anchor}:: Defining arbitrary cross reference
targets.
+* @t{@@node}:: Creating nodes, in detail.
+* @t{makeinfo} Pointer Creation:: Letting makeinfo determine node pointers.
+* @t{@@anchor}:: Defining arbitrary cross reference
targets.
* Node Menu Illustration:: A diagram, and sample nodes and menus.
The @code{@@node} Command
@@ -298,7 +298,7 @@
* Writing a Node:: How to write an @code{@@node} line.
* Node Line Requirements:: Keep names unique, without @@-commands.
* First Node:: How to write a `Top' node.
-* @code{@@top} command:: How to use the @code{@@top} command.
+* @t{@@top} command:: How to use the @code{@@top} command.
Menus
@@ -314,13 +314,13 @@
* References:: What cross references are for.
* Cross Reference Commands:: A summary of the different commands.
* Cross Reference Parts:: A cross reference has several parts.
-* @code{@@xref}:: Begin a reference with `See' @dots{}
+* @t{@@xref}:: Begin a reference with `See' @dots{}
* Top Node Naming:: How to refer to the beginning of another file.
-* @code{@@ref}:: A reference for the last part of a
sentence.
-* @code{@@pxref}:: How to write a parenthetical cross
reference.
-* @code{@@inforef}:: How to refer to an Info-only file.
-* @code{@@url}:: How to refer to a uniform resource
locator.
-* @code{@@cite}:: How to refer to books not in the Info
system.
+* @t{@@ref}:: A reference for the last part of a
sentence.
+* @t{@@pxref}:: How to write a parenthetical cross
reference.
+* @t{@@inforef}:: How to refer to an Info-only file.
+* @t{@@url}:: How to refer to a uniform resource
locator.
+* @t{@@cite}:: How to refer to books not in the Info
system.
@code{@@xref}
@@ -363,35 +363,35 @@
Quotations and Examples
* Block Enclosing Commands:: Different constructs for different purposes.
-* @code{@@quotation}:: Writing a quotation.
-* @code{@@indentedblock}:: Block of text indented on left.
-* @code{@@example}:: Writing an example in a fixed-width
font.
-* @code{@@verbatim}:: Writing a verbatim example.
-* @code{@@verbatiminclude}:: Including a file verbatim.
-* @code{@@lisp}:: Illustrating Lisp code.
-* @code{@@address@hidden:: Examples in a smaller font.
-* @code{@@display}:: Writing an example in the current font.
-* @code{@@format}:: Writing an example without narrowed
margins.
-* @code{@@exdent}:: Undo indentation on a line.
-* @code{@@flushleft @@flushright}:: Pushing text flush left or flush right.
-* @code{@@raggedright}:: Avoiding justification on the right.
-* @code{@@noindent}:: Preventing paragraph indentation.
-* @code{@@indent}:: Forcing paragraph indentation.
-* @code{@@cartouche}:: Drawing rounded rectangles around text.
+* @t{@@quotation}:: Writing a quotation.
+* @t{@@indentedblock}:: Block of text indented on left.
+* @t{@@example}:: Writing an example in a fixed-width font.
+* @t{@@verbatim}:: Writing a verbatim example.
+* @t{@@verbatiminclude}:: Including a file verbatim.
+* @t{@@lisp}:: Illustrating Lisp code.
+* @t{@@address@hidden:: Examples in a smaller font.
+* @t{@@display}:: Writing an example in the current font.
+* @t{@@format}:: Writing an example without narrowed
margins.
+* @t{@@exdent}:: Undo indentation on a line.
+* @t{@@flushleft @@flushright}:: Pushing text flush left or flush right.
+* @t{@@raggedright}:: Avoiding justification on the right.
+* @t{@@noindent}:: Preventing paragraph indentation.
+* @t{@@indent}:: Forcing paragraph indentation.
+* @t{@@cartouche}:: Drawing rounded rectangles around text.
Lists and Tables
* Introducing Lists:: Texinfo formats lists for you.
-* @code{@@itemize}:: How to construct a simple list.
-* @code{@@enumerate}:: How to construct a numbered list.
+* @t{@@itemize}:: How to construct a simple list.
+* @t{@@enumerate}:: How to construct a numbered list.
* Two-column Tables:: How to construct a two-column table.
* Multi-column Tables:: How to construct generalized tables.
Making a Two-column Table
-* @code{@@table}:: How to construct a two-column table.
-* @code{@@ftable @@vtable}:: Automatic indexing for two-column
tables.
-* @code{@@itemx}:: How to put more entries in the first
column.
+* @t{@@table}:: How to construct a two-column table.
+* @t{@@ftable @@vtable}:: Automatic indexing for two-column
tables.
+* @t{@@itemx}:: How to put more entries in the first
column.
@code{@@multitable}: Multi-column Tables
@@ -406,9 +406,9 @@
Floats
-* @code{@@float}:: Producing floating material.
-* @code{@@caption @@shortcaption}:: Specifying descriptions for floats.
-* @code{@@listoffloats}:: A table of contents for floats.
+* @t{@@float}:: Producing floating material.
+* @t{@@caption @@shortcaption}:: Specifying descriptions for floats.
+* @t{@@listoffloats}:: A table of contents for floats.
Inserting Images
@@ -431,9 +431,9 @@
Combining Indices
-* @code{@@syncodeindex}:: How to merge two indices, using
@code{@@code}
+* @t{@@syncodeindex}:: How to merge two indices, using
@code{@@code}
font for the merged-from index.
-* @code{@@synindex}:: How to merge two indices, using the
+* @t{@@synindex}:: How to merge two indices, using the
roman font for the merged-from index.
Special Insertions
@@ -461,51 +461,51 @@
* Multiple Spaces:: Inserting multiple spaces.
* Not Ending a Sentence:: Sometimes a . doesn't end a sentence.
* Ending a Sentence:: Sometimes it does.
-* @code{@@frenchspacing}:: Specifying end-of-sentence spacing.
-* @code{@@dmn}:: Formatting a dimension.
+* @t{@@frenchspacing}:: Specifying end-of-sentence spacing.
+* @t{@@dmn}:: Formatting a dimension.
Glyphs for Text
-* @code{@@tex}:: The @TeX{} logos.
-* @code{@@copyright}:: The copyright symbol (c in a circle).
-* @code{@@registered}:: 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{@@pounds}:: How to insert the pounds currency symbol.
-* @code{@@textdegree}:: How to insert the degrees symbol.
-* @code{@@minus}:: How to insert a minus sign.
-* @code{@@geq @@leq}:: How to insert greater/less-than-or-equal
signs.
+* @t{@@tex}:: The @TeX{} logos.
+* @t{@@copyright}:: The copyright symbol (c in a circle).
+* @t{@@registered}:: The registered symbol (R in a circle).
+* @t{@@dots}:: How to insert ellipses: @dots{} and @enddots{}
+* @t{@@bullet}:: How to insert a bullet: @bullet{}
+* @t{@@pounds}:: How to insert the pounds currency symbol.
+* @t{@@textdegree}:: How to insert the degrees symbol.
+* @t{@@minus}:: How to insert a minus sign.
+* @t{@@geq @@leq}:: How to insert greater/less-than-or-equal signs.
Glyphs for Programming
* Glyphs Summary::
-* @code{@@result}:: How to show the result of expression.
-* @code{@@expansion}:: How to indicate an expansion.
-* @code{@@print}:: How to indicate generated output.
-* @code{@@error}:: How to indicate an error message.
-* @code{@@equiv}:: How to indicate equivalence.
-* @code{@@point}:: How to indicate the location of point.
+* @t{@@result}:: How to show the result of expression.
+* @t{@@expansion}:: How to indicate an expansion.
+* @t{@@print}:: How to indicate generated output.
+* @t{@@error}:: How to indicate an error message.
+* @t{@@equiv}:: How to indicate equivalence.
+* @t{@@point}:: How to indicate the location of point.
* Click Sequences:: Inserting GUI usage sequences.
Forcing and Preventing Breaks
* Break Commands:: Summary of break-related commands.
* Line Breaks:: Forcing line breaks.
-* @code{@@- @@hyphenation}:: Helping @TeX{} with hyphenation points.
-* @code{@@allowcodebreaks}:: Controlling line breaks within @@code
text.
-* @code{@@w}:: Preventing unwanted line breaks in
text.
-* @code{@@tie}:: Inserting an unbreakable but varying
space.
-* @code{@@sp}:: Inserting blank lines.
-* @code{@@page}:: Forcing the start of a new page.
-* @code{@@group}:: Preventing unwanted page breaks.
-* @code{@@need}:: Another way to prevent unwanted page
breaks.
+* @t{@@- @@hyphenation}:: Helping @TeX{} with hyphenation points.
+* @t{@@allowcodebreaks}:: Controlling line breaks within @@code
text.
+* @t{@@w}:: Preventing unwanted line breaks in text.
+* @t{@@tie}:: Inserting an unbreakable but varying
space.
+* @t{@@sp}:: Inserting blank lines.
+* @t{@@page}:: Forcing the start of a new page.
+* @t{@@group}:: Preventing unwanted page breaks.
+* @t{@@need}:: Another way to prevent unwanted page
breaks.
Definition Commands
* Def Cmd Template:: Writing descriptions using definition commands.
* Def Cmd Continuation Lines:: Continuing the heading over source lines.
* Optional Arguments:: Handling optional and repeated arguments.
-* @code{@@deffnx}:: Group two or more `first' lines.
+* @t{@@deffnx}:: Group two or more `first' lines.
* Def Cmds in Detail:: Reference for all the definition commands.
* Def Cmd Conventions:: Conventions for writing definitions.
* Sample Function Definition:: An example.
@@ -526,8 +526,8 @@
Internationalization
-* @code{@@documentlanguage}:: Declaring the current language.
-* @code{@@documentencoding}:: Declaring the input encoding.
+* @t{@@documentlanguage}:: Declaring the current language.
+* @t{@@documentencoding}:: Declaring the input encoding.
Conditionally Visible Text
@@ -535,22 +535,22 @@
* Conditional Not Commands:: Text for any format other than a given one.
* Raw Formatter Commands:: Using raw formatter commands.
* Inline Conditionals:: Brace-delimited conditional text.
-* @code{@@set @@clear @@value}:: Variable tests and substitutions.
+* @t{@@set @@clear @@value}:: Variable tests and substitutions.
* Conditional Nesting:: Using conditionals inside conditionals.
@code{@@set}, @code{@@clear}, and @code{@@value}
-* @code{@@set @@value}:: Expand a flag variable to a string.
-* @code{@@ifset @@ifclear}:: Format a region if a flag is set.
-* @code{@@value} Example:: An easy way to update edition
information.
+* @t{@@set @@value}:: Expand a flag variable to a string.
+* @t{@@ifset @@ifclear}:: Format a region if a flag is set.
+* @t{@@value} Example:: An easy way to update edition information.
Defining New Texinfo Commands
* Defining Macros:: Defining and undefining new commands.
* Invoking Macros:: Using a macro, once you've defined it.
* Macro Details:: Limitations of Texinfo macros.
-* @code{@@alias}:: Command aliases.
-* @code{@@definfoenclose}:: Customized highlighting.
+* @t{@@alias}:: Command aliases.
+* @t{@@definfoenclose}:: Customized highlighting.
* External Macro Processors:: @code{#line} directives.
External Macro Processors: Line Directives
@@ -562,7 +562,7 @@
Include Files
* Using Include Files:: How to use the @code{@@include} command.
-* @code{texinfo-multiple-files-update}:: How to create and update nodes and
+* @t{texinfo-multiple-files-update}:: How to create and update nodes and
menus when using included files.
* Include Files Requirements:: @code{texinfo-multiple-files-update} needs.
* Sample Include File:: A sample outer file with included files
@@ -573,18 +573,18 @@
Formatting and Printing Hardcopy
* Use @TeX{}:: Use @TeX{} to format for hardcopy.
-* Format with @code{tex}/@code{texindex}:: How to format with explicit shell
commands.
-* Format with @code{texi2dvi}:: A simpler way to format.
-* Print with @code{lpr}:: How to print.
+* Format with @t{tex}/@t{texindex}:: How to format with explicit shell
commands.
+* Format with @t{texi2dvi}:: A simpler way to format.
+* Print with @t{lpr}:: How to print.
* Within Emacs:: How to format and print from an Emacs shell.
* Texinfo Mode Printing:: How to format and print in Texinfo mode.
* Compile-Command:: How to print using Emacs's compile command.
* Requirements Summary:: @TeX{} formatting requirements summary.
* Preparing for @TeX{}:: What to do before you use @TeX{}.
* Overfull hboxes:: What are and what to do with overfull hboxes.
-* @code{@@smallbook}:: How to print small format books and
manuals.
+* @t{@@smallbook}:: How to print small format books and
manuals.
* A4 Paper:: How to print on A4 or A5 paper.
-* @code{@@pagesizes}:: How to print with customized page sizes.
+* @t{@@pagesizes}:: How to print with customized page sizes.
* Cropmarks and Magnification:: How to print marks to indicate the size
of pages and how to print scaled up output.
* PDF Output:: Portable Document Format output.
@@ -593,12 +593,12 @@
@command{texi2any}: The Generic Translator for Texinfo
* Reference Implementation:: @command{texi2any}: the reference implementation.
-* Invoking @code{texi2any}:: Running the translator from a shell.
-* @code{texi2any} Printed Output:: Calling @code{texi2dvi}.
+* Invoking @t{texi2any}:: Running the translator from a shell.
+* @t{texi2any} Printed Output:: Calling @code{texi2dvi}.
* Pointer Validation:: How to check that pointers point somewhere.
* Customization Variables:: Configuring @code{texi2any}.
* Internationalization of Document Strings:: Translating program-inserted text.
-* @code{texi2html}:: An ancestor of @code{texi2any}.
+* @t{texi2html}:: An ancestor of @code{texi2any}.
Customization Variables
@@ -614,9 +614,9 @@
Creating an Info File
-* @code{makeinfo} advantages:: @code{makeinfo} provides better error
checking.
-* @code{makeinfo} in Emacs:: How to run @code{makeinfo} from Emacs.
-* @code{texinfo-format} commands:: Two Info formatting commands written
+* @t{makeinfo} advantages:: @code{makeinfo} provides better error
checking.
+* @t{makeinfo} in Emacs:: How to run @code{makeinfo} from Emacs.
+* @t{texinfo-format} commands:: Two Info formatting commands written
in Emacs Lisp are an alternative
to @code{makeinfo}.
* Batch Formatting:: How to format for Info in Emacs Batch mode.
@@ -631,7 +631,7 @@
located in other directories.
* Installing Dir Entries:: How to specify what menu entry to add
to the Info directory.
-* Invoking @code{install-info}:: @code{install-info} options.
+* Invoking @t{install-info}:: @code{install-info} options.
Generating HTML
@@ -671,16 +671,16 @@
Catching Mistakes
-* @code{makeinfo} Preferred:: @code{makeinfo} finds errors.
+* @t{makeinfo} Preferred:: @code{makeinfo} finds errors.
* Debugging with Info:: How to catch errors with Info formatting.
* Debugging with @TeX{}:: How to catch errors with @TeX{} formatting.
-* Using @code{texinfo-show-structure}:: How to use
@code{texinfo-show-structure}.
-* Using @code{occur}:: How to list all lines containing a
pattern.
-* Running @code{Info-validate}:: How to find badly referenced nodes.
+* Using @t{texinfo-show-structure}:: How to use @code{texinfo-show-structure}.
+* Using @t{occur}:: How to list all lines containing a
pattern.
+* Running @t{Info-validate}:: How to find badly referenced nodes.
Finding Badly Referenced Nodes
-* Using @code{Info-validate}:: How to run @code{Info-validate}.
+* Using @t{Info-validate}:: How to run @code{Info-validate}.
* Unsplit:: How to create an unsplit file.
* Tagifying:: How to tagify a file.
* Splitting:: How to split a file manually.
@@ -1040,7 +1040,7 @@
to write a new back-end for @command{texi2any}, our reference
implementation of a Texinfo parser; it creates a tree representation
of the Texinfo input that you can use for the conversion.
address@hidden Translator @code{texi2any}}.
address@hidden Translator @t{texi2any}}.
Another viable approach is use the Texinfo XML output from
@command{texi2any} as your input. This XML is an essentially complete
@@ -1127,7 +1127,7 @@
Info files are nearly always created by processing a Texinfo source
document. @command{makeinfo}, also known as @command{texi2any}, is
the principal command that converts a Texinfo file into an Info file;
address@hidden Translator @code{texi2any}}.
address@hidden Translator @t{texi2any}}.
Generally, you enter an Info file through a node that by convention is
named `Top'. This node normally contains just a brief summary of the
@@ -1193,7 +1193,7 @@
But you can also print for 7 inch by 9.25 inch pages (address@hidden by
address@hidden, the @code{@@smallbook} size; or on A4 or A5 size paper
(@code{@@afourpaper}, @code{@@afivepaper}).
address@hidden@code{@@smallbook}}, and @ref{A4 Paper}.
address@hidden@t{@@smallbook}}, and @ref{A4 Paper}.
@cindex Literate programming
@TeX{} is freely distributable. It is written in a superset of Pascal
@@ -1307,7 +1307,7 @@
sequence used on some systems; so a @dfn{blank line} means exactly two
consecutive newlines. Sometimes blank lines are useful or convenient
in other cases as well; you can use the @code{@@noindent} to inhibit
-paragraph indentation if required (@address@hidden@@noindent}}).
+paragraph indentation if required (@address@hidden@@noindent}}).
@item
Texinfo supports the usual quotation marks used in English and in
@@ -2440,7 +2440,7 @@
of all the included files before creating and inserting a master menu in
the outer file. The @code{texinfo-multiple-files-update} command is
described in the appendix on @code{@@include} files.
address@hidden@code{texinfo-multiple-files-update}}.
address@hidden@t{texinfo-multiple-files-update}}.
@item M-x texinfo-indent-menu-description
@findex texinfo-indent-menu-description
@@ -2540,7 +2540,7 @@
@code{tex} typesetting command; and then you must run the @code{tex}
command again. Or else run the @code{texi2dvi} command which
automatically creates indices as needed (@pxref{Format with
address@hidden).
address@hidden).
Often, when you are writing a document, you want to typeset and print
only part of a file to see what it will look like. You can use the
@@ -2899,7 +2899,7 @@
well always include them.
Any command that affects document formatting as a whole makes sense to
-include in the header. @code{@@synindex} (@address@hidden@@synindex}}),
+include in the header. @code{@@synindex} (@address@hidden@@synindex}}),
for instance, is another command often included in the header.
Thus, the beginning of a Texinfo file generally looks approximately
@@ -2920,8 +2920,8 @@
@menu
* First Line:: The first line of a Texinfo file.
* Start of Header:: Formatting a region requires this.
-* @code{@@setfilename}:: Tell Info the name of the Info file.
-* @code{@@settitle}:: Create a title for the printed work.
+* @t{@@setfilename}:: Tell Info the name of the Info file.
+* @t{@@settitle}:: Create a title for the printed work.
* End of Header:: Formatting a region requires this.
@end menu
@@ -2978,8 +2978,7 @@
Header}).
The start- and end-of-header lines allow you to format only part of a
-Texinfo file for Info or printing. @address@hidden
-commands}.
+Texinfo file for Info or printing. @address@hidden commands}.
The odd string of characters, @samp{%**}, is to ensure that no other
comment is accidentally taken for a start-of-header line. You can
@@ -2987,7 +2986,7 @@
@code{tex-end-of-header} Emacs variables. @xref{Texinfo Mode Printing}.
address@hidden @code{@@setfilename}
address@hidden @t{@@setfilename}
@subsection @code{@@setfilename}: Set the Output File Name
@address@hidden old name
@@ -3061,10 +3060,10 @@
when generating Info, etc. The @code{\input} line is still ignored in
this processing, as well as leading blank lines.
-See also the @option{--output} option in @ref{Invoking @code{texi2any}}.
+See also the @option{--output} option in @ref{Invoking @t{texi2any}}.
address@hidden @code{@@settitle}
address@hidden @t{@@settitle}
@subsection @code{@@settitle}: Set the Document Title
@address@hidden old name
@@ -3091,7 +3090,7 @@
In the HTML file produced by @command{makeinfo}, @var{title} serves as
the document @samp{<title>}. It also becomes the default document
description in the @samp{<head>} part
-(@address@hidden@@documentdescription}}).
+(@address@hidden@@documentdescription}}).
When the title page is used in the output, the title in the
@code{@@settitle} command does not affect the title as it appears on
@@ -3099,7 +3098,7 @@
practice we recommend is to include the version or edition number of
the manual in the @code{@@settitle} title; on the title page, the
version number generally appears as an @code{@@subtitle} so it would
-be omitted from the @code{@@title}. @address@hidden@@titlepage}}.
+be omitted from the @code{@@title}. @address@hidden@@titlepage}}.
@node End of Header
@@ -3137,12 +3136,12 @@
software license is not necessarily required.
@menu
-* @code{@@copying}:: Declare the document's copying
permissions.
-* @code{@@insertcopying}:: Where to insert the permissions.
+* @t{@@copying}:: Declare the document's copying
permissions.
+* @t{@@insertcopying}:: Where to insert the permissions.
@end menu
address@hidden @code{@@copying}
address@hidden @t{@@copying}
@subsection @code{@@copying}: Declare Copying Permissions
@address@hidden old name
@@ -3220,7 +3219,7 @@
distributed.
address@hidden @code{@@insertcopying}
address@hidden @t{@@insertcopying}
@subsection @code{@@insertcopying}: Include Permissions Text
@address@hidden old name
@@ -3271,10 +3270,10 @@
in the printed manual.
@menu
-* @code{@@titlepage}:: Create a title for the printed
document.
-* @code{@@titlefont @@center @@sp}:: The @code{@@titlefont},
@code{@@center},
+* @t{@@titlepage}:: Create a title for the printed document.
+* @t{@@titlefont @@center @@sp}:: The @code{@@titlefont},
@code{@@center},
and @code{@@sp} commands.
-* @code{@@title @@subtitle @@author}:: The @code{@@title},
@code{@@subtitle},
+* @t{@@title @@subtitle @@author}:: The @code{@@title},
@code{@@subtitle},
and @code{@@author} commands.
* Copyright:: How to write the copyright notice and
include copying permissions.
@@ -3283,7 +3282,7 @@
@end menu
address@hidden @code{@@titlepage}
address@hidden @t{@@titlepage}
@subsection @code{@@titlepage}
@address@hidden old name
@@ -3346,7 +3345,7 @@
page.
address@hidden @code{@@titlefont @@center @@sp}
address@hidden @t{@@titlefont @@center @@sp}
@subsection @code{@@titlefont}, @code{@@center}, and @code{@@sp}
@anchor{titlefont center address@hidden old name
@@ -3365,7 +3364,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 (@address@hidden@@settitle}}).
+the @code{@@titlefont} command (@address@hidden@@settitle}}).
@need 700
For example:
@@ -3393,7 +3392,7 @@
@noindent
This inserts two blank lines on the printed page.
-(@address@hidden@@sp}}, for more information about the @code{@@sp}
+(@address@hidden@@sp}}, for more information about the @code{@@sp}
command.)
A template for this method looks like this:
@@ -3418,7 +3417,7 @@
but since they are not logical markup commands, we don't recommend
them.
address@hidden @code{@@title @@subtitle @@author}
address@hidden @t{@@title @@subtitle @@author}
@subsection @code{@@title}, @code{@@subtitle}, and @code{@@author}
@anchor{title subtitle address@hidden old name
@@ -3435,7 +3434,7 @@
Write the @code{@@title}, @code{@@subtitle}, or @code{@@author}
commands at the beginning of a line followed by the title, subtitle,
or author. The @code{@@author} command may be used for a quotation in
-an @code{@@quotation} block (@address@hidden@@quotation}});
+an @code{@@quotation} block (@address@hidden@@quotation}});
except for that, it is an error to use any of these commands outside
of @code{@@titlepage}.
@@ -3605,14 +3604,14 @@
double-sided headings, (sometimes) using @code{@@setchapternewpage
odd} for double-sided printing and (almost always) no
@code{@@setchapternewpage} command for single-sided printing
-(@address@hidden@@setchapternewpage}}).
+(@address@hidden@@setchapternewpage}}).
@item
Alternatively, you can use the @code{@@headings} command to prevent
page headings from being generated or to start them for either single
or double-sided printing. Write an @code{@@headings} command
immediately after the @code{@@end titlepage} command. To turn off
-headings, write @code{@@headings off}. @address@hidden@@headings}}.
+headings, write @code{@@headings off}. @address@hidden@@headings}}.
@item
Or, you may specify your own page heading and footing format.
@@ -3656,7 +3655,7 @@
Both contents commands should be written on a line by themselves, and
placed near the beginning of the file, after the @code{@@end
-titlepage} (@address@hidden@@titlepage}}), before any sectioning
+titlepage} (@address@hidden@@titlepage}}), before any sectioning
command. The contents commands automatically generate a chapter-like
heading at the top of the first table of contents page, so don't
include any sectioning command such as @code{@@unnumbered} before
@@ -3694,7 +3693,7 @@
You need to include the @code{@@address@hidden
commands early in the document (just after @code{@@setfilename}, for
example). We recommend using @command{texi2dvi} (@pxref{Format with
address@hidden) to specify this without altering the source file at
address@hidden) to specify this without altering the source file at
all. For example:
@example
@@ -3723,7 +3722,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 (@address@hidden@@top} 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
@@ -3854,17 +3853,17 @@
generally all given before the Top node, if they are given at all.
@menu
-* @code{@@documentdescription}:: Document summary for the HTML output.
-* @code{@@setchapternewpage}:: Start chapters on right-hand pages.
-* @code{@@headings}:: An option for turning headings on and off
+* @t{@@documentdescription}:: Document summary for the HTML output.
+* @t{@@setchapternewpage}:: Start chapters on right-hand pages.
+* @t{@@headings}:: An option for turning headings on and off
and double or single sided printing.
-* @code{@@paragraphindent}:: Specify paragraph indentation.
-* @code{@@firstparagraphindent}:: Suppressing first paragraph indentation.
-* @code{@@exampleindent}:: Specify environment indentation.
+* @t{@@paragraphindent}:: Specify paragraph indentation.
+* @t{@@firstparagraphindent}:: Suppressing first paragraph indentation.
+* @t{@@exampleindent}:: Specify environment indentation.
@end menu
address@hidden @code{@@documentdescription}
address@hidden @t{@@documentdescription}
@subsection @code{@@documentdescription}: Summary Text
@address@hidden old name
@@ -3879,7 +3878,7 @@
@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
-(@address@hidden@@settitle}}). To change this, use the
+(@address@hidden@@settitle}}). To change this, use the
@code{@@documentdescription} environment, as in:
@example
@@ -3899,7 +3898,7 @@
the document.
address@hidden @code{@@setchapternewpage}
address@hidden @t{@@setchapternewpage}
@subsection @code{@@setchapternewpage}: Blank Pages Before Chapters
@address@hidden old name
@@ -3956,7 +3955,7 @@
If you don't like the default headers that @code{@@setchapternewpage}
sets, you can explicit control them with the @code{@@headings} command.
address@hidden@code{@@headings}}.
address@hidden@t{@@headings}}.
At the beginning of a manual or book, pages are not numbered---for
example, the title and copyright pages of a book are not numbered. By
@@ -3974,7 +3973,7 @@
specify the output you want.
address@hidden @code{@@headings}
address@hidden @t{@@headings}
@subsection The @code{@@headings} Command
@anchor{headings on address@hidden old name
@@ -4034,7 +4033,7 @@
@xref{Headings, , Page Headings}, for more information.
address@hidden @code{@@paragraphindent}
address@hidden @t{@@paragraphindent}
@subsection @code{@@paragraphindent}: Controlling Paragraph Indentation
@address@hidden old name
@@ -4081,7 +4080,7 @@
fill) paragraphs that contain @code{@@w} or @code{@@*} commands.
address@hidden @code{@@firstparagraphindent}
address@hidden @t{@@firstparagraphindent}
@subsection @code{@@firstparagraphindent}: Indenting After Headings
@address@hidden old name
@@ -4114,7 +4113,7 @@
@item @code{insert}
Include normal paragraph indentation. This respects the paragraph
indentation set by an @code{@@paragraphindent} command
-(@address@hidden@@paragraphindent}}).
+(@address@hidden@@paragraphindent}}).
@end table
@code{@@firstparagraphindent} is ignored for HTML and Docbook output.
@@ -4125,7 +4124,7 @@
Header}.
address@hidden @code{@@exampleindent}
address@hidden @t{@@exampleindent}
@subsection @code{@@exampleindent}: Environment Indenting
@address@hidden old name
@@ -4317,7 +4316,7 @@
like the one above. They also provide information for generating the
table of contents (@pxref{Contents,, Generating a Table of Contents}),
and for implicitly determining node pointers, as is recommended
-(@address@hidden Pointer Creation}).
+(@address@hidden Pointer Creation}).
The chapter structuring commands do not create a node structure, so
normally you put an @code{@@node} command immediately before each
@@ -4330,15 +4329,15 @@
@menu
* Tree Structuring:: A manual is like an upside down tree @dots{}
* Structuring Command Types:: How to divide a manual into parts.
-* @code{@@chapter}:: Chapter structuring.
-* @code{@@unnumbered @@appendix}::
-* @code{@@majorheading @@chapheading}::
-* @code{@@section}::
-* @code{@@unnumberedsec @@appendixsec @@heading}::
-* @code{@@subsection}::
-* @code{@@unnumberedsubsec @@appendixsubsec @@subheading}::
-* @code{@@subsubsection}:: Commands for the lowest level
sections.
-* @code{@@part}:: Collections of chapters.
+* @t{@@chapter}:: Chapter structuring.
+* @t{@@unnumbered @@appendix}::
+* @t{@@majorheading @@chapheading}::
+* @t{@@section}::
+* @t{@@unnumberedsec @@appendixsec @@heading}::
+* @t{@@subsection}::
+* @t{@@unnumberedsubsec @@appendixsubsec @@subheading}::
+* @t{@@subsubsection}:: Commands for the lowest level sections.
+* @t{@@part}:: Collections of chapters.
* Raise/lower sections:: How to change commands' hierarchical level.
@end menu
@@ -4424,7 +4423,7 @@
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 (@address@hidden@@top} Command}). An @code{@@unnumbered} section
+series (@address@hidden@@top} Command}). An @code{@@unnumbered} section
is a normal part of the document structure.
@item
@@ -4437,7 +4436,7 @@
When an @code{@@setchapternewpage} command says to do so, the
@code{@@chapter}, @code{@@unnumbered}, and @code{@@appendix} commands
start new pages in the printed manual; the @code{@@heading} commands
-do not. @address@hidden@@setchapternewpage}}.
+do not. @address@hidden@@setchapternewpage}}.
Here is a summary:
@@ -4460,7 +4459,7 @@
@end tex
address@hidden @code{@@chapter}
address@hidden @t{@@chapter}
@section @code{@@chapter}: Chapter Structuring
@address@hidden old name
@@ -4502,7 +4501,7 @@
that includes all the following sections, up to the next chapter.
address@hidden @code{@@unnumbered @@appendix}
address@hidden @t{@@unnumbered @@appendix}
@section @code{@@unnumbered}, @code{@@appendix}: Chapters with Other Labeling
@anchor{unnumbered & address@hidden old name
@@ -4527,7 +4526,7 @@
@c but the Hacker's Dictionary wanted it, before they quit Texinfo.
address@hidden @code{@@majorheading @@chapheading}
address@hidden @t{@@majorheading @@chapheading}
@section @code{@@majorheading}, @code{@@chapheading}: Chapter-level Headings
@anchor{majorheading & address@hidden old name
@@ -4550,10 +4549,10 @@
@code{@@chapter}: the title is printed on a line by itself with a line
of asterisks underneath. Similarly for HTML. The only difference is
the lack of numbering and the lack of any association with nodes.
address@hidden@code{@@chapter}}.
address@hidden@t{@@chapter}}.
address@hidden @code{@@section}
address@hidden @t{@@section}
@section @code{@@section}: Sections Below Chapters
@address@hidden old name
@@ -4589,10 +4588,10 @@
Section titles are listed in the table of contents.
The @TeX{}, HTML, Docbook, and XML output is all analogous to the
-chapter-level output, just ``one level down''; @address@hidden@@chapter}}.
+chapter-level output, just ``one level down''; @address@hidden@@chapter}}.
address@hidden @code{@@unnumberedsec @@appendixsec @@heading}
address@hidden @t{@@unnumberedsec @@appendixsec @@heading}
@section @code{@@unnumberedsec}, @code{@@appendixsec}, @code{@@heading}
@anchor{unnumberedsec appendixsec address@hidden old name
@@ -4632,14 +4631,14 @@
@end table
address@hidden @code{@@subsection}
address@hidden @t{@@subsection}
@section @code{@@subsection}: Subsections Below Sections
@address@hidden old name
@findex subsection
Subsections are to sections as sections are to chapters;
address@hidden@code{@@section}}. In Info and plain text, subsection titles
address@hidden@t{@@section}}. In Info and plain text, subsection titles
are underlined with @samp{-}. For example,
@example
@@ -4660,10 +4659,10 @@
The @TeX{}, HTML, Docbook, and XML output is all analogous to the
chapter-level output, just ``two levels down'';
address@hidden@code{@@chapter}}.
address@hidden@t{@@chapter}}.
address@hidden @code{@@unnumberedsubsec @@appendixsubsec @@subheading}
address@hidden @t{@@unnumberedsubsec @@appendixsubsec @@subheading}
@section The @code{@@subsection}-like Commands
@anchor{unnumberedsubsec appendixsubsec address@hidden old name
@@ -4675,12 +4674,12 @@
The @code{@@unnumberedsubsec}, @code{@@appendixsubsec}, and
@code{@@subheading} commands are, respectively, the unnumbered,
appendix-like, and heading-like equivalents of the @code{@@subsection}
-command. (@address@hidden@@subsection}}.)
+command. (@address@hidden@@subsection}}.)
@code{@@unnumberedsubsec} and @code{@@appendixsubsec} do not need to
be used in ordinary circumstances, because @code{@@subsection} may
also be used within sections of @code{@@unnumbered} and
address@hidden@@appendix} chapters (@address@hidden@@section}}).
address@hidden@@appendix} chapters (@address@hidden@@section}}).
An @code{@@subheading} command produces a heading like that of a
subsection except that it is not numbered and does not appear in the
@@ -4693,7 +4692,7 @@
underlined with hyphens.
address@hidden @code{@@subsubsection}
address@hidden @t{@@subsubsection}
@section @code{@@subsection} and Other Subsub Commands
@address@hidden old name
@@ -4709,7 +4708,7 @@
@table @code
@item @@subsubsection
Subsubsections are to subsections as subsections are to sections.
-(@address@hidden@@subsection}}.) Subsubsection titles appear in the
+(@address@hidden@@subsection}}.) Subsubsection titles appear in the
table of contents.
@item @@unnumberedsubsubsec
@@ -4731,7 +4730,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
-(@address@hidden@@section}}).
+(@address@hidden@@section}}).
In Info, `subsub' titles are underlined with periods. For example,
@@ -4750,10 +4749,10 @@
@end example
The @TeX{}, HTML, Docbook, and XML output is all analogous to the
-chapter-level output, just ``three levels down''; @address@hidden@@chapter}}.
+chapter-level output, just ``three levels down''; @address@hidden@@chapter}}.
address@hidden @code{@@part}
address@hidden @t{@@part}
@section @code{@@part}: Groups of Chapters
@findex part
@cindex Part pages
@@ -4796,7 +4795,7 @@
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
-(@address@hidden@@setchapternewpage}}).
+(@address@hidden@@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
@@ -4845,7 +4844,7 @@
sections in the main file would also be lowered.)
If the included file being lowered has an @code{@@top} node, you'll
-need to conditionalize its inclusion with a flag (@address@hidden@@set
+need to conditionalize its inclusion with a flag (@address@hidden@@set
@@value}}).
Another difficulty can arise with documents that use the (recommended)
@@ -4894,14 +4893,14 @@
@xref{HTML Xref Link Preservation}.
@menu
-* @code{@@node}:: Creating nodes, in detail.
-* @code{makeinfo} Pointer Creation:: Letting makeinfo determine node pointers.
-* @code{@@anchor}:: Defining arbitrary cross reference
targets.
+* @t{@@node}:: Creating nodes, in detail.
+* @t{makeinfo} Pointer Creation:: Letting makeinfo determine node pointers.
+* @t{@@anchor}:: Defining arbitrary cross reference targets.
* Node Menu Illustration:: A diagram, and sample nodes and menus.
@end menu
address@hidden @code{@@node}
address@hidden @t{@@node}
@section The @code{@@node} Command
@address@hidden node
@@ -4924,7 +4923,7 @@
Requirements}). The subsequent arguments are optional---they are the
names of the `Next', `Previous', and `Up' pointers, in that order. We
strongly recommend omitting them if your Texinfo document is
-hierarchically organized, as virtually all are (@address@hidden
+hierarchically organized, as virtually all are (@address@hidden
Pointer Creation}). You may insert spaces before or after each name
on the @code{@@node} line if you wish; such spaces are ignored.
@@ -4948,7 +4947,7 @@
printing, even if you do not intend to format it for Info; and you
must include a chapter-structuring command after a node for it to be a
valid cross reference target (to @TeX{}). You can use @code{@@anchor}
-(@address@hidden@@anchor}}) to make cross references to an arbitrary
+(@address@hidden@@anchor}}) to make cross references to an arbitrary
position in a document.
Cross references, such as the one at the end of this sentence, are
@@ -4960,7 +4959,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.
+* @t{@@top} Command:: How to use the @code{@@top} command.
@end menu
@@ -4996,7 +4995,7 @@
The pointers from a given node enable you to reach other nodes and
consist simply of the names of those nodes. The pointers are usually
not specified explicitly, as @command{makeinfo} can determine them
-(@address@hidden Pointer Creation}).
+(@address@hidden Pointer Creation}).
Normally, a node's `Up' pointer contains the name of the node whose
menu mentions that node. The node's `Next' pointer contains the name
@@ -5028,7 +5027,7 @@
provided by Texinfo mode to insert the names of the pointers; or
(recommended), you can leave the pointers out of the Texinfo file and
let @code{makeinfo} insert node pointers into the Info file it
-creates. (@xref{Texinfo Mode}, and @address@hidden Pointer
+creates. (@xref{Texinfo Mode}, and @address@hidden Pointer
Creation}.)
Alternatively, you can insert the `Next', `Previous', and `Up'
@@ -5099,7 +5098,7 @@
@item
The next/previous/up pointers on @code{@@node} lines must be the names
of nodes. (It's recommended to leave out these explicit node pointer
-names, which automatically avoids any problem here; @address@hidden
+names, which automatically avoids any problem here; @address@hidden
Pointer Creation}.)
@item
@@ -5149,7 +5148,7 @@
resulting substandard Info output, in order not to confuse the Texinfo
processors, you must still escape those characters, by using either
special insertions (@pxref{Inserting a Comma}) or @code{@@asis}
-(@address@hidden@@asis}}). For example:
+(@address@hidden@@asis}}). For example:
@example
@@node foo@@address@hidden::@}bar
@@ -5237,7 +5236,7 @@
@end example
address@hidden @code{@@top} Command
address@hidden @t{@@top} Command
@subsection The @code{@@top} Sectioning Command
@anchor{top address@hidden old name
@@ -5252,7 +5251,7 @@
(needed if your manual uses implicit node pointers).
It produces the same sort of output as @code{@@unnumbered}
-(@address@hidden@@unnumbered @@appendix}}).
+(@address@hidden@@unnumbered @@appendix}}).
The @code{@@top} node is conventionally wrapped in an
@code{@@ifnottex} conditional so that it will not appear in @TeX{}
@@ -5273,7 +5272,7 @@
(@pxref{Raise/lower sections}).
address@hidden @code{makeinfo} Pointer Creation
address@hidden @t{makeinfo} Pointer Creation
@section @code{makeinfo} Pointer Creation
@cindex Creating pointers with @code{makeinfo}
@@ -5310,7 +5309,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@code{@@top} Command}.
address@hidden@t{@@top} Command}.
@cindex Detail menu
@findex detailmenu
@@ -5327,7 +5326,7 @@
pointers may still be specified explicitly, in full generality.
address@hidden @code{@@anchor}
address@hidden @t{@@anchor}
@section @code{@@anchor}: Defining Arbitrary Cross Reference Targets
@address@hidden old name
@@ -5430,7 +5429,7 @@
name of the `Previous' node is address@hidden'', and the name of the
`Up' node is ``Top''. You can (and should) omit writing out these
node names if your document is hierarchically organized
-(@address@hidden Pointer Creation}), but the pointer
+(@address@hidden Pointer Creation}), but the pointer
relationships still obtain.
@quotation Note
@@ -5560,7 +5559,7 @@
structure of the document; even to nodes in a different Info file.
However, we do not recommend making use of this, because it is hard
for readers to follow. Also, the @command{makeinfo} implicit pointer
-creation feature (@address@hidden Pointer Creation}) and GNU
+creation feature (@address@hidden Pointer Creation}) and GNU
Emacs Texinfo mode updating commands work only to create menus of
subordinate nodes in a hierarchically structured document. It is much
better to use cross references to refer to arbitrary nodes.
@@ -5826,13 +5825,13 @@
* References:: What cross references are for.
* Cross Reference Commands:: A summary of the different commands.
* Cross Reference Parts:: A cross reference has several parts.
-* @code{@@xref}:: Begin a reference with `See' @dots{}
+* @t{@@xref}:: Begin a reference with `See' @dots{}
* Top Node Naming:: How to refer to the beginning of another file.
-* @code{@@ref}:: A reference for the last part of a
sentence.
-* @code{@@pxref}:: How to write a parenthetical cross
reference.
-* @code{@@inforef}:: How to refer to an Info-only file.
-* @code{@@url}:: How to refer to a uniform resource
locator.
-* @code{@@cite}:: How to refer to books not in the Info
system.
+* @t{@@ref}:: A reference for the last part of a
sentence.
+* @t{@@pxref}:: How to write a parenthetical cross
reference.
+* @t{@@inforef}:: How to refer to an Info-only file.
+* @t{@@url}:: How to refer to a uniform resource
locator.
+* @t{@@cite}:: How to refer to books not in the Info
system.
@end menu
@node References
@@ -5863,7 +5862,7 @@
In HTML, a cross reference results in an hyperlink.
The various cross reference commands use nodes (or anchors,
address@hidden@code{@@anchor}}) to define cross reference locations. This is
address@hidden@t{@@anchor}}) to define cross reference locations. This is
evident in Info and HTML, in which a cross reference takes you to the
specified location.
@@ -5906,7 +5905,7 @@
@noindent
The @code{@@cite} command is used to make references to books and
manuals for which there is no corresponding Info file and, therefore,
-no node to which to point. @address@hidden@@cite}}.
+no node to which to point. @address@hidden@@cite}}.
@node Cross Reference Parts
@@ -6022,7 +6021,7 @@
formatters may not find the reference.
address@hidden @code{@@xref}
address@hidden @t{@@xref}
@section @code{@@xref}
@address@hidden old name
@@ -6080,7 +6079,7 @@
the cross reference automatically. You must write that period or
comma yourself; otherwise, Info will not recognize the end of the
reference. (The @code{@@pxref} command works differently;
address@hidden@code{@@pxref}}.)
address@hidden@t{@@pxref}}.)
@quotation Caution
A period or comma @emph{must} follow the closing brace of an
@@ -6090,7 +6089,7 @@
@code{@@xref} must refer to a node by name. Use @code{@@node} to
define the node (@pxref{Writing a Node}), or @code{@@anchor}
-(@address@hidden@@anchor}}).
+(@address@hidden@@anchor}}).
@code{@@xref} is followed by several arguments inside braces,
separated by commas. Whitespace before and after these commas is
@@ -6551,7 +6550,7 @@
third argument in whole-manual cross references is preferable.
address@hidden @code{@@ref}
address@hidden @t{@@ref}
@section @code{@@ref}
@address@hidden old name
@@ -6620,7 +6619,7 @@
``See'') is ok, @code{@@xref} and @code{@@pxref} are preferable.
address@hidden @code{@@pxref}
address@hidden @t{@@pxref}
@section @code{@@pxref}
@address@hidden old name
@@ -6705,7 +6704,7 @@
in a printed manual.
@code{@@pxref} can be used with up to five arguments, just like
address@hidden@@xref} (@address@hidden@@xref}}).
address@hidden@@xref} (@address@hidden@@xref}}).
In past versions of Texinfo, it was not allowed to write punctuation
after an @code{@@pxref}, so it could be used @emph{only} before a
@@ -6735,7 +6734,7 @@
that location breaks up the flow of reading.
address@hidden @code{@@inforef}
address@hidden @t{@@inforef}
@section @code{@@inforef}: Cross References to Info-only Material
@address@hidden old name
@@ -6812,10 +6811,10 @@
The converse of @code{@@inforef} is @code{@@cite}, which is used to
refer to printed works for which no Info form exists.
address@hidden@code{@@cite}}.
address@hidden@t{@@cite}}.
address@hidden @code{@@url}
address@hidden @t{@@url}
@section @code{@@url}, @code{@@address@hidden@var{url}[, @var{text}][,
@address@hidden
@address@hidden old name
@@ -6949,7 +6948,7 @@
@code{@@indicateurl} (@pxref{indicateurl, @code{@@indicateurl}}).
address@hidden @code{@@cite}
address@hidden @t{@@cite}
@section @code{@@address@hidden@address@hidden
@address@hidden old name
@@ -6961,7 +6960,7 @@
If a book is written in Texinfo, it is better to use a cross reference
command since a reader can easily follow such a reference in Info.
address@hidden@code{@@xref}}.
address@hidden@t{@@xref}}.
@node Marking Text
@@ -7079,7 +7078,7 @@
@xref{dfn,,@code{@@dfn}}.
@item @@address@hidden@address@hidden
-Indicate the name of a book. @address@hidden@@cite}}.
+Indicate the name of a book. @address@hidden@@cite}}.
@item @@address@hidden@address@hidden
Indicate an abbreviation, such as `Comput.'.
@@ -7091,7 +7090,7 @@
@item @@address@hidden@address@hidden
Indicate an example (that is, nonfunctional) uniform resource locator.
@xref{indicateurl,,@code{@@indicateurl}}. (Use @code{@@url}
-(@address@hidden@@url}}) for live urls.)
+(@address@hidden@@url}}) for live urls.)
@item @@address@hidden@var{email-address}[, @address@hidden
Indicate an electronic mail address.
@@ -7187,14 +7186,14 @@
By default, @TeX{} will consider breaking lines at @samp{-} and
@samp{_} characters within @code{@@code} and related commands. This
can be controlled with @code{@@allowcodebreaks}
-(@address@hidden@@allowcodebreaks}}). The HTML output attempts to
+(@address@hidden@@allowcodebreaks}}). The HTML output attempts to
respect this for @samp{-}, but ultimately it is up to the browser's
behavior. For Info, it seems better never to make such breaks.
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
-(@address@hidden@@example}}) and @code{@@code} itself, etc.
+(@address@hidden@@example}}) and @code{@@code} itself, etc.
@node kbd
@@ -7785,7 +7784,7 @@
Use the @code{@@indicateurl} command to indicate a uniform resource
locator on the World Wide Web. This is purely for markup purposes and
does not produce a link you can follow (use the @code{@@url} or
address@hidden@@uref} command for that, @address@hidden@@url}}).
address@hidden@@uref} command for that, @address@hidden@@url}}).
@code{@@indicateurl} is useful for urls which do not actually exist.
For example:
@@ -7948,7 +7947,7 @@
The effect is to reduce the body font to a address@hidden size (the
default is address@hidden). Fonts for other elements, such as sections
and chapters, are reduced accordingly. This should only be used in
-conjunction with @code{@@smallbook} (@address@hidden@@smallbook}}) or
+conjunction with @code{@@smallbook} (@address@hidden@@smallbook}}) or
similar, since address@hidden fonts on standard paper (8.5x11 or A4) are
too small. One reason to use this command is to save pages, and hence
printing cost, for physical books.
@@ -8004,11 +8003,10 @@
names for such infrequently needed features.)
@cindex <lineannotation> Docbook tag
-Only the @code{@@r} command has much use: in example-like
-environments, you can use the @code{@@r} command to write comments in
-the standard roman font instead of the fixed-width font. This looks
-better in printed output, and produces a @code{<lineannotation>} tag
-in Docbook output.
+The @code{@@r} command can be useful in example-like environments, to
+write comments in the standard roman font instead of the fixed-width
+font. This looks better in printed output, and produces a
address@hidden<lineannotation>} tag in Docbook output.
For example,
@@ -8027,9 +8025,18 @@
(+ 2 2) ; @r{Add two plus two.}
@end lisp
-In general, you should avoid using the other font commands. Some of
-them are only useful when documenting functionality of specific font
-effects, such as in @TeX{} and related packages.
+The @code{@@t} command can occasionally be useful to produce output in
+a typewriter font where that is supported (e.g., HTML and PDF), but no
+distinction is needed in Info or plain text: @code{@@address@hidden@}}
+produces @t{foo}, cf. @code{@@address@hidden@}} producing @code{foo}.
+
+For example, we use @code{@@t} in the @code{@@node} commands for this
+manual to specify the Texinfo command names, because the quotes which
address@hidden@@code} outputs look extraneous in that particular context.
+
+In general, the other font commands are unlikely to be useful; they
+exist primarily to make it possible to document the functionality of
+specific font effects, such as in @TeX{} and related packages.
@node Quotations and Examples
@@ -8051,21 +8058,21 @@
@menu
* Block Enclosing Commands:: Different constructs for different purposes.
-* @code{@@quotation}:: Writing a quotation.
-* @code{@@indentedblock}:: Block of text indented on left.
-* @code{@@example}:: Writing an example in a fixed-width
font.
-* @code{@@verbatim}:: Writing a verbatim example.
-* @code{@@verbatiminclude}:: Including a file verbatim.
-* @code{@@lisp}:: Illustrating Lisp code.
-* @code{@@address@hidden:: Examples in a smaller font.
-* @code{@@display}:: Writing an example in the current font.
-* @code{@@format}:: Writing an example without narrowed
margins.
-* @code{@@exdent}:: Undo indentation on a line.
-* @code{@@flushleft @@flushright}:: Pushing text flush left or flush right.
-* @code{@@raggedright}:: Avoiding justification on the right.
-* @code{@@noindent}:: Preventing paragraph indentation.
-* @code{@@indent}:: Forcing paragraph indentation.
-* @code{@@cartouche}:: Drawing rounded rectangles around text.
+* @t{@@quotation}:: Writing a quotation.
+* @t{@@indentedblock}:: Block of text indented on left.
+* @t{@@example}:: Writing an example in a fixed-width font.
+* @t{@@verbatim}:: Writing a verbatim example.
+* @t{@@verbatiminclude}:: Including a file verbatim.
+* @t{@@lisp}:: Illustrating Lisp code.
+* @t{@@address@hidden:: Examples in a smaller font.
+* @t{@@display}:: Writing an example in the current font.
+* @t{@@format}:: Writing an example without narrowed
margins.
+* @t{@@exdent}:: Undo indentation on a line.
+* @t{@@flushleft @@flushright}:: Pushing text flush left or flush right.
+* @t{@@raggedright}:: Avoiding justification on the right.
+* @t{@@noindent}:: Preventing paragraph indentation.
+* @t{@@indent}:: Forcing paragraph indentation.
+* @t{@@cartouche}:: Drawing rounded rectangles around text.
@end menu
@@ -8139,7 +8146,7 @@
indented as a new paragraph.
address@hidden @code{@@quotation}
address@hidden @t{@@quotation}
@section @code{@@quotation}: Block Quotations
@address@hidden old name
@@ -8235,10 +8242,10 @@
@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@code{@@address@hidden
address@hidden@t{@@address@hidden
address@hidden @code{@@indentedblock}
address@hidden @t{@@indentedblock}
@section @code{@@indentedblock}: Indented text blocks
@cindex Indented text block
@findex indentedblock
@@ -8267,10 +8274,10 @@
@findex smallindentedblock
Texinfo also provides a command @code{@@smallindentedblock}, which is
just like @code{@@indentedblock} but uses a smaller font size where
-possible. @address@hidden@@address@hidden
+possible. @address@hidden@@address@hidden
address@hidden @code{@@example}
address@hidden @t{@@example}
@section @code{@@example}: Example Text
@address@hidden old name
@@ -8294,7 +8301,7 @@
@item The output uses a fixed-width font.
@item Texinfo commands @emph{are} expanded; if you want the output to
be the input verbatim, use the @code{@@verbatim} environment instead
-(@address@hidden@@verbatim}}).
+(@address@hidden@@verbatim}}).
@end itemize
For example,
@@ -8332,7 +8339,7 @@
paragraph, and the text that continues afterwards should not be
indented, as in the example above. The @code{@@noindent} command
prevents a piece of text from being indented as if it were a new
-paragraph (@address@hidden@@noindent}}.
+paragraph (@address@hidden@@noindent}}.
If you want to embed code fragments within sentences, instead of
displaying them, use the @code{@@code} command or its relatives
@@ -8342,7 +8349,7 @@
normal roman font, you can use the @code{@@r} command (@pxref{Fonts}).
address@hidden @code{@@verbatim}
address@hidden @t{@@verbatim}
@section @code{@@verbatim}: Literal Text
@address@hidden old name
@@ -8412,7 +8419,7 @@
@code{@@verbatim} inside other Texinfo constructs.
address@hidden @code{@@verbatiminclude}
address@hidden @t{@@verbatiminclude}
@section @code{@@verbatiminclude} @var{file}: Include a File Verbatim
@address@hidden old name
@@ -8428,11 +8435,11 @@
@end example
The contents of @var{filename} is printed in a verbatim environment
-(@address@hidden@@verbatim}}). Generally, the file is printed exactly
+(@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
@code{@@verbatiminclude} within @code{@@example}
-(@address@hidden@@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
@@ -8450,7 +8457,7 @@
the end of the previous section on @code{@@verbatim}.
address@hidden @code{@@lisp}
address@hidden @t{@@lisp}
@section @code{@@lisp}: Marking a Lisp Example
@address@hidden old name
@@ -8476,7 +8483,7 @@
itself.
address@hidden @code{@@address@hidden
address@hidden @t{@@address@hidden
@section @code{@@address@hidden Block Commands
@address@hidden old name
@@ -8533,7 +8540,7 @@
consistently within a chapter.
address@hidden @code{@@display}
address@hidden @t{@@display}
@section @code{@@display}: Examples Using the Text Font
@address@hidden old name
@@ -8554,16 +8561,16 @@
@findex smalldisplay
Texinfo also provides the environment @code{@@smalldisplay}, which is
like @code{@@display} but uses a smaller font size.
address@hidden@code{@@address@hidden
address@hidden@t{@@address@hidden
-The @code{@@table} command (@address@hidden@@table}}) is not supported
+The @code{@@table} command (@address@hidden@@table}}) is not supported
inside @code{@@display}. Since @code{@@display} is line-oriented, it
doesn't make sense to use them together. If you want to indent a
-table, try @code{@@quotation} (@address@hidden@@quotation}}) or
address@hidden@@indentedblock} (@address@hidden@@indentedblock}}).
+table, try @code{@@quotation} (@address@hidden@@quotation}}) or
address@hidden@@indentedblock} (@address@hidden@@indentedblock}}).
address@hidden @code{@@format}
address@hidden @t{@@format}
@section @code{@@format}: Examples Using the Full Line Width
@address@hidden old name
@@ -8583,10 +8590,10 @@
@findex smallformat
Texinfo also provides the environment @code{@@smallformat}, which is
like @code{@@format} but uses a smaller font size.
address@hidden@code{@@address@hidden
address@hidden@t{@@address@hidden
address@hidden @code{@@exdent}
address@hidden @t{@@exdent}
@section @code{@@exdent}: Undoing a Line's Indentation
@address@hidden old name
@@ -8631,7 +8638,7 @@
@code{@@exdent} has no effect in HTML output.
address@hidden @code{@@flushleft @@flushright}
address@hidden @t{@@flushleft @@flushright}
@section @code{@@flushleft} and @code{@@flushright}
@anchor{flushleft & address@hidden old name
@@ -8695,7 +8702,7 @@
@end flushright
address@hidden @code{@@raggedright}
address@hidden @t{@@raggedright}
@section @code{@@raggedright}: Ragged Right Text
@address@hidden old name
@@ -8738,7 +8745,7 @@
@end raggedright
address@hidden @code{@@noindent}
address@hidden @t{@@noindent}
@section @code{@@noindent}: Omitting Indentation
@address@hidden old name
@@ -8752,7 +8759,7 @@
paragraph. You can prevent this on a case-by-case basis by writing
@code{@@noindent} at the beginning of a line, preceding the continuation
text. You can also disable indentation for all paragraphs globally with
address@hidden@@paragraphindent} (@address@hidden@@paragraphindent}}).
address@hidden@@paragraphindent} (@address@hidden@@paragraphindent}}).
It is best to write @code{@@noindent} on a line by itself, since in most
environments, spaces following the command will not be ignored. It's ok
@@ -8804,7 +8811,7 @@
paragraphs (@pxref{Command Syntax}).
address@hidden @code{@@indent}
address@hidden @t{@@indent}
@section @code{@@indent}: Forcing Indentation
@address@hidden old name
@@ -8819,7 +8826,7 @@
paragraph to be indented. This paragraph, for instance, is indented
using an @code{@@indent} command. The first paragraph of a section is
the most likely place to use @code{@@indent}, to override the normal
-behavior of no indentation there (@address@hidden@@paragraphindent}}).
+behavior of no indentation there (@address@hidden@@paragraphindent}}).
It is best to write @code{@@indent} on a line by itself, since in most
environments, spaces following the command will not be ignored. The
@@ -8834,7 +8841,7 @@
paragraphs (@pxref{Command Syntax}).
address@hidden @code{@@cartouche}
address@hidden @t{@@cartouche}
@section @code{@@cartouche}: Rounded Rectangles
@address@hidden old name
@@ -8875,7 +8882,7 @@
@end example
@end cartouche
address@hidden@@cartouche} also implies @code{@@group}
(@address@hidden@@group}}).
address@hidden@@cartouche} also implies @code{@@group}
(@address@hidden@@group}}).
@node Lists and Tables
@@ -8890,8 +8897,8 @@
@menu
* Introducing Lists:: Texinfo formats lists for you.
-* @code{@@itemize}:: How to construct a simple list.
-* @code{@@enumerate}:: How to construct a numbered list.
+* @t{@@itemize}:: How to construct a simple list.
+* @t{@@enumerate}:: How to construct a numbered list.
* Two-column Tables:: How to construct a two-column table.
* Multi-column Tables:: How to construct generalized tables.
@end menu
@@ -8968,7 +8975,7 @@
@end table
address@hidden @code{@@itemize}
address@hidden @t{@@itemize}
@section @code{@@itemize}: Making an Itemized List
@address@hidden old name
@@ -9081,7 +9088,7 @@
@end quotation
address@hidden @code{@@enumerate}
address@hidden @t{@@enumerate}
@section @code{@@enumerate}: Making a Numbered or Lettered List
@address@hidden old name
@@ -9089,7 +9096,7 @@
@cindex Enumeration
@code{@@enumerate} is like @code{@@itemize}
-(@address@hidden@@itemize}}), except that the labels on the items are
+(@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
@@ -9207,18 +9214,18 @@
@findex table
@code{@@table} is similar to @code{@@itemize}
-(@address@hidden@@itemize}}), but allows you to specify a name or
+(@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.
-* @code{@@ftable @@vtable}:: Automatic indexing for two-column
tables.
-* @code{@@itemx}:: How to put more entries in the first
column.
+* @t{@@table}:: How to construct a two-column table.
+* @t{@@ftable @@vtable}:: Automatic indexing for two-column
tables.
+* @t{@@itemx}:: How to put more entries in the first
column.
@end menu
address@hidden @code{@@table}
address@hidden @t{@@table}
@subsection Using the @code{@@table} Command
@address@hidden old name
@@ -9239,7 +9246,7 @@
column to be output as if it had been the argument to an @code{@@code}
command.
address@hidden@code{@@address@hidden command name with @, for consistency
address@hidden@t{@@address@hidden command name with @, for consistency
@findex asis
You may also use the @code{@@asis} command as an argument to
@code{@@table}. @code{@@asis} is a command that does nothing; if you
@@ -9300,10 +9307,10 @@
@end table
If you want to list two or more named items with a single block of
-text, use the @code{@@itemx} command. (@address@hidden@@itemx}}.)
+text, use the @code{@@itemx} command. (@address@hidden@@itemx}}.)
address@hidden @code{@@ftable @@vtable}
address@hidden @t{@@ftable @@vtable}
@subsection @code{@@ftable} and @code{@@vtable}
@anchor{ftable address@hidden old name
@@ -9332,7 +9339,7 @@
See the example for @code{@@table} in the previous section.
address@hidden @code{@@itemx}
address@hidden @t{@@itemx}
@subsection @code{@@itemx}: Second and Subsequent Items
@address@hidden old name
@@ -9559,16 +9566,16 @@
formats.) In the present version of Texinfo, however, this floating
is unfortunately not yet implemented. Instead, the floating material
is simply output at the current location, more or less as if it were
-an @code{@@group} (@address@hidden@@group}}).
+an @code{@@group} (@address@hidden@@group}}).
@menu
-* @code{@@float}:: Producing floating material.
-* @code{@@caption @@shortcaption}:: Specifying descriptions for floats.
-* @code{@@listoffloats}:: A table of contents for floats.
+* @t{@@float}:: Producing floating material.
+* @t{@@caption @@shortcaption}:: Specifying descriptions for floats.
+* @t{@@listoffloats}:: A table of contents for floats.
@end menu
address@hidden @code{@@float}
address@hidden @t{@@float}
@subsection @code{@@float} address@hidden,@var{label}]: Floating Material
@address@hidden old name
@@ -9608,7 +9615,7 @@
@item label
Specifies a cross reference label for this float. If given, this
float is automatically given a number, and will appear in any
address@hidden@@listoffloats} output (@address@hidden@@listoffloats}}). Cross
address@hidden@@listoffloats} output (@address@hidden@@listoffloats}}). Cross
references to @var{label} are allowed.
@cindex Floats, making unnumbered
@@ -9634,7 +9641,7 @@
These numbering conventions are not, at present, changeable.
address@hidden @code{@@caption @@shortcaption}
address@hidden @t{@@caption @@shortcaption}
@subsection @code{@@caption} & @code{@@shortcaption}
@anchor{caption address@hidden old name
@@ -9691,7 +9698,7 @@
there is an @code{@@shortcaption}.
address@hidden @code{@@listoffloats}
address@hidden @t{@@listoffloats}
@subsection @code{@@listoffloats}: Tables of Contents for Floats
@address@hidden old name
@@ -9701,7 +9708,7 @@
@cindex Table of contents, for floats
You can write an @code{@@listoffloats} command to generate a list of
-floats for a given float type (@address@hidden@@float}}), analogous to
+floats for a given float type (@address@hidden@@float}}), analogous to
the document's overall table of contents. Typically, it is written in
its own @code{@@unnumbered} node to provide a heading and structure,
rather like @code{@@printindex} (@pxref{Printing Indices & Menus}).
@@ -9723,7 +9730,7 @@
Without any argument, @code{@@listoffloats} generates a list of floats
for which no float type was specified, i.e., no first argument to the
address@hidden@@float} command (@address@hidden@@float}}).
address@hidden@@float} command (@address@hidden@@float}}).
Each line in the list of floats contains the float type (if any),
the float number, and the caption, if any---the @code{@@shortcaption}
@@ -9832,7 +9839,7 @@
will ordinarily be displayed on a line by itself, respecting the
current environment indentation, but without the normal paragraph
indentation. If you want it centered, use @code{@@center}
-(@address@hidden@@titlefont @@center @@sp}}).
+(@address@hidden@@titlefont @@center @@sp}}).
@cindex Alt attribute for images
@cindex Images, alternate text for
@@ -9844,7 +9851,7 @@
processed as Texinfo text, so special characters such as @samp{"} and
@samp{<} and @samp{&} are escaped in the HTML output; also, you can
get an empty @code{alt} string with @code{@@-} (a command that
-produces no output; @address@hidden@@- @@hyphenation}}).
+produces no output; @address@hidden@@- @@hyphenation}}).
For Info output, the @code{alt} string is also processed as Texinfo
text and output. In this case, @samp{\} is escaped as @samp{\\} and
@@ -10347,14 +10354,14 @@
@code{@@code}.
@menu
-* @code{@@syncodeindex}:: How to merge two indices, using
@code{@@code}
+* @t{@@syncodeindex}:: How to merge two indices, using
@code{@@code}
font for the merged-from index.
-* @code{@@synindex}:: How to merge two indices, using the
+* @t{@@synindex}:: How to merge two indices, using the
roman font for the merged-from index.
@end menu
address@hidden @code{@@syncodeindex}
address@hidden @t{@@syncodeindex}
@subsection @code{@@syncodeindex}: Combining indices using @code{@@code}
@findex syncodeindex
@@ -10424,7 +10431,7 @@
@code{@@code} font as you would expect.
address@hidden @code{@@synindex}
address@hidden @t{@@synindex}
@subsection @code{@@synindex}: Combining indices
@findex synindex
@@ -10788,8 +10795,8 @@
* Multiple Spaces:: Inserting multiple spaces.
* Not Ending a Sentence:: Sometimes a . doesn't end a sentence.
* Ending a Sentence:: Sometimes it does.
-* @code{@@frenchspacing}:: Specifying end-of-sentence spacing.
-* @code{@@dmn}:: Formatting a dimension.
+* @t{@@frenchspacing}:: Specifying end-of-sentence spacing.
+* @t{@@dmn}:: Formatting a dimension.
@end menu
@@ -10835,7 +10842,7 @@
Do not follow any of these commands with braces.
-To produce a non-breakable space, see @address@hidden@@tie}}.
+To produce a non-breakable space, see @address@hidden@@tie}}.
@node Not Ending a Sentence
@@ -10954,7 +10961,7 @@
ends the sentence; there is no need to use @code{@@.}.
address@hidden @code{@@frenchspacing}
address@hidden @t{@@frenchspacing}
@subsection @code{@@frenchspacing} @var{val}: Control Sentence Spacing
@address@hidden old name
@@ -10999,7 +11006,7 @@
Formats}).
address@hidden @code{@@dmn}
address@hidden @t{@@dmn}
@subsection @code{@@address@hidden@address@hidden: Format a Dimension
@address@hidden old name
@@ -11031,7 +11038,7 @@
Not everyone uses this style. Some people prefer address@hidden'@: or
address@hidden'. In these cases, however, you need to use
address@hidden@@tie} (@address@hidden@@tie}}) or @code{@@w}
(@address@hidden@@w}})
address@hidden@@tie} (@address@hidden@@tie}}) or @code{@@w}
(@address@hidden@@w}})
so that no line break can occur between the number and the dimension.
Also, if you write a period after an abbreviation within a sentence
(as with the `in.'@: above), you should write @samp{@@:} after the
@@ -11067,7 +11074,7 @@
To get the true accented characters output in Info, not just the ASCII
transliterations, it is necessary to specify @code{@@documentencoding}
with an encoding which supports the required characters
-(@address@hidden@@documentencoding}}). In this case, you can also use
+(@address@hidden@@documentencoding}}). In this case, you can also use
non-ASCII (e.g., pre-accented) characters in the source file.
@findex " @r{(umlaut accent)}
@@ -11236,7 +11243,7 @@
@cindex Latin 1
In order to get the symbols for the quotation marks in encoded Info
output, it is necessary to specify @code{@@documentencoding UTF-8}.
-(@address@hidden@@documentencoding}}.) Double guillemets are also
+(@address@hidden@@documentencoding}}.) Double guillemets are also
present in ISO 8859-1 (aka address@hidden) and ISO 8859-15 (aka
address@hidden).
@@ -11330,7 +11337,7 @@
Texinfo does not provide commands for typesetting quotation marks
according to the numerous traditions. Therefore, you have to choose
the commands appropriate for the language of your manual. Sometimes
-aliases (@address@hidden@@alias}}) can simplify the usage and make the
+aliases (@address@hidden@@alias}}) can simplify the usage and make the
source code more readable. For example, in German,
@code{@@quotedblbase} is used for the left double quote, and the right
double quote is the glyph produced by @code{@@quotedblleft}, which is
@@ -11443,20 +11450,20 @@
as @code{makeinfo} is concerned, but @TeX{} is not so lucky.
@menu
-* @code{@@TeX @@LaTeX}:: The @TeX{} logos.
-* @code{@@copyright}:: The copyright symbol (c 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.
-* @code{@@pounds}:: How to insert the pounds currency symbol.
-* @code{@@textdegree}:: How to insert the degrees symbol.
-* @code{@@minus}:: How to insert a minus sign.
-* @code{@@geq @@leq}:: How to insert greater/less-than-or-equal
signs.
+* @t{@@TeX @@LaTeX}:: The @TeX{} logos.
+* @t{@@copyright}:: The copyright symbol (c in a circle).
+* @t{@@registeredsymbol}:: The registered symbol (R in a circle).
+* @t{@@dots}:: How to insert ellipses: @dots{} and @enddots{}
+* @t{@@bullet}:: How to insert a bullet: @bullet{}
+* @t{@@euro}:: How to insert the euro currency symbol.
+* @t{@@pounds}:: How to insert the pounds currency symbol.
+* @t{@@textdegree}:: How to insert the degrees symbol.
+* @t{@@minus}:: How to insert a minus sign.
+* @t{@@geq @@leq}:: How to insert greater/less-than-or-equal signs.
@end menu
address@hidden @code{@@TeX @@LaTeX}
address@hidden @t{@@TeX @@LaTeX}
@subsection @code{@@address@hidden@} (@TeX{}) and @code{@@address@hidden@}
(@LaTeX{})
@address@hidden old name
@@ -11481,7 +11488,7 @@
use both uppercase and lowercase letters.
address@hidden @code{@@copyright}
address@hidden @t{@@copyright}
@subsection @code{@@address@hidden@}} (@copyright{})
@anchor{copyright address@hidden old name
@@ -11496,7 +11503,7 @@
word `Copyright' suffices, according to international treaty.
address@hidden @code{@@registeredsymbol}
address@hidden @t{@@registeredsymbol}
@subsection @code{@@address@hidden@}} (@registeredsymbol{})
@anchor{registered address@hidden old name
@@ -11508,7 +11515,7 @@
@samp{R} inside a circle; in Info, this is @samp{(R)}.
address@hidden @code{@@dots}
address@hidden @t{@@dots}
@subsection @code{@@dots} (@dots{}) and @code{@@enddots} (@enddots{})
@address@hidden old name
@@ -11540,7 +11547,7 @@
much closer together than the dots in the ellipsis.
address@hidden @code{@@bullet}
address@hidden @t{@@bullet}
@subsection @code{@@bullet} (@bullet{})
@address@hidden old name
@@ -11552,10 +11559,10 @@
When you use @code{@@bullet} in @code{@@itemize}, you do not need to
type the braces, because @code{@@itemize} supplies them.
-(@address@hidden@@itemize}}).
+(@address@hidden@@itemize}}).
address@hidden @code{@@euro}
address@hidden @t{@@euro}
@subsection @code{@@euro} (@euro{}): Euro Currency Symbol
@address@hidden old name
@@ -11575,7 +11582,7 @@
@cindex Latin 9, and Euro
In order to get the Euro symbol in encoded Info output, for example,
it is necessary to specify @code{@@documentencoding ISO-8859-15} or
address@hidden@@documentencoding UTF-8} (@address@hidden@@documentencoding}}.)
address@hidden@@documentencoding UTF-8} (@address@hidden@@documentencoding}}.)
The Euro symbol is in ISO 8859-15 (aka address@hidden), and is
@emph{not} in the more widely-used ISO 8859-1 (address@hidden).
@@ -11590,7 +11597,7 @@
instructions.
address@hidden @code{@@pounds}
address@hidden @t{@@pounds}
@subsection @code{@@pounds} (@pounds{}): Pounds Sterling
@address@hidden old name
@@ -11602,7 +11609,7 @@
Otherwise, it is @samp{#}.
address@hidden @code{@@textdegree}
address@hidden @t{@@textdegree}
@subsection @code{@@textdegree} (@textdegree{}): Degrees Symbol
@address@hidden old name
@@ -11614,7 +11621,7 @@
it is an @samp{o}.
address@hidden @code{@@minus}
address@hidden @t{@@minus}
@subsection @code{@@minus} (@minus{}): Inserting a Minus Sign
@address@hidden old name
@@ -11646,7 +11653,7 @@
When you use @code{@@minus} to specify the mark beginning each entry
in an itemized list, you do not need to type the braces
-(@address@hidden@@itemize}}).
+(@address@hidden@@itemize}}).
If you actually want to typeset some math that does a subtraction, it
is better to use @code{@@math}. Then the regular @samp{-} character
@@ -11654,7 +11661,7 @@
Math}).
address@hidden @code{@@geq @@leq}
address@hidden @t{@@geq @@leq}
@subsection @code{@@geq} (@geq{}) and @code{@@leq} (@leq{}): Inserting
Relations
@anchor{geq address@hidden old name
@@ -11688,12 +11695,12 @@
@menu
* Glyphs Summary::
-* @code{@@result}:: How to show the result of expression.
-* @code{@@expansion}:: How to indicate an expansion.
-* @code{@@print}:: How to indicate generated output.
-* @code{@@error}:: How to indicate an error message.
-* @code{@@equiv}:: How to indicate equivalence.
-* @code{@@point}:: How to indicate the location of point.
+* @t{@@result}:: How to show the result of expression.
+* @t{@@expansion}:: How to indicate an expansion.
+* @t{@@print}:: How to indicate generated output.
+* @t{@@error}:: How to indicate an error message.
+* @t{@@equiv}:: How to indicate equivalence.
+* @t{@@point}:: How to indicate the location of point.
* Click Sequences:: Inserting GUI usage sequences.
@end menu
@@ -11729,7 +11736,7 @@
@end table
address@hidden @code{@@result}
address@hidden @t{@@result}
@subsection @code{@@address@hidden@}} (@result{}): Result of an Expression
@address@hidden old name
@@ -11757,7 +11764,7 @@
may be read as address@hidden(cdr '(1 2 3))} evaluates to @code{(2 3)}''.
address@hidden @code{@@expansion}
address@hidden @t{@@expansion}
@subsection @code{@@address@hidden@}} (@expansion{}): Indicating an Expansion
@address@hidden old name
@@ -11810,7 +11817,7 @@
@code{@@address@hidden@}} and @code{@@address@hidden@}} commands are indented.
address@hidden @code{@@print}
address@hidden @t{@@print}
@subsection @code{@@address@hidden@}} (@print{}): Indicating Generated Output
@anchor{Print address@hidden old name
@@ -11853,7 +11860,7 @@
@end lisp
address@hidden @code{@@error}
address@hidden @t{@@error}
@subsection @code{@@address@hidden@}} (@error{}): Indicating an Error Message
@anchor{Error address@hidden old name
@@ -11897,7 +11904,7 @@
The word @address@hidden itself is not part of the error message.
address@hidden @code{@@equiv}
address@hidden @t{@@equiv}
@subsection @code{@@address@hidden@}} (@equiv{}): Indicating Equivalence
@address@hidden oldname
@@ -11931,7 +11938,7 @@
identical results to evaluating @code{(list 'keymap)}.
address@hidden @code{@@point}
address@hidden @t{@@point}
@subsection @code{@@address@hidden@}} (@point{}): Indicating Point in a Buffer
@anchor{Point address@hidden old name
@@ -12026,7 +12033,7 @@
You can change the glyph produced by @code{@@click} with the command
@code{@@clickstyle}, which takes a command name as its single argument
on the rest of the line, much like @code{@@itemize} and friends
-(@address@hidden@@itemize}}). The command should produce a glyph, and
+(@address@hidden@@itemize}}). The command should produce a glyph, and
the usual empty braces @address@hidden@}} are omitted. Here's an example:
@example
@@ -12068,14 +12075,14 @@
@menu
* Break Commands:: Summary of break-related commands.
* Line Breaks:: Forcing line breaks.
-* @code{@@- @@hyphenation}:: Helping @TeX{} with hyphenation points.
-* @code{@@allowcodebreaks}:: Controlling line breaks within @@code
text.
-* @code{@@w}:: Preventing unwanted line breaks in
text.
-* @code{@@tie}:: Inserting an unbreakable but varying
space.
-* @code{@@sp}:: Inserting blank lines.
-* @code{@@page}:: Forcing the start of a new page.
-* @code{@@group}:: Preventing unwanted page breaks.
-* @code{@@need}:: Another way to prevent unwanted page
breaks.
+* @t{@@- @@hyphenation}:: Helping @TeX{} with hyphenation points.
+* @t{@@allowcodebreaks}:: Controlling line breaks within @@code
text.
+* @t{@@w}:: Preventing unwanted line breaks in text.
+* @t{@@tie}:: Inserting an unbreakable but varying
space.
+* @t{@@sp}:: Inserting blank lines.
+* @t{@@page}:: Forcing the start of a new page.
+* @t{@@group}:: Preventing unwanted page breaks.
+* @t{@@need}:: Another way to prevent unwanted page
breaks.
@end menu
@@ -12153,7 +12160,7 @@
@end example
The @code{@@/} command can often be useful within urls
-(@address@hidden@@url}}), which tend to be long and are otherwise
+(@address@hidden@@url}}), which tend to be long and are otherwise
unbreakable. For example:
@example
@@ -12172,7 +12179,7 @@
break the url. @code{@@/} has no effect in other output formats.
address@hidden @code{@@- @@hyphenation}
address@hidden @t{@@- @@hyphenation}
@section @code{@@-} and @code{@@hyphenation}: Helping @TeX{} Hyphenate
@anchor{- and address@hidden old name
@@ -12209,7 +12216,7 @@
these commands have any effect there.
address@hidden @code{@@allowcodebreaks}
address@hidden @t{@@allowcodebreaks}
@section @code{@@allowcodebreaks}: Control Line Breaks in @code{@@code}
@address@hidden old name
@@ -12250,7 +12257,7 @@
This command has no effect except in HTML and @TeX{} output.
address@hidden @code{@@w}
address@hidden @t{@@w}
@section @code{@@address@hidden@address@hidden: Prevent Line Breaks
@address@hidden old name
@@ -12296,7 +12303,7 @@
in Info or plain text output, though.
address@hidden @code{@@tie}
address@hidden @t{@@tie}
@section @code{@@address@hidden@}}: Inserting an Unbreakable Space
@address@hidden old name
@@ -12337,7 +12344,7 @@
@end itemize
address@hidden @code{@@sp}
address@hidden @t{@@sp}
@section @code{@@sp} @var{n}: Insert Blank Lines
@address@hidden old name
@@ -12361,7 +12368,7 @@
The @code{@@sp} command is most often used in the title page.
address@hidden @code{@@page}
address@hidden @t{@@page}
@section @code{@@page}: Start a New Page
@address@hidden old name
@@ -12375,7 +12382,7 @@
page.
address@hidden @code{@@group}
address@hidden @t{@@group}
@section @code{@@group}: Prevent Page Breaks
@address@hidden old name
@@ -12434,7 +12441,7 @@
@TeX{}.
address@hidden @code{@@need}
address@hidden @t{@@need}
@section @code{@@need @var{mils}}: Prevent Page Breaks
@address@hidden old name
@@ -12494,7 +12501,7 @@
* Def Cmd Template:: Writing descriptions using definition commands.
* Def Cmd Continuation Lines:: Continuing the heading over source lines.
* Optional Arguments:: Handling optional and repeated arguments.
-* @code{@@deffnx}:: Group two or more `first' lines.
+* @t{@@deffnx}:: Group two or more `first' lines.
* Def Cmds in Detail:: Reference for all the definition commands.
* Def Cmd Conventions:: Conventions for writing definitions.
* Sample Function Definition:: An example.
@@ -12698,7 +12705,7 @@
@samp{foobar}.
address@hidden @code{@@deffnx}
address@hidden @t{@@deffnx}
@section @code{@@deffnx}, et al.: Two or More `First' Lines
@address@hidden old node
@@ -12737,7 +12744,7 @@
@code{@@defvrx}, @code{@@deftypefunx}, etc.
The `x' forms work similarly to @code{@@itemx}
-(@address@hidden@@itemx}}).
+(@address@hidden@@itemx}}).
@node Def Cmds in Detail
@@ -13562,12 +13569,12 @@
supports, see @ref{Inserting Accents}.
@menu
-* @code{@@documentlanguage}:: Declaring the current language.
-* @code{@@documentencoding}:: Declaring the input encoding.
+* @t{@@documentlanguage}:: Declaring the current language.
+* @t{@@documentencoding}:: Declaring the input encoding.
@end menu
address@hidden @code{@@documentlanguage}
address@hidden @t{@@documentlanguage}
@section @code{@@documentlanguage @address@hidden: Set the Document Language
@anchor{documentlanguage}
@@ -13578,7 +13585,7 @@
The @code{@@documentlanguage} command declares the current document
locale. Write it on a line by itself, near the beginning of the file,
-but after @code{@@setfilename} (@address@hidden@@setfilename}}):
+but after @code{@@setfilename} (@address@hidden@@setfilename}}):
@example
@@documentlanguage @address@hidden
@@ -13626,7 +13633,7 @@
extended @TeX{} programs @command{etex} (DVI output) and
@command{pdftex} (PDF output), such as @TeX{} Live 2008.
@command{texi2dvi} will use the extended @TeX{}s if they are available
-(@pxref{Format with @code{texi2dvi}}).
+(@pxref{Format with @t{texi2dvi}}).
In September 2006, the W3C Internationalization Activity released a
new recommendation for specifying languages:
@@ -13645,7 +13652,7 @@
@url{http://en.wikipedia.org/wiki/ISO_3166}.
address@hidden @code{@@documentencoding}
address@hidden @t{@@documentencoding}
@section @code{@@documentencoding @var{enc}}: Set Input Encoding
@address@hidden old name
@@ -13658,7 +13665,7 @@
The @code{@@documentencoding} command declares the input document
encoding. Write it on a line by itself, with a valid encoding
specification following, near the beginning of the file but after
address@hidden@@setfilename} (@address@hidden@@setfilename}}):
address@hidden@@setfilename} (@address@hidden@@setfilename}}):
@example
@@documentencoding @var{enc}
@@ -13786,7 +13793,7 @@
* Conditional Not Commands:: Text for any format other than a given one.
* Raw Formatter Commands:: Using raw formatter commands.
* Inline Conditionals:: Brace-delimited conditional text.
-* @code{@@set @@clear @@value}:: Variable tests and substitutions.
+* @t{@@set @@clear @@value}:: Variable tests and substitutions.
* Testing for Texinfo Commands:: Testing if a Texinfo command is available.
* Conditional Nesting:: Using conditionals inside conditionals.
@end menu
@@ -14110,7 +14117,7 @@
argument separator.)
address@hidden @code{@@set @@clear @@value}
address@hidden @t{@@set @@clear @@value}
@section @code{@@set}, @code{@@clear}, and @code{@@value}
@anchor{set clear address@hidden old name
@@ -14140,13 +14147,13 @@
@end table
@menu
-* @code{@@set @@value}:: Expand a flag variable to a string.
-* @code{@@ifset @@ifclear}:: Format a region if a flag is set.
-* @code{@@value} Example:: An easy way to update edition
information.
+* @t{@@set @@value}:: Expand a flag variable to a string.
+* @t{@@ifset @@ifclear}:: Format a region if a flag is set.
+* @t{@@value} Example:: An easy way to update edition information.
@end menu
address@hidden @code{@@set @@value}
address@hidden @t{@@set @@value}
@subsection @code{@@set} and @code{@@value}
@anchor{set address@hidden old name
@@ -14244,7 +14251,7 @@
@end example
address@hidden @code{@@ifset @@ifclear}
address@hidden @t{@@ifset @@ifclear}
@subsection @code{@@ifset} and @code{@@ifclear}
@anchor{ifset address@hidden old name
@@ -14317,7 +14324,7 @@
@end example
address@hidden @code{@@value} Example
address@hidden @t{@@value} Example
@subsection @code{@@value} Example
@anchor{value address@hidden old name
@@ -14343,7 +14350,7 @@
@end example
@item
-Write text for the @code{@@copying} section (@address@hidden@@copying}}):
+Write text for the @code{@@copying} section (@address@hidden@@copying}}):
@example
@group
@@ -14566,15 +14573,15 @@
recognize so-called @code{#line} directives for error reporting.
If you want to do simple text substitution, @code{@@set} and
address@hidden@@value} is the simplest approach (@address@hidden@@set @@clear
address@hidden@@value} is the simplest approach (@address@hidden@@set @@clear
@@value}}).
@menu
* Defining Macros:: Defining and undefining new commands.
* Invoking Macros:: Using a macro, once you've defined it.
* Macro Details:: Limitations of Texinfo macros.
-* @code{@@alias}:: Command aliases.
-* @code{@@definfoenclose}:: Customized highlighting.
+* @t{@@alias}:: Command aliases.
+* @t{@@definfoenclose}:: Customized highlighting.
* External Macro Processors:: @code{#line} directives.
@end menu
@@ -14884,7 +14891,7 @@
macro-related errors when producing the printed version of a manual,
you might try expanding the macros with @command{makeinfo} by invoking
@command{texi2dvi} with the @samp{-E} option (@pxref{Format with
address@hidden). Or eschew Texinfo macros altogether and use a
address@hidden). Or eschew Texinfo macros altogether and use a
language designed for macro processing, such as M4 (@pxref{External
Macro Processors}).
@@ -15023,7 +15030,7 @@
@item
@code{@@verbatim} and macros do not mix; for instance, you can't start
a verbatim block inside a macro and end it outside
-(@address@hidden@@verbatim}}). Starting any environment inside a macro
+(@address@hidden@@verbatim}}). Starting any environment inside a macro
and ending it outside may or may not work, for that matter.
@item
@@ -15036,7 +15043,7 @@
@end itemize
address@hidden @code{@@alias}
address@hidden @t{@@alias}
@section @samp{@@alias @address@hidden
@address@hidden old name
@@ -15087,7 +15094,7 @@
character) @samp{-}.
address@hidden @code{@@definfoenclose}
address@hidden @t{@@definfoenclose}
@section @code{@@definfoenclose}: Customized Highlighting
@address@hidden old name
@@ -15228,7 +15235,7 @@
@vindex CPP_LINE_DIRECTIVES
The @command{makeinfo} program recognizes these lines by default,
-except within @code{@@verbatim} blocks (@address@hidden@@verbatim}}.
+except within @code{@@verbatim} blocks (@address@hidden@@verbatim}}.
Their recognition can be turned off completely with
@code{CPP_LINE_DIRECTIVES} (@pxref{Other Customization Variables}),
though there is normally no reason to do so.
@@ -15273,13 +15280,13 @@
@itemize @bullet
@item
If you run @command{texi2dvi} or its variants (@pxref{Format with
address@hidden), you can pass @option{-E} and @command{texi2dvi}
address@hidden), you can pass @option{-E} and @command{texi2dvi}
will run @command{makeinfo} first to expand macros and eliminate
@samp{#line}.
@item
If you run @command{makeinfo} or its variants (@pxref{Generic
-Translator @code{texi2any}}), you can specify @option{--no-ifinfo
+Translator @t{texi2any}}), you can specify @option{--no-ifinfo
--iftex -E somefile.out}, and then give @file{somefile.out} to
@code{texi2dvi} in a separate command.
@@ -15296,7 +15303,7 @@
@TeX{} itself, are the (incorrect) line numbers from the derived file
which @TeX{} is reading, rather than the preprocessor-specified line
numbers. This is another example of why we recommend running
address@hidden for the best diagnostics (@address@hidden
address@hidden for the best diagnostics (@address@hidden
Advantages}).
@@ -15354,7 +15361,7 @@
@menu
* Using Include Files:: How to use the @code{@@include} command.
-* @code{texinfo-multiple-files-update}:: How to create and update nodes and
+* @t{texinfo-multiple-files-update}:: How to create and update nodes and
menus when using included files.
* Include Files Requirements:: @code{texinfo-multiple-files-update} needs.
* Sample Include File:: A sample outer file with included files
@@ -15378,7 +15385,7 @@
@end example
@@-commands are expanded in file names. The one most likely to be
-useful is @code{@@value} (@address@hidden@@set @@value}}), and even then
+useful is @code{@@value} (@address@hidden@@set @@value}}), and even then
only in complicated situations.
An included file should simply be a segment of text that you expect to
@@ -15396,7 +15403,7 @@
@code{@@setfilename} line exists in an included file, it is ignored.
address@hidden @code{texinfo-multiple-files-update}
address@hidden @t{texinfo-multiple-files-update}
@section @code{texinfo-multiple-files-update}
@findex texinfo-multiple-files-update
@@ -15638,18 +15645,18 @@
@menu
* Use @TeX{}:: Use @TeX{} to format for hardcopy.
-* Format with @code{tex}/@code{texindex}:: How to format with explicit shell
commands.
-* Format with @code{texi2dvi}:: A simpler way to format.
-* Print with @code{lpr}:: How to print.
+* Format with @t{tex}/@t{texindex}:: How to format with explicit shell
commands.
+* Format with @t{texi2dvi}:: A simpler way to format.
+* Print with @t{lpr}:: How to print.
* Within Emacs:: How to format and print from an Emacs shell.
* Texinfo Mode Printing:: How to format and print in Texinfo mode.
* Compile-Command:: How to print using Emacs's compile command.
* Requirements Summary:: @TeX{} formatting requirements summary.
* Preparing for @TeX{}:: What to do before you use @TeX{}.
* Overfull hboxes:: What are and what to do with overfull hboxes.
-* @code{@@smallbook}:: How to print small format books and
manuals.
+* @t{@@smallbook}:: How to print small format books and
manuals.
* A4 Paper:: How to print on A4 or A5 paper.
-* @code{@@pagesizes}:: How to print with customized page sizes.
+* @t{@@pagesizes}:: How to print with customized page sizes.
* Cropmarks and Magnification:: How to print marks to indicate the size
of pages and how to print scaled up output.
* PDF Output:: Portable Document Format output.
@@ -15669,8 +15676,9 @@
itself.
address@hidden Format with @code{tex}/@code{texindex}
address@hidden Format with @t{tex}/@t{texindex}
@section Format with @code{tex}/@code{texindex}
+
@cindex Shell formatting with @code{tex} and @code{texindex}
@cindex Formatting with @code{tex} and @code{texindex}
@cindex DVI file
@@ -15768,7 +15776,7 @@
@pindex texi2dvi
Alternatively, it's a one-step process: run @code{texi2dvi}
-(@pxref{Format with @code{texi2dvi}}).
+(@pxref{Format with @t{texi2dvi}}).
You need not run @code{texindex} each time after you run @code{tex}. If
you do not, on the next run, the @code{tex} formatting command will use
@@ -15785,7 +15793,7 @@
gives when cross references are not satisfied are just nuisances. You
can avoid them with the @code{@@novalidate} command, which you must
give @emph{before} the @code{@@setfilename} command
-(@address@hidden@@setfilename}}). Thus, the beginning of your file
+(@address@hidden@@setfilename}}). Thus, the beginning of your file
would look approximately like this:
@example
@@ -15800,8 +15808,9 @@
(@pxref{Pointer Validation}).
address@hidden Format with @code{texi2dvi}
address@hidden Format with @t{texi2dvi}
@section Format with @code{texi2dvi}
+
@pindex texi2dvi @r{(shell script)}
The @code{texi2dvi} command automatically runs both @TeX{} and
@@ -15829,9 +15838,9 @@
This inserts @var{cmd} on a line by itself after the
@code{@@setfilename} in a temporary copy of the input file before
running @TeX{}. With this, you can specify different printing
-formats, such as @code{@@smallbook} (@address@hidden@@smallbook}}),
+formats, such as @code{@@smallbook} (@address@hidden@@smallbook}}),
@code{@@afourpaper} (@pxref{A4 Paper}), or @code{@@pagesizes}
-(@address@hidden@@pagesizes}}), without actually changing the document
+(@address@hidden@@pagesizes}}), without actually changing the document
source. (You can also do this on a site-wide basis with
@file{texinfo.cnf}; @pxref{Preparing for @TeX{}}).
@@ -15893,7 +15902,7 @@
allow conversion of an input document before running @TeX{}. The
@option{--recode} option recodes the document from encoding specified
by @samp{@@documentencoding} command
-(@address@hidden@@documentencoding}}) to plain 7-bit @samp{texinfo}
+(@address@hidden@@documentencoding}}) to plain 7-bit @samp{texinfo}
encoding.
@opindex address@hidden, for @command{texi2dvi}}
@@ -15919,8 +15928,9 @@
For the list of all options, run @samp{texi2dvi --help}.
address@hidden Print with @code{lpr}
address@hidden Print with @t{lpr}
@section Print With @code{lpr -d} From Shell
+
@pindex lpr @r{(DVI print command)}
The precise command to print a DVI file depends on your system
@@ -16199,8 +16209,8 @@
For more information, see:
@itemize @bullet
address@hidden @address@hidden@@settitle}}.
address@hidden @address@hidden@@setchapternewpage}}.
address@hidden @address@hidden@@settitle}}.
address@hidden @address@hidden@@setchapternewpage}}.
@item @ref{Headings}.
@item @ref{Titlepage & Copyright Page}.
@item @ref{Printing Indices & Menus}.
@@ -16250,7 +16260,7 @@
@pindex address@hidden, installing}
@cindex Euro font, installing
If you intend to use the @code{@@euro} command, you should install the
-Euro font, if it is not already installed. @address@hidden@@euro}}.
+Euro font, if it is not already installed. @address@hidden@@euro}}.
@pindex texinfo.cnf @r{installation}
@cindex Customizing of @TeX{} for Texinfo
@@ -16258,7 +16268,7 @@
Optionally, you may create an additional @file{texinfo.cnf}, and
install it as well. This file is read by @TeX{} when the
@code{@@setfilename} command is executed
-(@address@hidden@@setfilename}}). You can put any commands you like
+(@address@hidden@@setfilename}}). You can put any commands you like
there, according to local site-wide conventions. They will be read by
@TeX{} when processing any Texinfo document. For example, if
@file{texinfo.cnf} contains the line @samp{@@afourpaper} (@pxref{A4
@@ -16409,7 +16419,7 @@
@end example
address@hidden @code{@@smallbook}
address@hidden @t{@@smallbook}
@section @code{@@smallbook}: Printing ``Small'' Books
@address@hidden old name
@@ -16440,10 +16450,10 @@
region formatting command, @code{texinfo-tex-region}, will format the
region in ``small'' book size (@pxref{Start of Header}).
address@hidden@code{@@address@hidden, for information about commands that make
address@hidden@t{@@address@hidden, for information about commands that make
it easier to produce examples for a smaller manual.
address@hidden with @code{texi2dvi}}, and @ref{Preparing for @TeX{}},
address@hidden with @t{texi2dvi}}, and @ref{Preparing for @TeX{}},
for other ways to format with @code{@@smallbook} that do not require
changing the source file.
@@ -16473,7 +16483,7 @@
@end group
@end example
address@hidden with @code{texi2dvi}}, and @ref{Preparing for @TeX{}},
address@hidden with @t{texi2dvi}}, and @ref{Preparing for @TeX{}},
for other ways to format for different paper sizes that do not require
changing the source file.
@@ -16484,7 +16494,7 @@
wide format.
address@hidden @code{@@pagesizes}
address@hidden @t{@@pagesizes}
@section @code{@@pagesizes} address@hidden, @var{height}]: Custom Page Sizes
@address@hidden old node name
@@ -16522,7 +16532,7 @@
margins, you must define a new command in @file{texinfo.tex} or
@file{texinfo.cnf}.
address@hidden with @code{texi2dvi}}, and @ref{Preparing for @TeX{}},
address@hidden with @t{texi2dvi}}, and @ref{Preparing for @TeX{}},
for other ways to specify @code{@@pagesizes} that do not require
changing the source file.
@@ -16598,7 +16608,7 @@
The simplest way to generate PDF output from Texinfo source is to run
the convenience script @command{texi2pdf} (or @command{pdftexi2dvi});
this executes the @command{texi2dvi} script with the @option{--pdf}
-option (@pxref{Format with @code{texi2dvi}}). If for some reason you
+option (@pxref{Format with @t{texi2dvi}}). If for some reason you
want to process the document by hand, you can run the @command{pdftex}
program instead of plain @command{tex}. That is, run @samp{pdftex
foo.texi} instead of @samp{tex foo.texi}.
@@ -16647,7 +16657,7 @@
@c please keep that text in sync with www.gnu.org/prep/FTP
address@hidden Generic Translator @code{texi2any}
address@hidden Generic Translator @t{texi2any}
@chapter @code{texi2any}: The Generic Translator for Texinfo
@command{texi2any} is the generic translator for Texinfo that can
@@ -16682,12 +16692,12 @@
@menu
* Reference Implementation:: @command{texi2any}: the reference implementation.
-* Invoking @code{texi2any}:: Running the translator from a shell.
-* @code{texi2any} Printed Output:: Calling @command{texi2dvi}.
+* Invoking @t{texi2any}:: Running the translator from a shell.
+* @t{texi2any} Printed Output:: Calling @command{texi2dvi}.
* Pointer Validation:: How to check that pointers point somewhere.
* Customization Variables:: Configuring @command{texi2any}.
* Internationalization of Document Strings:: Translating program-inserted text.
-* @code{texi2html}:: An ancestor of @command{texi2any}.
+* @t{texi2html}:: An ancestor of @command{texi2any}.
@end menu
@@ -16718,7 +16728,7 @@
implementations (@pxref{History}). The current reference
implementation, @command{texi2any}, inherited the design of
customization and other features from @command{texi2html} (for more on
address@hidden compatibility, @address@hidden).
address@hidden compatibility, @address@hidden).
However, @code{texi2any} is a full reimplementation: it constructs a
tree-based representation of the input document for all back-ends to
work from.
@@ -16731,7 +16741,7 @@
@cindex Examples of using @command{texi2any}
@findex Texinfo::Parser module
-The @command{texi2html} wrapper script (@address@hidden)
+The @command{texi2html} wrapper script (@address@hidden)
provides a simple example of calling @command{texi2any} from a shell
script; it's in @file{util/texi2html} in the Texinfo sources. More
consequentially, @command{texi-elements-by-size} is an example Perl
@@ -16747,7 +16757,7 @@
@command{texi2any}.
address@hidden Invoking @code{texi2any}
address@hidden Invoking @t{texi2any}
@section Invoking @command{texi2any}/@code{makeinfo} from a Shell
@anchor{Invoking makeinfo}
@@ -16768,8 +16778,8 @@
You can specify more than one input file name; each is processed in
turn. If an input file name is @samp{-}, standard input is read.
address@hidden@code{makeinfo} options}
address@hidden anchor{makeinfo options}
address@hidden@t{makeinfo} Options}
address@hidden anchor{makeinfo address@hidden prev name
@cindex @code{makeinfo} options
@cindex Options for @code{makeinfo}
@anchor{texi2any Options}
@@ -16837,7 +16847,7 @@
@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
-(@address@hidden@@set @@clear @@value}}).
+(@address@hidden@@set @@clear @@value}}).
@item --disable-encoding
@itemx --enable-encoding
@@ -16846,7 +16856,7 @@
By default, or with @option{--enable-encoding}, output accented and
special characters in Info and plain text output based on
@samp{@@documentencoding}. With @option{--disable-encoding}, 7-bit
-ASCII transliterations are output. @address@hidden@@documentencoding}},
+ASCII transliterations are output. @address@hidden@@documentencoding}},
and @ref{Inserting Accents}.
@item --docbook
@@ -16858,17 +16868,17 @@
Use @var{lang} to translate Texinfo keywords which end up in the
output document. The default is the locale specified by the
@code{@@documentlanguage} command if there is one, otherwise English
-(@address@hidden@@documentlanguage}}).
+(@address@hidden@@documentlanguage}}).
@item --dvi
@opindex --dvi
Generate a TeX DVI file using @command{texi2dvi}, rather than Info
-(@address@hidden Printed Output}).
+(@address@hidden Printed Output}).
@item --dvipdf
@opindex --dvipdf
Generate a PDF file using @command{texi2dvi --dvipdf}, rather than
-Info (@address@hidden Printed Output}).
+Info (@address@hidden Printed Output}).
@item address@hidden
@itemx -e @var{limit}
@@ -16963,7 +16973,7 @@
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} (@address@hidden@@setfilename}}). @xref{Tag and
+by @code{@@setfilename} (@address@hidden@@setfilename}}). @xref{Tag and
Split Files}.
@item address@hidden
@@ -17087,7 +17097,7 @@
overrides any file name specified in an @code{@@setfilename} command
found in the Texinfo source. If neither @code{@@setfilename} nor this
option are specified, the input file name is used to determine the
-output name. @address@hidden@@setfilename}}.
+output name. @address@hidden@@setfilename}}.
If @var{file} is @samp{-}, output goes to standard output and
@samp{--no-split} is implied.
@@ -17121,7 +17131,7 @@
@opindex -p @var{indent}
Set the paragraph indentation style to @var{indent}. The value set by
this option overrides the value set in a Texinfo file by an
address@hidden@@paragraphindent} command (@address@hidden@@paragraphindent}}).
address@hidden@@paragraphindent} command (@address@hidden@@paragraphindent}}).
The value of @var{indent} is interpreted as follows:
@table @asis
@@ -17142,7 +17152,7 @@
@item --pdf
@opindex --pdf
Generate a PDF file using @command{texi2dvi --pdf}, rather than Info
-(@address@hidden Printed Output}).
+(@address@hidden Printed Output}).
@item --plaintext
@opindex --plaintext
@@ -17164,7 +17174,7 @@
@item --ps
@opindex --ps
Generate a PostScript file using @command{texi2dvi --ps}, rather than
-Info (@address@hidden Printed Output}).
+Info (@address@hidden Printed Output}).
@item --set-customization-variable @address@hidden
@itemx -c @address@hidden
@@ -17220,7 +17230,7 @@
@item -U @var{var}
Cause @var{var} to be undefined. This is equivalent to @code{@@clear
address@hidden in the Texinfo file (@address@hidden@@set @@clear @@value}}).
address@hidden in the Texinfo file (@address@hidden@@set @@clear @@value}}).
@item --verbose
@opindex --verbose
@@ -17237,7 +17247,7 @@
@item --Xopt @var{str}
@opindex --Xopt @var{str}
Pass @var{str} (a single shell word) to @command{texi2dvi}; may be
-repeated (@address@hidden Printed Output}).
+repeated (@address@hidden Printed Output}).
@item --xml
@opindex --xml
@@ -17258,7 +17268,7 @@
If not set or otherwise specified, Info output is the default.
address@hidden @code{texi2any} Printed Output
address@hidden @t{texi2any} Printed Output
@section @command{texi2any} Printed Output
@cindex Printed output, through @command{texi2any}
@@ -17272,7 +17282,7 @@
The output format options for this are @option{--dvi},
@option{--dvipdf}, @option{--pdf}, and @option{--pdf}. @xref{Format
-with @code{texi2dvi}}, for more details on these options and general
+with @t{texi2dvi}}, for more details on these options and general
@command{texi2dvi} operation. In addition, the @option{--verbose},
@option{--silent}, and @option{--quiet} options are passed on if
specified; the @option{-I} and @option{-o} options are likewise passed
@@ -17486,7 +17496,7 @@
@cindex Options, customization variables for
The following table gives the customization variables associated with
-some command line options. @xref{Invoking @code{texi2any}}, for the
+some command line options. @xref{Invoking @t{texi2any}}, for the
meaning of the options.
@multitable @columnfractions 0.5 0.5
@@ -17598,7 +17608,7 @@
@cindex @code{<body>} text, customizing
For HTML, the text appearing in @code{<body>}. By default, set
automatically, taking into account the document language
-(@address@hidden@@documentlanguage}}).
+(@address@hidden@@documentlanguage}}).
@item CASE_INSENSITIVE_FILENAMES
For address@hidden Construct output file names as if the filesystem were case
@@ -17766,19 +17776,19 @@
@item INLINE_INSERTCOPYING
If set, @code{@@insertcopying} is replaced by the @code{@@copying}
-content (@address@hidden@@copying}}) as if @code{@@insertcopying} were a
+content (@address@hidden@@copying}}) as if @code{@@insertcopying} were a
user-defined macro; default false.
@item INPUT_ENCODING_NAME
Normalized encoding name suitable for output. Should be a usable
charset name in HTML, typically one of the preferred IANA encoding
names. You should not need to use this variable, since it is set by
address@hidden@@documentencoding} (@address@hidden@@documentencoding}}).
address@hidden@@documentencoding} (@address@hidden@@documentencoding}}).
@item INPUT_PERL_ENCODING
Perl encoding used to process the Texinfo source. You should not need
to use that variable, since it is set by @code{@@documentencoding}
-(@address@hidden@@documentencoding}}).
+(@address@hidden@@documentencoding}}).
@item KEEP_TOP_EXTERNAL_REF
For address@hidden If set, do not ignore @samp{Top} as the first
@@ -17880,7 +17890,7 @@
encoding is specified, the default output encoding name may be set by
the output format. In particular, the XML-based formats use
@code{utf-8} for @code{OUTPUT_ENCODING_NAME} if the encoding is not
-otherwise specified. @address@hidden@@documentencoding}}.
+otherwise specified. @address@hidden@@documentencoding}}.
@item OVERVIEW_LINK_TO_TOC
If set, the cross references in the Overview link to the corresponding
@@ -17910,7 +17920,7 @@
@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
-(@address@hidden@@setfilename}}). How this value is used depends on the
+(@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.
@@ -17978,7 +17988,7 @@
@item TEXI2DVI
Name of the command used to produce PostScript, PDF, and DVI; default
address@hidden @address@hidden Printed Output}.
address@hidden @address@hidden Printed Output}.
@item TEXI2HTML
@cindex compatibility, with @command{texi2html}
@@ -18133,7 +18143,7 @@
@item XREF_USE_FLOAT_LABEL
For address@hidden If set, for the float name in cross references, use the
float label instead of the type followed by the float number
-(@address@hidden@@float}}). The default is off.
+(@address@hidden@@float}}). The default is off.
@item XREF_USE_NODE_NAME_ARG
For address@hidden Only relevant for cross reference commands with no cross
@@ -18162,7 +18172,7 @@
various places: cross references, page footers, the help page,
alternate text for images, and so on. The string chosen depends on
the value of the @code{documentlanguage} at the time of the string
-being output (@address@hidden@@documentlanguage}}, for the Texinfo
+being output (@address@hidden@@documentlanguage}}, for the Texinfo
command interface).
@pindex libintl-perl @r{Gettext implementation}
@@ -18250,7 +18260,7 @@
appropriately in many languages.
address@hidden @code{texi2html}
address@hidden @t{texi2html}
@section @code{texi2html}: Ancestor of @code{texi2any}
@pindex texi2html
@@ -18372,9 +18382,9 @@
@pxref{Installing an Info File}.
@menu
-* @code{makeinfo} Advantages:: @code{makeinfo} provides better error
checking.
-* @code{makeinfo} in Emacs:: How to run @code{makeinfo} from Emacs.
-* @code{texinfo-format} commands:: Two Info formatting commands written
+* @t{makeinfo} Advantages:: @code{makeinfo} provides better error
checking.
+* @t{makeinfo} in Emacs:: How to run @code{makeinfo} from Emacs.
+* @t{texinfo-format} commands:: Two Info formatting commands written
in Emacs Lisp are an alternative
to @code{makeinfo}.
* Batch Formatting:: How to format for Info in Emacs Batch mode.
@@ -18383,7 +18393,7 @@
@end menu
address@hidden @code{makeinfo} Advantages
address@hidden @t{makeinfo} Advantages
@subsection @code{makeinfo} Advantages
@anchor{makeinfo address@hidden old name
@@ -18400,10 +18410,10 @@
commands may be useful if you cannot run @code{makeinfo}.
address@hidden @code{makeinfo} in Emacs
address@hidden @t{makeinfo} in Emacs
@subsection Running @code{makeinfo} Within Emacs
address@hidden anchor{makeinfo in address@hidden old name
address@hidden anchor{makeinfo in address@hidden prev name
@cindex Running @code{makeinfo} in Emacs
@cindex @code{makeinfo} inside Emacs
@cindex Shell, running @code{makeinfo} in
@@ -18427,7 +18437,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} (@address@hidden@@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
@@ -18486,7 +18496,7 @@
@c Writing these three cross references using xref results in
@c three references to the same named manual, which looks strange.
@iftex
-For more information, see @address@hidden options}, as well as
+For more information, see @address@hidden options}, as well as
``Easy Customization Interface,'' ``Examining and Setting Variables,''
and ``Init File'' in @cite{The GNU Emacs Manual}.
@end iftex
@@ -18495,14 +18505,14 @@
@ref{Easy Customization, , Easy Customization Interface, emacs, The GNU Emacs
Manual},@*
@ref{Examining, , Examining and Setting Variables, emacs, The GNU Emacs
Manual},@*
@ref{Init File, , , emacs, The GNU Emacs Manual}, address@hidden
address@hidden@code{makeinfo} options}.
address@hidden@t{makeinfo} Options}.
@end ifnottex
address@hidden @code{texinfo-format} commands
address@hidden @t{texinfo-format} commands
@subsection The @address@hidden Commands
address@hidden anchor{texinfo-format address@hidden old name
address@hidden anchor{texinfo-format address@hidden prev name
In GNU Emacs in Texinfo mode, you can format part or all of a Texinfo
file with the @code{texinfo-format-region} command. This formats the
@@ -18533,7 +18543,7 @@
provide you with further help in finding formatting errors. These
procedures are described in an appendix; see @ref{Catching Mistakes}.
However, the @code{makeinfo} program provides better error checking
-(@address@hidden in Emacs}).
+(@address@hidden in Emacs}).
@node Batch Formatting
@@ -18653,7 +18663,7 @@
Info-validate} node-checking command on indirect files. For
information on how to prevent files from being split and how to
validate the structure of the nodes, see @ref{Using
address@hidden
address@hidden
@node Installing an Info File
@@ -18674,7 +18684,7 @@
located in other directories.
* Installing Dir Entries:: How to specify what menu entry to add
to the Info directory.
-* Invoking @code{install-info}:: @code{install-info} options.
+* Invoking @t{install-info}:: @code{install-info} options.
@end menu
@@ -18945,7 +18955,7 @@
most others. Description for individual utilities best start in
column 48, where possible. For more information about formatting see
the @samp{--calign}, @samp{--align}, and @samp{--max-width} options in
address@hidden @code{install-info}}.
address@hidden @t{install-info}}.
If you use @code{@@dircategory} more than once in the Texinfo source,
each usage specifies the `current' category; any subsequent
@@ -18980,7 +18990,7 @@
traditional @command{man} system.
address@hidden Invoking @code{install-info}
address@hidden Invoking @t{install-info}
@subsection Invoking @command{install-info}
@pindex install-info
@@ -19266,7 +19276,7 @@
(@code{thead}, @code{abbr}, @code{acronym}).
Using @samp{--init-file=html32.pm} produces strict address@hidden
-output (@pxref{Invoking @code{texi2any}}).
+output (@pxref{Invoking @t{texi2any}}).
Please report output from an error-free run of @code{makeinfo} which
has browser portability problems as a bug (@pxref{Reporting Bugs}).
@@ -19297,7 +19307,7 @@
@code{CASE_INSENSITIVE_FILENAMES}.
It is also possible to split at chapters or sections with
address@hidden (@pxref{Invoking @code{texi2any}}). In that case,
address@hidden (@pxref{Invoking @t{texi2any}}). In that case,
the file names are constructed after the name of the node associated
with the relevant sectioning command. Also, unless
@option{--no-node-files} is specified, a redirection file is output
@@ -19333,7 +19343,7 @@
@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
-(@address@hidden@@setfilename}}).
+(@address@hidden@@setfilename}}).
@node HTML CSS
@@ -19570,7 +19580,7 @@
restrictive.)
Cross references in Texinfo can refer either to nodes or anchors
-(@address@hidden@@anchor}}). However, anchors are treated identically
+(@address@hidden@@anchor}}). However, anchors are treated identically
to nodes in this context, so we'll continue to say ``node'' names for
simplicity.
@@ -19652,7 +19662,7 @@
First, comments are removed.
-Next, any @code{@@value} commands (@address@hidden@@set @@value}}) and
+Next, any @code{@@value} commands (@address@hidden@@set @@value}}) and
macro invocations (@pxref{Invoking Macros}) are fully expanded.
Then, for the following commands, the command name and braces are removed,
@@ -19998,7 +20008,7 @@
preceded by whitespace.
Another approach to preserving links to deleted or renamed nodes is to
-use anchors (@address@hidden@@anchor}}). There is no effective
+use anchors (@address@hidden@@anchor}}). There is no effective
difference between the two approaches.
@@ -20044,7 +20054,7 @@
Accents}.
@item @@-
-Insert a discretionary hyphenation point. @address@hidden@@- @@hyphenation}}.
+Insert a discretionary hyphenation point. @address@hidden@@- @@hyphenation}}.
@item @@.
Produce a period that ends a sentence (usually after an
@@ -20122,38 +20132,38 @@
@item @@alias @address@hidden
Make the command @samp{@@@var{new}} a synonym for the existing command
address@hidden@@@var{existing}}. @address@hidden@@alias}}.
address@hidden@@@var{existing}}. @address@hidden@@alias}}.
@item @@allowcodebreaks @var{true-false}
Control breaking at @samp{-} and @samp{_} in @TeX{}.
address@hidden@code{@@allowcodebreaks}}.
address@hidden@t{@@allowcodebreaks}}.
@item @@address@hidden@address@hidden
Define @var{name} as the current location for use as a cross reference
-target. @address@hidden@@anchor}}.
+target. @address@hidden@@anchor}}.
@item @@appendix @var{title}
Begin an appendix. The title appears in the table of contents. In
Info, the title is underlined with asterisks.
address@hidden@code{@@unnumbered @@appendix}}.
address@hidden@t{@@unnumbered @@appendix}}.
@item @@appendixsec @var{title}
@itemx @@appendixsection @var{title}
Begin an appendix section within an appendix. The section title
appears in the table of contents. In Info, the title is underlined
with equal signs. @code{@@appendixsection} is a longer spelling of
-the @code{@@appendixsec} command. @address@hidden@@unnumberedsec
+the @code{@@appendixsec} command. @address@hidden@@unnumberedsec
@@appendixsec @@heading}}.
@item @@appendixsubsec @var{title}
Begin an appendix subsection. The title appears in the table of
contents. In Info, the title is underlined with hyphens.
address@hidden@code{@@unnumberedsubsec @@appendixsubsec @@subheading}}.
address@hidden@t{@@unnumberedsubsec @@appendixsubsec @@subheading}}.
@item @@appendixsubsubsec @var{title}
Begin an appendix subsubsection. The title appears in the table of
contents. In Info, the title is underlined with periods.
address@hidden@code{@@subsubsection}}.
address@hidden@t{@@subsubsection}}.
@item @@address@hidden@}
Generate a right arrow glyph: @address@hidden Used by default
@@ -20162,10 +20172,10 @@
@item @@asis
Used following @code{@@table}, @code{@@ftable}, and @code{@@vtable} to
print the table's first column without highlighting (``as is'').
address@hidden@code{@@asis}}.
address@hidden@t{@@asis}}.
@item @@author @var{author}
-Typeset @var{author} flushleft and underline it. @address@hidden@@title
+Typeset @var{author} flushleft and underline it. @address@hidden@@title
@@subtitle @@author}}.
@item @@address@hidden@address@hidden
@@ -20173,7 +20183,7 @@
@item @@address@hidden@}
Generate a large round dot, @bullet{} (@samp{*} in Info). Often used
-with @code{@@table}. @address@hidden@@bullet}}.
+with @code{@@table}. @address@hidden@@bullet}}.
@item @@bye
Stop formatting a file. The formatters do not see anything in the
@@ -20185,30 +20195,30 @@
starts a comment. @xref{Comments}.
@item @@caption
-Define the full caption for an @code{@@float}. @address@hidden@@caption
+Define the full caption for an @code{@@float}. @address@hidden@@caption
@@shortcaption}}.
@item @@cartouche
Highlight an example or quotation by drawing a box with rounded
corners around it. Pair with @code{@@end cartouche}. No effect in
-Info. @address@hidden@@cartouche}}.
+Info. @address@hidden@@cartouche}}.
@item @@center @var{line-of-text}
Center the line of text following the command.
address@hidden@code{@@titlefont @@center @@sp}}.
address@hidden@t{@@titlefont @@center @@sp}}.
@item @@centerchap @var{line-of-text}
-Like @code{@@chapter}, but centers the chapter title.
@address@hidden@@chapter}}.
+Like @code{@@chapter}, but centers the chapter title.
@address@hidden@@chapter}}.
@item @@chapheading @var{title}
Print an unnumbered chapter-like heading, but omit from the table of
contents. In Info, the title is underlined with asterisks.
address@hidden@code{@@majorheading @@chapheading}}.
address@hidden@t{@@majorheading @@chapheading}}.
@item @@chapter @var{title}
Begin a numbered chapter. The chapter title appears in the table of
contents. In Info, the title is underlined with asterisks.
address@hidden@code{@@chapter}}.
address@hidden@t{@@chapter}}.
@item @@cindex @var{entry}
Add @var{entry} to the index of concepts. @xref{Index Entries, ,
@@ -20216,14 +20226,14 @@
@item @@address@hidden@address@hidden
Highlight the name of a book or other reference that has no companion
-Info file. @address@hidden@@cite}}.
+Info file. @address@hidden@@cite}}.
@item @@clear @var{flag}
Unset @var{flag}, preventing the Texinfo formatting commands from
formatting text between subsequent pairs of @code{@@ifset @var{flag}}
and @code{@@end ifset} commands, and preventing
@code{@@address@hidden@address@hidden from expanding to the value to which
address@hidden is set. @address@hidden@@set @@clear @@value}}.
address@hidden is set. @address@hidden@@set @@clear @@value}}.
@item @@address@hidden@}
Represent a single ``click'' in a address@hidden Used within
@@ -20266,11 +20276,11 @@
@item @@copying
Specify copyright holders and copying conditions for the document Pair
-with @code{@@end cartouche}. @address@hidden@@copying}}.
+with @code{@@end cartouche}. @address@hidden@@copying}}.
@item @@address@hidden@}
Generate the copyright symbol @copyright{}.
address@hidden@code{@@copyright}}.
address@hidden@t{@@copyright}}.
@item @@defcodeindex @var{index-name}
Define a new index and its indexing command. Print entries in an
@@ -20298,7 +20308,7 @@
Must be used within @code{@@ifinfo}; create a new command
@code{@@@var{newcmd}} for Info that marks text by enclosing it in
strings that precede and follow the text.
address@hidden@code{@@definfoenclose}}.
address@hidden@t{@@definfoenclose}}.
@item @@defivar @var{class} @var{instance-variable-name}
@itemx @@defivarx @var{class} @var{instance-variable-name}
@@ -20433,12 +20443,12 @@
@item @@display
Begin a kind of example. Like @code{@@example} (indent text, do not
fill), but do not select a new font. Pair with @code{@@end display}.
address@hidden@code{@@display}}.
address@hidden@t{@@display}}.
@item @@address@hidden@address@hidden
Format a unit of measure, as in address@hidden Causes @TeX{} to insert a
thin space before @var{dimension}. No effect in Info.
address@hidden@code{@@dmn}}.
address@hidden@t{@@dmn}}.
@item @@docbook
Enter Docbook completely. Pair with @code{@@end docbook}. @xref{Raw
@@ -20446,15 +20456,15 @@
@item @@documentdescription
Set the document description text, included in the HTML output. Pair
-with @code{@@end documentdescription}. @address@hidden@@documentdescription}}.
+with @code{@@end documentdescription}. @address@hidden@@documentdescription}}.
@item @@documentencoding @var{enc}
Declare the input encoding to be @var{enc}.
address@hidden@code{@@documentencoding}}.
address@hidden@t{@@documentencoding}}.
@item @@documentlanguage @var{CC}
Declare the document language as the two-character ISO-639 abbreviation
address@hidden @address@hidden@@documentlanguage}}.
address@hidden @address@hidden@@documentlanguage}}.
@item @@address@hidden@address@hidden
Generate a dot accent over the character @var{c}, as in @dotaccent{o}.
@@ -20466,7 +20476,7 @@
@item @@address@hidden@}
Generate an ellipsis, @address@hidden
address@hidden@code{@@dots}}.
address@hidden@t{@@dots}}.
@item @@address@hidden@var{address}[, @address@hidden
Indicate an electronic mail address.
@@ -20482,12 +20492,12 @@
@item @@address@hidden@}
Generate an end-of-sentence ellipsis, like this: @enddots{}
address@hidden@code{@@dots}}.
address@hidden@t{@@dots}}.
@item @@enumerate address@hidden
Begin a numbered list, using @code{@@item} for each entry.
Optionally, start list with @var{number-or-letter}. Pair with
address@hidden@@end enumerate}. @address@hidden@@enumerate}}.
address@hidden@@end enumerate}. @address@hidden@@enumerate}}.
@item @@address@hidden@address@hidden
Indicate an environment variable name, such as @env{PATH}.
@@ -20495,11 +20505,11 @@
@item @@address@hidden@}
Indicate to the reader the exact equivalence of two forms with a
-glyph: @address@hidden @address@hidden@@equiv}}.
+glyph: @address@hidden @address@hidden@@equiv}}.
@item @@address@hidden@}
Indicate to the reader with a glyph that the following text is
-an error message: @address@hidden @address@hidden@@error}}.
+an error message: @address@hidden @address@hidden@@error}}.
@item @@address@hidden@address@hidden
Report @var{msg} as an error to standard error, and exit unsuccessfully.
@@ -20507,7 +20517,7 @@
@xref{Conditionals}, and @ref{External Macro Processors}.
@item @@address@hidden@}
-Generate the Euro currency sign. @address@hidden@@euro}}.
+Generate the Euro currency sign. @address@hidden@@euro}}.
@item @@evenfooting address@hidden @@| address@hidden @@| address@hidden
@itemx @@evenheading address@hidden @@| address@hidden @@| address@hidden
@@ -20522,21 +20532,21 @@
@item @@example
Begin an example. Indent text, do not fill, and select fixed-width
-font. Pair with @code{@@end example}. @address@hidden@@example}}.
+font. Pair with @code{@@end example}. @address@hidden@@example}}.
@item @@exampleindent @var{indent}
Indent example-like environments by @var{indent} number of spaces
-(perhaps 0). @address@hidden@@exampleindent}}.
+(perhaps 0). @address@hidden@@exampleindent}}.
@item @@address@hidden@}
Generate an upside-down exclamation point. @xref{Inserting Accents}.
@item @@exdent @var{line-of-text}
-Remove any indentation a line might have. @address@hidden@@exdent}}.
+Remove any indentation a line might have. @address@hidden@@exdent}}.
@item @@address@hidden@}
Indicate the result of a macro expansion to the reader with a special
-glyph: @address@hidden @address@hidden@@expansion}}.
+glyph: @address@hidden @address@hidden@@expansion}}.
@item @@address@hidden@address@hidden
Highlight the name of a file, buffer, node, directory, etc. @xref{file, ,
@@ -20553,7 +20563,7 @@
@item @@firstparagraphindent @var{word}
Control indentation of the first paragraph after section headers
according to @var{word}, one of `none' or `insert'.
address@hidden@code{@@firstparagraphindent}}.
address@hidden@t{@@firstparagraphindent}}.
@item @@float
Environment to define floating material. Pair with @code{@@end float}.
@@ -20563,7 +20573,7 @@
@itemx @@flushright
Do not fill text; left (right) justify every line while leaving the
right (left) end ragged. Leave font as is. Pair with @code{@@end
-flushleft} (@code{@@end flushright}). @address@hidden@@flushleft
+flushleft} (@code{@@end flushright}). @address@hidden@@flushleft
@@flushright}}.
@item @@fonttextsize @var{10-11}
@@ -20582,23 +20592,23 @@
@item @@format
Begin a kind of example. Like @code{@@display}, but do not indent.
-Pair with @code{@@end format}. @address@hidden@@example}}.
+Pair with @code{@@end format}. @address@hidden@@example}}.
@item @@frenchspacing @var{on-off}
-Control spacing after punctuation. @address@hidden@@frenchspacing}}.
+Control spacing after punctuation. @address@hidden@@frenchspacing}}.
@item @@ftable @var{formatting-command}
Begin a two-column table, using @code{@@item} for each entry.
Automatically enter each of the items in the first column into the
index of functions. Pair with @code{@@end ftable}. The same as
address@hidden@@table}, except for indexing. @address@hidden@@ftable
@@vtable}}.
address@hidden@@table}, except for indexing. @address@hidden@@ftable
@@vtable}}.
@item @@address@hidden@}
-Generate a greater-than-or-equal sign, address@hidden'. @address@hidden@@geq
@@leq}}.
+Generate a greater-than-or-equal sign, address@hidden'. @address@hidden@@geq
@@leq}}.
@item @@group
Disallow page breaks within following text. Pair with @code{@@end
-group}. Ignored in Info. @address@hidden@@group}}.
+group}. Ignored in Info. @address@hidden@@group}}.
@item @@address@hidden@}
@itemx @@address@hidden@}
@@ -20623,11 +20633,11 @@
@item @@heading @var{title}
Print an unnumbered section-like heading, but omit from the table of
contents. In Info, the title is underlined with equal signs.
address@hidden@code{@@unnumberedsec @@appendixsec @@heading}}.
address@hidden@t{@@unnumberedsec @@appendixsec @@heading}}.
@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. @address@hidden@@headings}}.
+page headings for printing. @address@hidden@@headings}}.
@item @@headitem
Begin a heading row in a multitable. @xref{Multitable Rows}.
@@ -20641,14 +20651,14 @@
Formatter Commands}.
@item @@address@hidden@var{hy-phen-a-ted address@hidden
-Explicitly define hyphenation points. @address@hidden@@- @@hyphenation}}.
+Explicitly define hyphenation points. @address@hidden@@- @@hyphenation}}.
@item @@address@hidden@address@hidden
Set @var{text} in an @i{italic} font. No effect in Info. @xref{Fonts}.
@item @@ifclear @var{txivar}
If the Texinfo variable @var{txivar} is not set, format the following
-text. Pair with @code{@@end ifclear}. @address@hidden@@set @@clear
+text. Pair with @code{@@end ifclear}. @address@hidden@@set @@clear
@@value}}.
@item @@ifcommanddefined @var{txicmd}
@@ -20687,7 +20697,7 @@
@item @@ifset @var{txivar}
If the Texinfo variable @var{txivar} is set, format the following
-text. Pair with @code{@@end ifset}. @address@hidden@@set @@clear
+text. Pair with @code{@@end ifset}. @address@hidden@@set @@clear
@@value}}.
@item @@iftex
@@ -20711,11 +20721,11 @@
Read the contents of Texinfo source file @var{filename}. @xref{Include Files}.
@item @@indent
-Insert paragraph indentation. @address@hidden@@indent}}.
+Insert paragraph indentation. @address@hidden@@indent}}.
@item @@indentedblock
Indent a block of arbitary text on the left. Pair with @code{@@end
-indentedblock}. @address@hidden@@indentedblock}}.
+indentedblock}. @address@hidden@@indentedblock}}.
@item @@address@hidden@address@hidden
Indicate text that is a uniform resource locator for the World Wide
@@ -20723,7 +20733,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. @address@hidden@@inforef}}.
+manual. @address@hidden@@inforef}}.
@item @@address@hidden@var{fmt}, @address@hidden
@itemx @@address@hidden@var{fmt}, @address@hidden
@@ -20740,7 +20750,7 @@
@item @@insertcopying
Insert the text previously defined with the @code{@@copying}
-environment. @address@hidden@@insertcopying}}.
+environment. @address@hidden@@insertcopying}}.
@item @@item
Indicate the beginning of a marked paragraph for @code{@@itemize} and
@@ -20751,13 +20761,13 @@
@item @@itemize @var{mark-generating-character-or-command}
Begin an unordered list: indented paragraphs with a mark, such as
@code{@@bullet}, inside the left margin at the beginning of each item.
-Pair with @code{@@end itemize}. @address@hidden@@itemize}}.
+Pair with @code{@@end itemize}. @address@hidden@@itemize}}.
@item @@itemx
Like @code{@@item} but do not generate extra vertical space above the
item text. Thus, when several items have the same description, use
@code{@@item} for the first and @code{@@itemx} for the others.
address@hidden@code{@@itemx}}.
address@hidden@t{@@itemx}}.
@item @@address@hidden@address@hidden
Indicate characters of input to be typed by users. @xref{kbd,, @code{@@kbd}}.
@@ -20780,18 +20790,18 @@
respectively: @L{}, @l{}.
@item @@address@hidden@}
-Generate the @LaTeX{} logo. @address@hidden@@TeX @@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}}.
+Generate a less-than-or-equal sign, address@hidden'. @address@hidden@@geq
@@leq}}.
@item @@lisp
Begin an example of Lisp code. Indent text, do not fill, and select
-fixed-width font. Pair with @code{@@end lisp}. @address@hidden@@lisp}}.
+fixed-width font. Pair with @code{@@end lisp}. @address@hidden@@lisp}}.
@item @@listoffloats
Produce a table-of-contents-like listing of @code{@@float}s.
address@hidden@code{@@listoffloats}}.
address@hidden@t{@@listoffloats}}.
@item @@lowersections
Change subsequent chapters to sections, sections to subsections, and so
@@ -20805,7 +20815,7 @@
@item @@majorheading @var{title}
Print an unnumbered chapter-like heading, but omit from the table of
contents. This generates more vertical whitespace before the heading
-than the @code{@@chapheading} command. @address@hidden@@majorheading
+than the @code{@@chapheading} command. @address@hidden@@majorheading
@@chapheading}}.
@item @@address@hidden@address@hidden
@@ -20816,7 +20826,7 @@
Pair with @code{@@end menu}. @xref{Menus}.
@item @@address@hidden@}
-Generate a minus sign, address@hidden'. @address@hidden@@minus}}.
+Generate a minus sign, address@hidden'. @address@hidden@@minus}}.
@item @@multitable @var{column-width-spec}
Begin a multi-column table. Begin each row with @code{@@item} or
@@ -20826,14 +20836,14 @@
@item @@need @var{n}
Start a new page in a printed manual if fewer than @var{n} mils
(thousandths of an inch) remain on the current page.
address@hidden@code{@@need}}.
address@hidden@t{@@need}}.
@item @@node @var{name}, @var{next}, @var{previous}, @var{up}
-Begin a new node. @address@hidden@@node}}.
+Begin a new node. @address@hidden@@node}}.
@item @@noindent
Prevent text from being indented as if it were a new paragraph.
address@hidden@code{@@noindent}}.
address@hidden@t{@@noindent}}.
@item @@novalidate
Suppress validation of node references and omit creation of auxiliary
@@ -20871,7 +20881,7 @@
@item @@page
Start a new page in a printed manual. No effect in Info.
address@hidden@code{@@page}}.
address@hidden@t{@@page}}.
@item @@pagesizes address@hidden, @var{height}]
Change page dimensions. @xref{pagesizes}.
@@ -20879,12 +20889,12 @@
@item @@paragraphindent @var{indent}
Indent paragraphs by @var{indent} number of spaces (perhaps 0); preserve
source file indentation if @var{indent} is @code{asis}.
address@hidden@code{@@paragraphindent}}.
address@hidden@t{@@paragraphindent}}.
@item @@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}}.
address@hidden@t{@@part}}.
@item @@pindex @var{entry}
Add @var{entry} to the index of programs. @xref{Index Entries, , Defining
@@ -20892,15 +20902,15 @@
@item @@address@hidden@}
Indicate the position of point in a buffer to the reader with a glyph:
address@hidden@point{}}. @address@hidden@@point}}.
address@hidden@point{}}. @address@hidden@@point}}.
@item @@address@hidden@}
Generate the pounds sterling currency sign.
address@hidden@code{@@pounds}}.
address@hidden@t{@@pounds}}.
@item @@address@hidden@}
Indicate printed output to the reader with a glyph: @address@hidden
address@hidden@code{@@print}}.
address@hidden@t{@@print}}.
@item @@printindex @var{index-name}
Generate the alphabetized index for @var{index-name} (using two
@@ -20909,7 +20919,7 @@
@item @@address@hidden@var{node}, address@hidden, address@hidden,
address@hidden, address@hidden@}
Make a reference that starts with a lowercase `see' in a printed
manual. Use within parentheses only. Only the first argument is
-mandatory. @address@hidden@@pxref}}.
+mandatory. @address@hidden@@pxref}}.
@item @@address@hidden@}
Generate an upside-down question mark. @xref{Inserting Accents}.
@@ -20917,7 +20927,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}. @address@hidden@@quotation}}.
+Pair with @code{@@end quotation}. @address@hidden@@quotation}}.
@item @@address@hidden@}
@itemx @@address@hidden@}
@@ -20936,7 +20946,7 @@
@item @@raggedright
Fill text; left justify every line while leaving the right end ragged.
Leave font as is. Pair with @code{@@end raggedright}. No effect in
-Info. @address@hidden@@raggedright}}.
+Info. @address@hidden@@raggedright}}.
@item @@raisesections
Change subsequent sections to chapters, subsections to sections, and so
@@ -20945,7 +20955,7 @@
@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.
Follow command with a punctuation mark. Only the first argument is
-mandatory. @address@hidden@@ref}}.
+mandatory. @address@hidden@@ref}}.
@item @@refill
@findex refill
@@ -20956,11 +20966,11 @@
@item @@address@hidden@}
Generate the legal symbol @registeredsymbol{}.
address@hidden@code{@@registeredsymbol}}.
address@hidden@t{@@registeredsymbol}}.
@item @@address@hidden@}
Indicate the result of an expression to the reader with a special
-glyph: @address@hidden @address@hidden@@result}}.
+glyph: @address@hidden @address@hidden@@result}}.
@item @@address@hidden@address@hidden
Generate a ring accent over the next character, as in @ringaccent{o}.
@@ -20983,15 +20993,15 @@
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@t{@@section}}.
@item @@set @var{txivar} address@hidden
Define the Texinfo variable @var{txivar}, optionally to the value
address@hidden @address@hidden@@set @@clear @@value}}.
address@hidden @address@hidden@@set @@clear @@value}}.
@item @@setchapternewpage @var{on-off-odd}
Specify whether chapters start on new pages, and if so, whether on
-odd-numbered (right-hand) new pages. @address@hidden@@setchapternewpage}}.
+odd-numbered (right-hand) new pages. @address@hidden@@setchapternewpage}}.
@item @@setcontentsaftertitlepage
Put the table of contents after the @samp{@@end titlepage} even if the
@@ -21000,7 +21010,7 @@
@item @@setfilename @var{info-file-name}
Provide a name to be used for the output files. This command is essential
for @TeX{} formatting as well, even though it produces no output of
-its own. @address@hidden@@setfilename}}.
+its own. @address@hidden@@setfilename}}.
@item @@setshortcontentsaftertitlepage
Place the short table of contents after the @samp{@@end titlepage}
@@ -21010,10 +21020,10 @@
@item @@settitle @var{title}
Specify the title for page headers in a printed manual, and the
default document title for HTML @samp{<head>}.
address@hidden@code{@@settitle}}.
address@hidden@t{@@settitle}}.
@item @@shortcaption
-Define the short caption for an @code{@@float}. @address@hidden@@caption
+Define the short caption for an @code{@@float}. @address@hidden@@caption
@@shortcaption}}.
@item @@shortcontents
@@ -21022,7 +21032,7 @@
@xref{Contents, , Generating a Table of Contents}.
@item @@shorttitlepage @var{title}
-Generate a minimal title page. @address@hidden@@titlepage}}.
+Generate a minimal title page. @address@hidden@@titlepage}}.
@item @@address@hidden@address@hidden
Set @var{text} in a @slanted{slanted} font if possible. No effect
@@ -21031,38 +21041,38 @@
@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.
address@hidden@code{@@smallbook}}. Also, see @address@hidden@@address@hidden
address@hidden@t{@@smallbook}}. 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@code{@@address@hidden
address@hidden@t{@@address@hidden
@item @@smallexample
Begin an example. Like @code{@@example}, but use a smaller font size
where possible. Pair with @code{@@end smallexample}.
address@hidden@code{@@address@hidden
address@hidden@t{@@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@code{@@address@hidden
address@hidden@t{@@address@hidden
@item @@smallindentedblock
Like @code{@@indentedblock}, but use a smaller font size where
possible. Pair with @code{@@end smallindentedblock}.
address@hidden@code{@@address@hidden
address@hidden@t{@@address@hidden
@item @@smalllisp
Begin an example of Lisp code. Same as @code{@@smallexample}. Pair
-with @code{@@end smalllisp}. @address@hidden@@address@hidden
+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}. @address@hidden@@address@hidden
+Pair with @code{@@end smallquotation}. @address@hidden@@address@hidden
@item @@sp @var{n}
-Skip @var{n} blank lines. @address@hidden@@sp}}.
+Skip @var{n} blank lines. @address@hidden@@sp}}.
@item @@address@hidden@}
Generate the German sharp-S es-zet letter, @ss{}. @xref{Inserting Accents}.
@@ -21075,29 +21085,29 @@
@item @@subheading @var{title}
Print an unnumbered subsection-like heading, but omit from the table
of contents of a printed manual. In Info, the title is underlined
-with hyphens. @address@hidden@@unnumberedsubsec @@appendixsubsec
@@subheading}}.
+with hyphens. @address@hidden@@unnumberedsubsec @@appendixsubsec
@@subheading}}.
@item @@subsection @var{title}
Begin a subsection within a section. The subsection title appears in
the table of contents. In Info, the title is underlined with hyphens.
Same context-dependent numbering as @code{@@section}.
address@hidden@code{@@subsection}}.
address@hidden@t{@@subsection}}.
@item @@subsubheading @var{title}
Print an unnumbered subsubsection-like heading, but omit from the
table of contents of a printed manual. In Info, the title is
-underlined with periods. @address@hidden@@subsubsection}}.
+underlined with periods. @address@hidden@@subsubsection}}.
@item @@subsubsection @var{title}
Begin a subsubsection within a subsection. The subsubsection title
appears in the table of contents. In Info, the title is underlined
with periods. Same context-dependent numbering as @code{@@section}.
address@hidden@code{@@subsubsection}}.
address@hidden@t{@@subsubsection}}.
@item @@subtitle @var{title}
In a printed manual, set a subtitle in a normal sized font flush to
the right-hand side of the page. Not relevant to Info, which does not
-have title pages. @address@hidden@@title @@subtitle @@author}}.
+have title pages. @address@hidden@@title @@subtitle @@author}}.
@item @@summarycontents
Print a short table of contents. Synonym for @code{@@shortcontents}.
@@ -21126,17 +21136,17 @@
@code{@@item}. First column entries are printed in the font resulting
from @var{formatting-command}. Pair with @code{@@end table}.
@xref{Two-column Tables, , Making a Two-column Table}. Also see
address@hidden@code{@@ftable @@vtable}}, and @address@hidden@@itemx}}.
address@hidden@t{@@ftable @@vtable}}, and @address@hidden@@itemx}}.
@item @@address@hidden@}
-Generate the @TeX{} logo. @address@hidden@@TeX @@LaTeX}}.
+Generate the @TeX{} logo. @address@hidden@@TeX @@LaTeX}}.
@item @@tex
Enter @TeX{} completely. Pair with @code{@@end tex}. @xref{Raw
Formatter Commands}.
@item @@address@hidden@}
-Generate the degree symbol. @address@hidden@@textdegree}}.
+Generate the degree symbol. @address@hidden@@textdegree}}.
@item @@thischapter
@itemx @@thischaptername
@@ -21158,7 +21168,7 @@
@item @@address@hidden@}
Generate a normal interword space at which a line break is not
-allowed. @address@hidden@@tie}}.
+allowed. @address@hidden@@tie}}.
@item @@address@hidden@address@hidden
Generate a tie-after accent over the next two characters @var{cc}, as in
@@ -21172,16 +21182,16 @@
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.
address@hidden@code{@@title @@subtitle @@author}}.
address@hidden@t{@@title @@subtitle @@author}}.
@item @@address@hidden@address@hidden
In a printed manual, print @var{text} in a larger than normal font.
address@hidden@code{@@titlefont @@center @@sp}}.
address@hidden@t{@@titlefont @@center @@sp}}.
@item @@titlepage
Begin the title page. Write the command on a line of its own, paired
with @code{@@end titlepage}. Nothing between @code{@@titlepage} and
address@hidden@@end titlepage} appears in Info. @address@hidden@@titlepage}}.
address@hidden@@end titlepage} appears in Info. @address@hidden@@titlepage}}.
@item @@address@hidden@}
Insert the current date, in `1 Jan 1900' style. @xref{Custom
@@ -21194,7 +21204,8 @@
the @code{@@node} and @code{@@top} lines, are normally enclosed with
@code{@@ifnottex ... @@end ifnottex}. In @TeX{} and
@code{texinfo-format-buffer}, the @code{@@top} command is merely a
-synonym for @code{@@unnumbered}. @address@hidden Pointer Creation}.
+synonym for @code{@@unnumbered}. @address@hidden Pointer
+Creation}.
@item @@address@hidden@address@hidden
@itemx @@address@hidden@address@hidden
@@ -21210,33 +21221,33 @@
@item @@unnumbered @var{title}
Begin a chapter that appears without chapter numbers of any kind. The
title appears in the table of contents. In Info, the title is
-underlined with asterisks. @address@hidden@@unnumbered @@appendix}}.
+underlined with asterisks. @address@hidden@@unnumbered @@appendix}}.
@item @@unnumberedsec @var{title}
Begin a section that appears without section numbers of any kind. The
title appears in the table of contents of a printed manual. In Info,
-the title is underlined with equal signs. @address@hidden@@unnumberedsec
+the title is underlined with equal signs. @address@hidden@@unnumberedsec
@@appendixsec @@heading}}.
@item @@unnumberedsubsec @var{title}
Begin an unnumbered subsection. The title appears in the table of
contents. In Info, the title is underlined with hyphens.
address@hidden@code{@@unnumberedsubsec @@appendixsubsec @@subheading}}.
address@hidden@t{@@unnumberedsubsec @@appendixsubsec @@subheading}}.
@item @@unnumberedsubsubsec @var{title}
Begin an unnumbered subsubsection. The title appears in the table of
contents. In Info, the title is underlined with periods.
address@hidden@code{@@subsubsection}}.
address@hidden@t{@@subsubsection}}.
@item @@address@hidden@var{url}[, @var{displayed-text}][, @address@hidden
@itemx @@address@hidden@var{url}[, @var{displayed-text}][, @address@hidden
Define a cross reference to an external uniform resource locator,
-e.g., for the World Wide Web. @address@hidden@@url}}.
+e.g., for the World Wide Web. @address@hidden@@url}}.
@item @@urefbreakstyle @var{style}
Specify how @code{@@uref}/@code{@@url} should break at special
characters: @code{after}, @code{before}, @code{none}.
address@hidden@code{@@url}}.
address@hidden@t{@@url}}.
@item @@address@hidden@address@hidden
Generate check accent over the character @var{c}, as in @v{o}.
@@ -21244,7 +21255,7 @@
@item @@address@hidden@address@hidden
Insert the value, if any, of the Texinfo variable @var{txivar},
-previously defined by @code{@@set}. @address@hidden@@set @@clear
+previously defined by @code{@@set}. @address@hidden@@set @@clear
@@value}}.
@item @@address@hidden@address@hidden
@@ -21259,11 +21270,11 @@
@item @@verbatim
Output the text of the environment exactly as is (in the fixed-width
-font). Pair with @code{@@end verbatim}. @address@hidden@@verbatim}}.
+font). Pair with @code{@@end verbatim}. @address@hidden@@verbatim}}.
@item @@verbatiminclude @var{filename}
Output the contents of @var{filename} exactly as is (in the
-fixed-width font). @address@hidden@@verbatiminclude}}.
+fixed-width font). @address@hidden@@verbatiminclude}}.
@item @@vindex @var{entry}
Add @var{entry} to the index of variables. @xref{Index Entries, ,
@@ -21280,10 +21291,10 @@
Begin a two-column table, using @code{@@item} for each entry.
Automatically enter each of the items in the first column into the
index of variables. Pair with @code{@@end vtable}. The same as
address@hidden@@table}, except for indexing. @address@hidden@@ftable
@@vtable}}.
address@hidden@@table}, except for indexing. @address@hidden@@ftable
@@vtable}}.
@item @@address@hidden@address@hidden
-Disallow line breaks within @var{text}. @address@hidden@@w}}.
+Disallow line breaks within @var{text}. @address@hidden@@w}}.
@item @@xml
Enter XML completely. Pair with @code{@@end xml}. @xref{Raw
@@ -21292,7 +21303,7 @@
@item @@address@hidden@var{node}, address@hidden, address@hidden,
address@hidden, address@hidden@}
Make a reference that starts with `See' in a printed manual. Follow
command with a punctuation mark. Only the first argument is
-mandatory. @address@hidden@@xref}}.
+mandatory. @address@hidden@@xref}}.
@item @@xrefautomaticsectiontitle @var{on-off}
By default, use the section title instead of the node name in cross
@@ -21576,7 +21587,7 @@
output (@pxref{Short Sample}).
It is easiest to handle such version information using @code{@@set}
-and @code{@@value}. @address@hidden@@value} Example}, and @ref{GNU
+and @code{@@value}. @address@hidden@@value} Example}, and @ref{GNU
Sample Texts}.
@@ -21966,7 +21977,7 @@
as:
@example
-$Id: texinfo.txi,v 1.526 2013/01/15 01:19:27 karl Exp $
+$Id: texinfo.txi,v 1.527 2013/01/15 23:12:57 karl Exp $
@end example
(This is potentially useful in all sources that use version control,
@@ -22329,7 +22340,7 @@
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}}.)
address@hidden@t{@@headings}}.)
@item @code{@@setchapternewpage odd}
Specify the double-sided heading format, with chapters on new pages.
@@ -22556,19 +22567,19 @@
command and you can use the @kbd{M-x Info-validate} command.
@menu
-* @code{makeinfo} Preferred:: @code{makeinfo} finds errors.
+* @t{makeinfo} Preferred:: @code{makeinfo} finds errors.
* Debugging with Info:: How to catch errors with Info formatting.
* Debugging with @TeX{}:: How to catch errors with @TeX{} formatting.
-* Using @code{texinfo-show-structure}:: How to use
@code{texinfo-show-structure}.
-* Using @code{occur}:: How to list all lines containing a
pattern.
-* Running @code{Info-validate}:: How to find badly referenced nodes.
+* Using @t{texinfo-show-structure}:: How to use @code{texinfo-show-structure}.
+* Using @t{occur}:: How to list all lines containing a pattern.
+* Running @t{Info-validate}:: How to find badly referenced nodes.
@end menu
address@hidden @code{makeinfo} Preferred
address@hidden @t{makeinfo} Preferred
@section @code{makeinfo} Preferred
address@hidden anchor{makeinfo address@hidden old name
address@hidden anchor{makeinfo address@hidden prev name
The @code{makeinfo} program does an excellent job of catching errors
and reporting them---far better than @code{texinfo-format-region} or
@@ -22817,7 +22828,7 @@
instead of @samp{@@}; and in this circumstance, you are working
directly with @TeX{}, not with Texinfo.)
address@hidden Using @code{texinfo-show-structure}
address@hidden Using @t{texinfo-show-structure}
@section Using @code{texinfo-show-structure}
@cindex Showing the structure of a file
@@ -22889,7 +22900,7 @@
the list in the @samp{*Occur*} window; and if you have mis-named a node
or left out a section, you can correct the mistake.
address@hidden Using @code{occur}
address@hidden Using @t{occur}
@section Using @code{occur}
@cindex Occurrences, listing with @code{@@occur}
@@ -22930,7 +22941,7 @@
for more information.
address@hidden Running @code{Info-validate}
address@hidden Running @t{Info-validate}
@section Finding Badly Referenced Nodes
@anchor{Running address@hidden old name
@@ -22955,14 +22966,14 @@
if you write an Info file from scratch.
@menu
-* Using @code{Info-validate}:: How to run @code{Info-validate}.
+* Using @t{Info-validate}:: How to run @code{Info-validate}.
* Unsplit:: How to create an unsplit file.
* Tagifying:: How to tagify a file.
* Splitting:: How to split a file manually.
@end menu
address@hidden Using @code{Info-validate}
address@hidden Using @t{Info-validate}
@subsection Using @code{Info-validate}
@cindex Using @code{Info-validate}
@@ -23110,7 +23121,7 @@
have make such a large buffer to hold the information.
If an Info file has more than 30 nodes, you should also make a tag
-table for it. @xref{Using @code{Info-validate}}, for information
+table for it. @xref{Using @t{Info-validate}}, for information
about creating a tag table. (Again, tag tables are usually created
automatically by the formatting command; you only need to create a tag
table yourself if you are doing the job manually. Most likely, you
@@ -23257,7 +23268,7 @@
@item <copying text>
The expansion of an @code{@@copying} environment, if the manual has
-one (@address@hidden@@copying}}).
+one (@address@hidden@@copying}}).
@item <dir entries>
The result of any @code{@@dircategory} and @code{@@direntry}
@@ -23380,7 +23391,7 @@
End:
@end example
address@hidden@code{@@documentencoding}}.
address@hidden@t{@@documentencoding}}.
@node Info Format Regular Nodes