[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo ChangeLog doc/texinfo.txi
|
From: |
karl |
|
Subject: |
texinfo ChangeLog doc/texinfo.txi |
|
Date: |
Fri, 14 Dec 2012 18:38:26 +0000 |
CVSROOT: /sources/texinfo
Module name: texinfo
Changes by: karl <karl> 12/12/14 18:38:26
Modified files:
. : ChangeLog
doc : texinfo.txi
Log message:
wording of defaults
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1474&r2=1.1475
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.500&r2=1.501
Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1474
retrieving revision 1.1475
diff -u -b -r1.1474 -r1.1475
--- ChangeLog 10 Dec 2012 01:34:12 -0000 1.1474
+++ ChangeLog 14 Dec 2012 18:38:25 -0000 1.1475
@@ -1,7 +1,13 @@
+2012-12-14 Karl Berry <address@hidden>
+
+ * doc/texinfo.txi (Other Customization Variables): edit
+ wording of defaults, etc.
+
2012-12-10 Patrice Dumas <address@hidden>
* configure.ac, tp/Makefile.am, tp/texi2any.pl, tp/Texinfo/Common.pm,
- tp/Texinfo/Convert/XML.pm, tp/maintain/catalog.xml.in,
tp/t/test_utils.pl,
+ tp/Texinfo/Convert/XML.pm, tp/maintain/catalog.xml.in,
+ tp/t/test_utils.pl,
doc/texinfo.txi (Other Customization Variables):
Add a new configure variable TEXINFO_DTD_VERSION that holds the version
of the dtd. Add the corresponding customization variable in tp/.
Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.500
retrieving revision 1.501
diff -u -b -r1.500 -r1.501
--- doc/texinfo.txi 10 Dec 2012 01:34:13 -0000 1.500
+++ doc/texinfo.txi 14 Dec 2012 18:38:25 -0000 1.501
@@ -1,5 +1,5 @@
\input texinfo.tex @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.500 2012/12/10 01:34:13 pertusus Exp $
address@hidden $Id: texinfo.txi,v 1.501 2012/12/14 18:38:25 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.
@@ -536,7 +536,7 @@
Internationalization
-* documentlanguage:: Declaring the current language.
+* @code{@@documentlanguage}:: Declaring the current language.
* documentencoding:: Declaring the input encoding.
Conditionally Visible Text
@@ -8453,7 +8453,7 @@
page without needing to be rewritten.
A smaller font size is also requested in HTML output, and (as usual)
-retained in the Texinfo XML transliteration.
+retained in the address@hidden transliteration.
Mark the end of an @code{@@address@hidden block with a corresponding
@code{@@end address@hidden For example, pair @code{@@smallexample} with
@@ -9709,7 +9709,7 @@
@item
@cindex SVG images, used in Docbook
-For DocBook, @code{makeinfo} outputs references to
+For Docbook, @code{makeinfo} outputs references to
@address@hidden, @address@hidden
@address@hidden, @address@hidden,
@address@hidden and @address@hidden, for every
@@ -13417,13 +13417,14 @@
supports, see @ref{Inserting Accents}.
@menu
-* documentlanguage:: Declaring the current language.
+* @code{@@documentlanguage}:: Declaring the current language.
* documentencoding:: Declaring the input encoding.
@end menu
address@hidden documentlanguage
address@hidden @code{@@documentlanguage}
@section @code{@@documentlanguage @address@hidden: Set the Document Language
address@hidden
@findex documentlanguage
@cindex Language, declaring
@@ -16689,7 +16690,7 @@
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
-(@pxref{documentlanguage}).
+(@address@hidden@@documentlanguage}}).
@item --dvi
@opindex --dvi
@@ -17388,19 +17389,20 @@
beginning of each HTML file; default unset.
@item AFTER_ABOUT
-For HTML, when an About'element is output. If set, the corresponding
+For HTML, when an About-element is output. If set, the corresponding
text will appear at the end of the About element; default unset.
@item AFTER_OVERVIEW
@itemx AFTER_TOC_LINES
For address@hidden If set, the corresponding text is output after the short
table of contents for @code{AFTER_OVERVIEW} and after the table of
-contents for @code{AFTER_TOC_LINES}, otherwise a default string is
-used (at the time of writing a @code{</div>} element is closed).
+contents for @code{AFTER_TOC_LINES}; otherwise, a default string is
+used. At the time of writing, a @code{</div>} element is closed.
+
+In general, you should set @code{BEFORE_OVERVIEW} if
address@hidden is set, and you should set
address@hidden if @code{AFTER_TOC_LINES} is set.
-In general you should set @code{BEFORE_OVERVIEW} if
address@hidden is set, and you should set @code{BEFORE_TOC_LINES}
-if @code{AFTER_TOC_LINES} is set.
@item BASEFILENAME_LENGTH
For address@hidden The maximum length of the base filenames; default 245.
@@ -17409,15 +17411,14 @@
@item BEFORE_OVERVIEW
@itemx BEFORE_TOC_LINES
-For address@hidden If set, the corresponding text is output before the
-short table of contents for @code{BEFORE_OVERVIEW} and before
-the table of contents for @code{BEFORE_TOC_LINES}, otherwise a
-default string is used (at the time of writing a
address@hidden<div ...>} element is opened).
-
-In general you should set @code{AFTER_OVERVIEW} if @code{BEFORE_OVERVIEW}
-is set, and you should set @code{AFTER_TOC_LINES} if @code{BEFORE_TOC_LINES}
-is set.
+For address@hidden If set, the corresponding text is output before the short
+table of contents for @code{BEFORE_OVERVIEW} and before the table of
+contents for @code{BEFORE_TOC_LINES}, otherwise a default string is
+used. At the time of writing, a @code{<div ...>} element is opened.
+
+In general you should set @code{AFTER_OVERVIEW} if
address@hidden is set, and you should set
address@hidden if @code{BEFORE_TOC_LINES} is set.
@item BIG_RULE
@@ -17428,7 +17429,8 @@
@item BODYTEXT
@cindex @code{<body>} text, customizing
For HTML, the text appearing in @code{<body>}. By default, set
-automatically taking into account the document language.
+automatically, taking into account the document language
+(@address@hidden@@documentlanguage}}).
@item CASE_INSENSITIVE_FILENAMES
For address@hidden Construct output file names as if the filesystem were case
@@ -17445,7 +17447,7 @@
@item CLOSE_QUOTE_SYMBOL
When a closing quote is needed, use this character; default @code{’}
-in HTML, @code{’} in DocBook.
+in HTML, @code{’} in Docbook.
@c @item COMPLETE_IMAGE_PATHS
@c If set, the image files are computed to be relative from the document
@@ -17457,7 +17459,7 @@
@item CPP_LINE_DIRECTIVES
Recognize @code{#line} directives in a ``preprocessing'' pass
-(@pxref{External Macro Processors}); on by default;
+(@pxref{External Macro Processors}); on by default.
@item CSS_LINES
For address@hidden CSS output, automatically determined by default
(@pxref{HTML CSS}).
@@ -17472,42 +17474,42 @@
@c available debugging output.
@item DEF_TABLE
-For address@hidden If this is set a @code{<table>} construction for
address@hidden@@deffn} and similar @@-commands is used (looking more like the
address@hidden output), instead of definition lists; default false.
+For address@hidden If set, a @code{<table>} construction for @code{@@deffn}
+and similar @@-commands is used (looking more like the @TeX{} output),
+instead of definition lists; default false.
@item DEFAULT_RULE
-For address@hidden Rule used between element, except after and before the
-top element, or before special elements, and for footers and headers;
-default is @code{<hr>}.
+For address@hidden Rule used between element, except before and after the
+top element, and before special elements, and for footers and headers;
+default @code{<hr>}.
@item DO_ABOUT
-If set to 0 never do an About special element.
-If set to 1 always do an About special element;
+If set to 0 never do an About special element;
+if set to 1 always do an About special element;
default 0.
@c @xref{Output Elements Defined}.
@item DOCTYPE
@vindex SystemLiteral
For Docbook, HTML, address@hidden Specifies the @code{SystemLiteral}, the
-entity's system identifier. It is a URI, which may be used to
+entity's system identifier. This is a URI which may be used to
retrieve the entity, and identifies the canonical DTD for the
-document. The default is different for HTML, DocBook and Texinfo
-XML.
+document. The default value is different for each of HTML, Docbook
+and address@hidden
@item DUMP_TEXI
-For debugging. If set, there is no conversion done, only parsing and
-macros expansion. If @option{--macro-expand} is set, the Texinfo
-source is also expanded to the corresponding file; default false.
+For debugging. If set, no conversion is done, only parsing and macro
+expansion. If the option @option{--macro-expand} is set, the Texinfo
+source is also expanded to the corresponding file. Default false.
@item DUMP_TREE
For debugging. If set, the tree constructed upon parsing a Texinfo
-document is output on standard error; default false.
+document is output to standard error; default false.
@item ENABLE_ENCODING_USE_ENTITY
For HTML, address@hidden If @option{--enable-encoding} is set, and there is an
entity corresponding with the letter or the symbol being output,
-prefer the entity. Set in the default case for HTML.
+prefer the entity. Set by default for HTML, but not XML.
@item EXTERNAL_CROSSREF_SPLIT
For cross references to other manuals, this determines if the other
@@ -17516,32 +17518,32 @@
Xref Configuration}.
@item EXTENSION
-The extension added to the output file name. In the default case,
-an extension specific of each output format is used.
+The extension added to the output file name. The default is different
+for each output format.
@item EXTERNAL_DIR
-For address@hidden Base directory for external manuals. It is better to use
-the general external cross reference mechanism (@pxref{HTML Xref
-Configuration}) and avoid this variable; default false.
+For address@hidden Base directory for external manuals; default none. It is
+better to use the general external cross reference mechanism
+(@pxref{HTML Xref Configuration}) than this variable.
@item EXTRA_HEAD
For HTML, additional text appearing within @code{<head>}; default unset.
@item FIX_TEXINFO
-For plain Texinfo (with @code{PLAINTEXINFO}). If set to false,
-the resulting Texinfo is not corrected of all errors, like missing
address@hidden@@end}; default true.
-
-This only has effect when expanding Texinfo, as other converter will
-always try to output something sane even if the Texinfo is broken.
+For ``plain Texinfo'' (see the @code{PLAINTEXINFO} item). If set to
+false, the resulting Texinfo does not have all errors corrected, such
+as missing @samp{@@end}; default true. This variable is only
+relevant when expanding Texinfo; other converters always try to
+output something sane even if the input is erroneous.
@item FOOTNOTE_END_HEADER_LEVEL
-For address@hidden Header formatting level used for footnotes header
-with footnotestyle end; default @samp{4}. @xref{Footnote Styles}.
+For address@hidden Header formatting level used for the footnotes header with
+the `end' footnotestyle; default @samp{4}. @xref{Footnote Styles}.
@item FOOTNOTE_SEPARATE_HEADER_LEVEL
-For address@hidden Header formatting level used for footnotes header
-with footnotestyle separate; default @samp{4}. @xref{Footnote Styles}.
+For address@hidden Header formatting level used for the footnotes header with
+the `separate' footnotestyle; default @samp{4}. @xref{Footnote
+Styles}.
@item FRAMES
For address@hidden If set, a file describing the frame layout is generated,
@@ -17583,12 +17585,12 @@
@item INDEX_ENTRY_COLON
Symbol used between the index entry and the associated node or section;
-default is @samp{:}.
+default @samp{:}.
@item INLINE_CONTENTS
For address@hidden If set, output the contents where the @code{@@contents}
and
-similar @@-commands are located; default true. Ignored if
address@hidden@@set*contentsaftertitlepage} is set.
+similar @@-commands are located; default true. This is Ignored if
address@hidden@@set*contentsaftertitlepage} is set (@pxref{Contents}).
@item INLINE_CSS_STYLE
For address@hidden Put CSS directly in HTML elements rather than at the
@@ -17617,11 +17619,11 @@
@item L2H
For address@hidden If set, @command{latex2html} is used to convert
@code{@@math}
-and @code{@@tex} sections. Best used with @option{--iftex}; default false.
+and @code{@@tex} sections; default false. Best used with @option{--iftex}.
@item L2H_CLEAN
-(Relevant only if @code{L2H} is set.) If this is set the intermediate
-files generated in relation with @command{latex2html} are removed; default
+(Relevant only if @code{L2H} is set.) If set, the intermediate files
+generated in relation with @command{latex2html} are removed; default
true.
@item L2H_FILE
@@ -17633,39 +17635,40 @@
@command{latex2html} call; default unset.
@item L2H_L2H
-The program invoked as @command{latex2html} if @code{L2H} is set;
-default is @code{latex2html}.
+(Relevant only if @code{L2H} is set.) The program invoked as
address@hidden; default is @code{latex2html}.
@item L2H_SKIP
-(Relevant only if @code{L2H} is set.) If this is set the actual call
-to @command{latex2html} is skipped; previously generated content is
-reused, instead. If set to 0, the cache is not used at all. If set
-to undef, the cache is used for as many @TeX{} fragments as possible
-and for the remaining the command is run; default is @samp{undef}.
+(Relevant only if @code{L2H} is set.) If set to a true value, the
+actual call to @command{latex2html} is skipped; previously generated
+content is reused instead. If set to 0, the cache is not used at all.
+If set to @samp{undef}, the cache is used for as many @TeX{} fragments as
+possible and for any remaining the command is run. The default is
address@hidden
@item L2H_TMP
(Relevant only if @code{L2H} is set.) Set the directory used for
temporary files. None of the file name components in this directory
name may start with @samp{.}; otherwise, @command{latex2html} will
-fail (because of @command{dvips}); default is an empty string,
-corresponding to the current directory.
+fail (because of @command{dvips}). The default is the empty string,
+which means the current directory.
@item MACRO_BODY_IGNORES_LEADING_SPACE
Ignore white space at the beginning of user defined macro body line,
mimicking a @TeX{} limitation (@pxref{Macro Details}). Default off.
@item MAX_MACRO_CALL_NESTING
-The maximal number of recursive calls of @@-commands defined
-through @code{@@rmacro}. The purpose of this variable is to avoid
-infinite recursions; default 100000.
+The maximal number of recursive calls of @@-commands defined through
address@hidden@@rmacro}; default 100000. The purpose of this variable is to
+avoid infinite recursions.
@item MAX_HEADER_LEVEL
For address@hidden Maximum header formatting level used (higher header
-formatting level correspond to lower level in sectioning); default
address@hidden
+formatting level numbers correspond to lower sectioning levels);
+default @samp{4}.
@item MENU_ENTRY_COLON
-Symbol used between the menu entry and the description; default is
+Symbol used between the menu entry and the description; default
@samp{:}.
@item MENU_SYMBOL
@@ -17674,14 +17677,14 @@
@item MONOLITHIC
For address@hidden Output only one file including the table of contents. Set
-by default, but it is only considered when the output is not split.
+by default, but only relevant when the output is not split.
@item NO_CSS
-For address@hidden Do not use CSS (@pxref{HTML CSS}); default false.
+For address@hidden Do not use CSS; default false. @xref{HTML CSS}.
@item NODE_FILE_EXTENSION
For address@hidden Extension for node files if @code{NODE_FILENAMES} is set;
-default is @samp{html}.
+default @samp{html}.
@item NODE_FILENAMES
If set, node names are used to construct file names. By default, it
@@ -17698,53 +17701,54 @@
@item OPEN_QUOTE_SYMBOL
When an opening quote is needed, use the corresponding character; default
address@hidden‘} in HTML, @code{‘} in DocBook.
address@hidden‘} for HTML, @code{‘} for Docbook.
@item OUTPUT_ENCODING_NAME
Normalized encoding name used for output files. Should be a usable
charset name in HTML, typically one of the preferred IANA encoding
-names. By default, if an input encoding is set, typically through
address@hidden@@documentencoding} or @code{INPUT_ENCODING_NAME}, this
+names. By default, if an input encoding is set (typically through
address@hidden@@documentencoding} or @code{INPUT_ENCODING_NAME}), this
information is used to set the output encoding name. If no input
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.
+otherwise specified. @xref{documentencoding,, @code{@@documentencoding}}.
@item OVERVIEW_LINK_TO_TOC
If set, the cross references in the Overview link to the corresponding
-Table of Contents entry; default true.
+Table of Contents entries; default true.
@item PACKAGE
@itemx PACKAGE_VERSION
@itemx PACKAGE_AND_VERSION
@itemx PACKAGE_URL
@itemx PACKAGE_NAME
-Package short name, package version, package name and version concatenated,
-package url and package name. In the default case these variables are set
-through autoconf/automake/configure.
+The implementation's short package name, package version, package name
+and version concatenated, package url, and full package name,
+respectively. By default, these variables are all set through
+Autoconf, Automake, and @code{configure}.
@item PRE_ABOUT
-For HTML, in case an About element is output.
-If set to a text string, this text will appear at the beginning of the
-About element. If set to a reference on a subroutine, the result
-of the subroutine call will appear at the beginning of the
-About element. If not set some default text is used.
+For HTML, when an About element is output. If set to a text string,
+this text will appear at the beginning of the About element. If set
+to a reference on a subroutine, the result of the subroutine call will
+appear at the beginning of the About element. If not set (the
+default), default text is used.
@item PRE_BODY_CLOSE
-For address@hidden If set, the corresponding text will appear at the footer of
-each HTML file; default unset.
+For address@hidden If set, the given text will appear at the footer of each
+HTML file; default unset.
@item PREFIX
-The output file prefix, which is prepended to some output files. By
-default it is set by @code{@@setfilename} or from the input file
+The output file prefix, which is prepended to some output file names.
+By default it is set by @code{@@setfilename} or from the input file
(@pxref{setfilename}). How this value is used depends on the value of
-other customization variables or command line options, such as split output
-and @code{NODE_FILENAMES}; default unset.
+other customization variables or command line options, such as wheter
+the output is split and @code{NODE_FILENAMES}. The default is unset.
@item PROGRAM
-Name of the program used. It is set automatically in the default case
-to the name of the program launched, with a trailing @samp{.pl} removed.
+Name of the program used. By default, it is set to the name of the
+program launched, with a trailing @samp{.pl} removed.
@item PROGRAM_NAME_IN_FOOTER
For address@hidden If set, output the program name and miscellaneous related
@@ -17752,15 +17756,15 @@
@item RENAMED_NODES_FILE
If set, use the value for the renamed nodes description file. If not
-set, the file is @file{<input_file_basename>-noderename.cnf}.
+set, the file is @address@hidden
@xref{HTML Xref Link Preservation}.
@item RENAMED_NODES_REDIRECTIONS
-If set, do redirection files for renamed nodes. Set by default when
-generating address@hidden
+If set, create redirection files for renamed nodes. Set by default
+when generating address@hidden
@item SHORTEXTN
-For address@hidden If this is set, use @samp{.htm} as extension; default
false.
+For address@hidden If set, use @samp{.htm} as extension; default false.
@item SHOW_MENU
@opindex --no-headers
@@ -17777,9 +17781,15 @@
@xref{Menu Parts}.
@item SORT_ELEMENT_COUNT
address@hidden texi-elements-by-size
address@hidden Longest nodes, finding
address@hidden Sorting nodes by size
If set, the name of a file to which a list of elements (nodes or
sections, depending on the output format) is dumped, sorted by the
-number of lines they contain after removal of @@-commands; default unset.
+number of lines they contain after removal of @@-commands; default
+unset. This is used by the program @code{texi-elements-by-size} in
+the @file{util/} directory of the Texinfo source distribution
+(@pxref{texi-elements-by-size}).
@item SORT_ELEMENT_COUNT_WORDS
When dumping the elements-by-size file (see preceding item), use word
@@ -17793,13 +17803,13 @@
@item TEST
If set to true, some variables which are normally dynamically
-generated anew for each run (the date, the program name, the version)
-are set to fixed and given values. This is useful to compare the
-output to a reference file, as is done for the tests; default false.
+generated anew for each run (date, program name, version) are set to
+fixed and given values. This is useful to compare the output to a
+reference file, as is done for the tests. The default is false.
@item TEXI2DVI
Name of the command used to produce PostScript, PDF, and DVI; default
-is @samp{texi2dvi}. @xref{texi2any Printed Output}.
address@hidden @xref{texi2any Printed Output}.
@item TEXI2HTML
@cindex compatibility, with @command{texi2html}
@@ -17807,18 +17817,18 @@
@command{texi2html}; default false.
@item TEXINFO_DTD_VERSION
-For address@hidden Version of the dtd used in the XML output preamble.
Default
-is set based on a configure.ac variable.
+For address@hidden Version of the DTD used in the XML output preamble. The
+default is set based on a variable in @file{configure.ac}.
@item TEXTCONTENT_COMMENT
For stripped text content output (i.e., when @code{TEXTCONTENT} is
-set). If set, also output comments. Default off.
+set). If set, also output comments. Default false.
@item TOC_FILE
@vindex INLINE_CONTENTS
-This file name is used for the table of contents. The extension is
-set appropriately, if necessary. It is only used if output is split
-and @code{INLINE_CONTENTS} is not set. Default is
+The value is used as the file name for the table of contents, if
+output is split and @code{INLINE_CONTENTS} is not set. The extension
+is set appropriately, if necessary. The default is
@address@hidden
@item TOC_LINKS
@@ -17831,25 +17841,25 @@
and is, in general, only taken into account when output is split, and
for address@hidden
address@hidden TOP_NODE_FILE
+For address@hidden File name used for the Top node, if @code{NODE_FILENAMES}
+is set; default is @code{index}.
+
address@hidden TOP_NODE_FILE_TARGET
+For address@hidden File name used for the Top node in cross references;
+default is @code{index}.
+
@item TOP_NODE_UP
Up node for the Top node; default @samp{(dir)}.
@item TOP_NODE_UP_URL
-Url used for the up node of the Top node for HTML; default
address@hidden, so no link is generated.
-
address@hidden TOP_NODE_FILE
-For address@hidden File used for the Top node, if @code{NODE_FILENAMES} is
-set; default is @code{index}.
-
address@hidden TOP_NODE_FILE_TARGET
-For address@hidden File used for the Top node in cross references; default
-is @code{index}.
+The url used for the Up pointer of the Top node for HTML; default
address@hidden, meaning no link is generated.
@item TREE_TRANSFORMATIONS
-The associated value is a comma separated list of transformations applied
-to the texinfo tree prior from outputting the result. The following
-transformations are currently supported:
+The associated value is a comma separated list of transformations
+applied to the Texinfo tree prior to outputting the result. The
+following transformations are currently supported:
@table @samp
@item fill_gaps_in_sectioning
@@ -17858,14 +17868,15 @@
@code{@@chapter} is followed by an @code{@@subsection}.
@item simple_menu
-Does the same as @code{SIMPLE_MENU}: use a simple preformatted style for the
-menu. It differs from setting @code{SIMPLE_MENU}, as @code{SIMPLE_MENU}
-will only have an effect for address@hidden
+Does the same as @code{SIMPLE_MENU}: use a simple preformatted style
+for the menu. It differs from setting @code{SIMPLE_MENU} in tat
address@hidden only has an effect in HTML output.
@item move_index_entries_after_items
-In @code{@@enumerate} and @code{@@itemize} move index entries
-appearing just before @code{@@item} after the @code{@@item}. Comment lines
-between index entries are moved too. Always done for HTML and DocBook outputs.
+In @code{@@enumerate} and @code{@@itemize}, move index entries
+appearing just before @code{@@item} after the @code{@@item}. Comment
+lines between index entries are moved too. Always done for HTML and
+Docbook outputs.
@item insert_nodes_for_sectioning_commands
Insert nodes for sectioning commands without node.
@@ -17887,7 +17898,7 @@
@item USE_ISO
For address@hidden Use entities for doubled single-quote characters
(@pxref{Inserting Quotation Marks}), and @samp{---} and @samp{--}
-(@pxref{Conventions, General Syntactic Conventions}); default true.
+(@pxref{Conventions}); default true.
@item USE_LINKS
@cindex @code{<link>} HTML tag, in @code{<head>}
@@ -17896,36 +17907,36 @@
output; default true.
@item USE_NODES
-Preferentially use nodes to decide where elements are separated.
-If set to false, preferentially use sectioning to decide where elements
-are separated; default true.
+Preferentially use nodes to decide where elements are separated. If
+set to false, preferentially use sectioning to decide where elements
+are separated. The default is true.
@item USE_NODE_TARGET
If set, use the node associated with a section for the section target
in cross references; default true.
@item USE_NUMERIC_ENTITY
-For HTML, address@hidden If set, use numeric entities instead of ASCII
-characters when there is no named entity. Set to true for HTML in the
-default case.
+For HTML and address@hidden If set, use numeric entities instead of ASCII
+characters when there is no named entity. By default, set to true for
+HTML.
@item USE_REL_REV
For address@hidden Use @code{rel} in cross references; default true.
@item USE_UP_NODE_FOR_ELEMENT_UP
Complete up sectioning direction with node direction when there is no
-sectioning up direction. In practice this could only happen when there is
-no @@top section. Not set in the default case.
+sectioning up direction. In practice this can only happen when there
+is no @@top section. Not set by default.
@item NO_USE_SETFILENAME
-If set, do not use @code{@@setfilename} to set the document name,
-base the document name only on the input file name
-(@pxref{setfilename}); default false.
+If set, do not use @code{@@setfilename} to set the document name;
+instead, base the output document name only on the input file name.
+The default is false.
@item USE_SETFILENAME_EXTENSION
-Default is on for Info, off for other output. If set, use what
address@hidden@@setfilename} gives for the output file name, including the
-extension. You should not need to explicitly set this variable.
+Default is on for Info, off for other output. If set, use exactly
+what @code{@@setfilename} gives for the output file name, including
+the extension. You should not need to explicitly set this variable.
@item USE_TITLEPAGE_FOR_TITLE
Use the full @code{@@titlepage} as the title, not a simple title string;
@@ -17934,33 +17945,33 @@
@item USE_UNIDECODE
@pindex Text::Unidecode
If set to false, do not use the @code{Text::Unidecode} Perl module to
-transliterate more characters. Default on.
+transliterate more characters; default true.
@item VERTICAL_HEAD_NAVIGATION
-For address@hidden If set, a vertical navigation panel is used. Default off.
+For address@hidden If set, a vertical navigation panel is used; default false.
@item WORDS_IN_PAGE
@cindex Navigation panel, bottom of page
For HTML, with output split at nodes. Specifies the approximate
minimum page length at which a navigation panel is placed at the
bottom of a page. To avoid ever having the navigation buttons at the
-bottom of a page, set this to a sufficiently large number. Default
-300.
+bottom of a page, set this to a sufficiently large number. The
+default is 300.
@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
-(@pxref{float}). Default off.
+(@pxref{float}). The default is off.
@item XREF_USE_NODE_NAME_ARG
For address@hidden Only relevant for cross reference commands with no cross
reference name (second argument). If set address@hidden, use the node name
(first) argument in cross reference @@-commands for the text displayed
as the hyperlink. If set address@hidden, use the node name if
address@hidden is set, or section name if @code{USE_NODES} is unset.
-If @code{undef}, use the first argument in preformatted environments,
address@hidden is set, otherwise the section name. If set to
address@hidden, use the first argument in preformatted environments,
otherwise use the node name or section name depending on
address@hidden Default @code{undef}.
address@hidden The default is @samp{undef}.
@end vtable
@@ -20172,7 +20183,7 @@
@item @@documentlanguage @var{CC}
Declare the document language as the two-character ISO-639 abbreviation
address@hidden @xref{documentlanguage,, @code{@@documentlanguage}}.
address@hidden @address@hidden@@documentlanguage}}.
@item @@address@hidden@address@hidden
Generate a dot accent over the character @var{c}, as in @dotaccent{o}.
@@ -21708,15 +21719,17 @@
@cindex Identification of documentation
The @samp{$Id:} comment is for the CVS (@pxref{Top,,, cvs, Concurrent
Versions System}), RCS (@pxref{Top,,, rcs, Revision Control System})
-or other version control systems, which expand it into a string such
+and other version control systems, which expand it into a string such
as:
+
@example
-$Id: texinfo.txi,v 1.500 2012/12/10 01:34:13 pertusus Exp $
+$Id: texinfo.txi,v 1.501 2012/12/14 18:38:25 karl Exp $
@end example
-(This is useful in all sources that use version control, not just manuals.)
-You may wish to include the @samp{$Id:} comment in the @code{@@copying}
-text, if you want a completely unambiguous reference to the
-documentation version.
+
+(This is potentially useful in all sources that use version control,
+not just manuals.) You may wish to include the @samp{$Id:} comment in
+the @code{@@copying} text, if you want a completely unambiguous
+reference to the documentation source version.
If you want to literally write @address@hidden, use @code{@@w}:
@code{@@address@hidden@}Id$}. Unfortunately, this technique does not work in