branch master updated: * doc/texinfo.texi (Global Customization Variables) (Other Customization Variables): split 'Global Customization Variables' out of 'Other Customization Variables'.

[Patrice Dumas]

This is an automated email from the git hooks/post-receive script.

pertusus pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new cd0dad4939 * doc/texinfo.texi (Global Customization Variables) (Other 
Customization Variables): split 'Global Customization Variables' out of 'Other 
Customization Variables'.
cd0dad4939 is described below

commit cd0dad4939ec0e314a506bf8fbaff9bf58744b32
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Fri Apr 5 23:36:55 2024 +0200

    * doc/texinfo.texi (Global Customization Variables)
    (Other Customization Variables): split 'Global Customization
    Variables' out of 'Other Customization Variables'.
---
 ChangeLog        |   6 +
 doc/texinfo.texi | 467 ++++++++++++++++++++++++++++---------------------------
 2 files changed, 244 insertions(+), 229 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 35de89a96d..ff7f20db05 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2024-04-05  Patrice Dumas  <pertusus@free.fr>
+
+       * doc/texinfo.texi (Global Customization Variables)
+       (Other Customization Variables): split 'Global Customization
+       Variables' out of 'Other Customization Variables'.
+
 2024-04-05  Patrice Dumas  <pertusus@free.fr>
 
        * tp/Texinfo/Convert/Converter.pm (determine_files_and_directory),
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 22dde12f1b..290679c4f8 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -11801,7 +11801,7 @@ This command changes the translation of various 
@dfn{document strings}
 such as ``see'' in cross-references (@pxref{Cross References}),
 ``Function'' in defuns (@pxref{Definition Commands}), and so on.
 Optionally, this command may also affect how @command{texi2any}
-sorts indices (@pxref{Other Customization Variables}, under
+sorts indices (@pxref{Global Customization Variables}, under
 @code{DOCUMENTLANGUAGE_COLLATION}).
 
 Note that in Info output, some strings, such as ``Node:'', ``Next:'',
@@ -13651,7 +13651,7 @@ such lines.
 The @command{texi2any} program recognizes these lines by default,
 except within @code{@@verbatim} blocks (@pxref{@code{@@verbatim}}).
 Their recognition can be turned off completely with
-@code{CPP_LINE_DIRECTIVES} (@pxref{Other Customization Variables}),
+@code{CPP_LINE_DIRECTIVES} (@pxref{Global Customization Variables}),
 though there is normally no reason to do so.
 
 For those few programs (M4, CPP, Texinfo) which need to document
@@ -15360,6 +15360,7 @@ The sections below give the details for each of these.
 @menu
 * Commands: Customization Variables for @@-Commands.
 * Options:  Customization Variables and Options.
+* Global:   Global Customization Variables.
 * LaTeX:    @LaTeX{} Customization Variables.
 * Info:     Info and Plaintext Customization Variables.
 * Other:    Other Customization Variables.
@@ -15537,143 +15538,11 @@ exec texi2any -c TEXINPUT_OUTPUT_FORMAT=textcontent 
"$@@"
 @end table
 
 
-@node @LaTeX{} Customization Variables
-@subsection @LaTeX{} Customization Variables
-
-@cartouche
-@quotation warning
-@LaTeX{} output customization is experimental.  Nothing is decided,
-everything can change, and we would welcome any feedback.
-@end quotation
-@end cartouche
-
-This table gives the customization variables which apply to @LaTeX{} output
-only.
-
-@vtable @code
-@item CLASS_BEGIN_USEPACKAGE
-If set, the corresponding text will replace the @LaTeX{} @code{\documentclass},
-package imports that are always output and are output right after
-@code{\documentclass}, and package imports that depend on the document encoding
-setting the input and font encoding (@code{inputenc} and @code{fontenc}).
-
-The text replaced is along:
-@example LaTeX
-\documentclass@{book@}
-\usepackage@{amsfonts@}
-\usepackage@{amsmath@}
-\usepackage[gen]@{eurosym@}
-\usepackage@{textcomp@}
-\usepackage@{graphicx@}
-\usepackage@{etoolbox@}
-\usepackage@{titleps@}
-\usepackage[utf8]@{inputenc@}
-\usepackage[T1]@{fontenc@}
-@end example
-
-@item END_USEPACKAGE
-If set, the corresponding text will replace the package imports that depend
-on the Texinfo commands used, and the last packages imports that are always
-output and output after all the other packages imports.  The last package
-imports corresponds to @samp{\usepackage[hidelinks]@{hyperref@}}.
-
-Here is an example of the corresponding text for a document with indices,
-@code{@@need}, @code{@@multitable}, definition commands, @code{@@cartouche},
-lists, and @code{@@float}:
-@example LaTeX
-\usepackage@{imakeidx@}
-\usepackage@{needspace@}
-\usepackage@{array@}
-\usepackage@{embrac@}
-\usepackage@{expl3@}
-\usepackage@{tabularx@}
-\usepackage[framemethod=tikz]@{mdframed@}
-\usepackage@{enumitem@}
-\usepackage@{float@}
-\usepackage[hidelinks]@{hyperref@}
-@end example
-@end vtable
-
+@node Global Customization Variables
+@subsection Global Customization Variables
 
-@node Info and Plaintext Customization Variables
-@subsection Info and Plaintext Customization Variables
-
-This table gives the customization variables which apply to Info
-and Plaintext formats only.
-
-@vtable @code
-@item ASCII_DASHES_AND_QUOTES
-For Info output, when set, use plain ASCII characters to represent
-quotation marks, hyphens and dashes when these are given in the Texinfo
-source as @samp{-}, @samp{--}, @samp{---}, @samp{`}, @samp{``},
-@samp{'}, and @samp{''}, rather than UTF-8 directional quotation marks,
-en dashes, vel sim.  On by default.
-
-@item ASCII_GLYPH
-For Info output, use ASCII output for glyph commands such as the copyright
-sign (@command{@@copyright@{@}}, becoming @samp{(C)}),
-and the bullet symbol (@command{@@bullet@{@}}, becoming @samp{*}), rather
-than other Unicode sequences.  Off by default.
-
-@item ASCII_PUNCTUATION
-Avoid any unncessary or gratuitious non-ASCII, UTF-8 sequences in the
-output.  Implies both @code{ASCII_DASHES_AND_QUOTES} and @code{ASCII_GLYPH}
-and additionally affects the output of commands such as @code{@@samp} which
-output quotation marks.
-
-@item AUTO_MENU_DESCRIPTION_ALIGN_COLUMN
-For Info output, column at which to start a menu entry description
-provided by @code{@@nodedescription} or @code{@@nodedescriptionblock}.
-Undefined by default, in which case 45% of the fill column value is used
-(@pxref{Invoking @command{texi2any}}).
-
-@item AUTO_MENU_MAX_WIDTH
-Maximum number of columns in a menu entry line in Info when adding a
-description from @code{@@nodedescription} or @code{@@nodedescriptionblock}.
-Undefined by default, in which case 10% more than the fill column value
-is used (@pxref{Invoking @command{texi2any}}).
-
-@item CLOSE_DOUBLE_QUOTE_SYMBOL
-When a closing double quote is needed, for @samp{@@dfn} in Info, use this
-character.  The default for Info is set the same as for
-@code{OPEN_DOUBLE_QUOTE_SYMBOL}, except that the Unicode code is a closing
-double quote (see below).
-
-@item INDEX_SPECIAL_CHARS_WARNING
-If set, warn about @samp{:} in index entry, as not all Info readers may
-be able to process these.  For Info and plaintext only.  Default false,
-because parsing problems there don't prevent navigation; readers can still
-relatively easily find their way to the node in question.
-
-@item INFO_SPECIAL_CHARS_QUOTE
-If set, whenever there are problematic characters for Info output in
-places such as node names or menu items, surround the part of the
-construct where they appear with quoting characters, as described in
-@ref{Info Format Specification}.  Default is set for Info and unset
-for plaintext.  @xref{Node Line Requirements}.
-
-@item INFO_SPECIAL_CHARS_WARNING
-If set, warn about problematic constructs for Info output (such as the
-string @samp{::}) in node names, menu items, and cross-references.
-If not defined, set unless @code{INFO_SPECIAL_CHARS_QUOTE} is set.
-Default is set for Info and not defined for plaintext. Similar warnings in
-index entries are covered by @code{INDEX_SPECIAL_CHARS_WARNING}.
-
-@item OPEN_DOUBLE_QUOTE_SYMBOL
-When an opening double quote is needed, for @samp{@@dfn} output in Info, use
-the specified character.  If @option{--disable-encoding} is set or the document
-encoding is not UTF-8, @samp{"} is used.  Otherwise, the Info output uses a
-Unicode left double quote.
-
-@end vtable
-
-
-@node Other Customization Variables
-@subsection Other Customization Variables
-
-This table gives the remaining customization variables, which apply to
-multiple formats, or affect global behavior, or otherwise don't fit
-into the categories of the previous sections.
+This table gives the customization variables which affect the global behavior
+of @command{texi2any}.
 
 @vtable @code
 @item CHECK_MISSING_MENU_ENTRY
@@ -15687,17 +15556,6 @@ are not consistent with the order of node menu 
entries.  This is a more
 thorough structure check than that provided by
 @code{CHECK_MISSING_MENU_ENTRY}.  Off by default.
 
-@item CLOSE_QUOTE_SYMBOL
-When a closing quote is needed, e.g. for @code{@@samp} output, use
-this character; default @code{&#8217;} in DocBook.
-Undefined in the default case in HTML and set to @code{&rsquo;}
-if @code{USE_NUMERIC_ENTITY} is not set, to @code{&#8217;} if set, and
-to a quote character if @code{OUTPUT_CHARACTERS} is set and the output
-encoding includes that character.
-
-The default for Info is set the same as for @code{OPEN_QUOTE_SYMBOL},
-except that the Unicode code is a closing quote (see below).
-
 @item COLLATION_LANGUAGE
 By default, @command{texi2any} sorts document indices according to the
 @dfn{Unicode Collation Algorithm} (defined in
@@ -15760,14 +15618,6 @@ is used for the encoding of file content.
 
 The @code{OUTPUT_FILE_NAME_ENCODING} variable overrides this variable.
 
-@vindex SystemLiteral
-@item DOCTYPE
-For DocBook, HTML, XML@.  Specifies the @code{SystemLiteral}, the
-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 value is different for each of HTML, DocBook
-and XML.
-
 @item DOCUMENTLANGUAGE_COLLATION
 If set, try to use the language specified in a @code{@@documentlanguage}
 directive for language-specific tailoring of index sorting.
@@ -15783,10 +15633,6 @@ source is also expanded to the corresponding file.  
Default false.
 For debugging.  If set, the tree constructed upon parsing a Texinfo
 document is output to standard error; default false.
 
-@item EXTENSION
-The extension added to the output file name.  The default is different
-for each output format.
-
 @item FORMAT_MENU
 If set to @samp{menu}, output Texinfo menus.  This is the default for
 Info.  @samp{sectiontoc} is the default setting for HTML, where instead
@@ -15836,57 +15682,11 @@ It is also used for command-line argument passed to 
commands called from
 @command{texi2any}.  For example, @command{latex2html} will be called from
 @command{texi2any} if @code{HTML_MATH} is set to @samp{l2h}.
 
-@item NO_TOP_NODE_OUTPUT
-@anchor{@code{NO_TOP_NODE_OUTPUT}}
-If set do not output the Top node content.  The Top node is still
-parsed, but the content is discarded.  Not set in the default case
-for HTML@.  Set in the default case for EPUB@.  If @code{SHOW_TITLE}
-is @samp{undef}, setting @code{NO_TOP_NODE_OUTPUT} also sets
-@code{SHOW_TITLE} for HTML.
-
-Setting @code{NO_TOP_NODE_OUTPUT}, which removes the Top node and adds
-a title page corresponds more to the formatting of a book.  Setting
-@code{NO_TOP_NODE_OUTPUT} to false, with @code{SHOW_TITLE} remaining
-@samp{undef}, and false, corresponds more to a document setup for browsing,
-with a direct access to the information at the Top node.
-
-For DocBook, @code{NO_TOP_NODE_OUTPUT} is set to true.  Setting
-@code{NO_TOP_NODE_OUTPUT} to false causes the Top node content to be
-output.  It is not recommended to output the Top node in DocBook as
-the title and copying informations are always output.  This option
-is kept for DocBook for compatibility, as before 2022 the Top node was output
-in DocBook.  It could be removed in the future.
-
-@item NODE_NAME_IN_MENU
-If set, use node names in menu entries, otherwise prefer section names;
-default true.
-
-@item OPEN_QUOTE_SYMBOL
-When an opening quote is needed, e.g., for @samp{@@samp} output, use
-the specified character; default @code{&#8216;} for DocBook.
-Undefined in the default case in HTML and set to @code{&lsquo;}
-if @code{USE_NUMERIC_ENTITY} is not set, to @code{&#8216;} if set, and
-to a quote character if @code{OUTPUT_CHARACTERS} is set and the output
-encoding includes that character.
-
-For Info, the default depends on the enabled document encoding.  If
-@option{--disable-encoding} is set or the document encoding is not UTF-8,
-@samp{'} is used.  This character usually appears
-as an undirected single quote on modern systems.  Otherwise, the Info
-output uses a Unicode left quote.
-
-@item OUTPUT_CHARACTERS
-If not set, the default, output accented and special characters in HTML, XML
-and DocBook using XML entities, and in @LaTeX{} using macros.  If set, output
-accented characters in HTML, XML, DocBook and @LaTeX{} output and special
-characters in HTML and @LaTeX{} output based on the document encoding.
-@xref{@code{@@documentencoding}}, and @ref{Inserting Accents}.
-
 @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
-@code{@@documentencoding}), this information is used to set the output 
+@code{@@documentencoding}), this information is used to set the output
 encoding name, otherwise the output encoding is based on the
 default encoding.  @xref{@code{@@documentencoding}}.
 
@@ -15945,23 +15745,11 @@ reference file, as is done for the tests.  The 
default is false.
 Name of the command used to produce PostScript, PDF, and DVI; default
 @samp{texi2dvi}.  @xref{@command{texi2any} Printed Output}.
 
-@item TEXINFO_DTD_VERSION
-For XML@.  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{TEXINFO_OUTPUT_FORMAT} is set to @code{textcontent}).  If set,
 also output comments.  Default false.
 
-@item TOP_NODE_UP
-Up node for the Top node; default @samp{(dir)}.  This node name is
-supposed to be already formatted for the output format.  In HTML
-can be used in attribute, so should not contain any element.  Used for
-HTML output only if @code{TOP_NODE_UP_URL} is set to override the URL@:,
-see @code{TOP_NODE_UP_URL} in @ref{HTML Customization Variables List}.
-@xref{File Names and Links Customization for HTML}.
-
 @item TREE_TRANSFORMATIONS
 The associated value is a comma separated list of transformations that
 can be applied to the Texinfo tree prior to outputting the result.  If
@@ -16026,15 +15814,6 @@ the @code{@@item}.  Remove the index @@-command from 
the tree.
 
 @end ftable
 
-@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.  The default is true.
-
-@item USE_NUMERIC_ENTITY
-For HTML, XML and DocBook@.  If set, use numeric entities instead of named
-entities.  By default, set to true for DocBook output.
-
 @item USE_SETFILENAME_EXTENSION
 Default is on for Info, off for other output.  If set, use exactly
 what @code{@@setfilename} gives for the output file name, including
@@ -16068,6 +15847,236 @@ transliterate more characters; default true.
 @end vtable
 
 
+@node @LaTeX{} Customization Variables
+@subsection @LaTeX{} Customization Variables
+
+@cartouche
+@quotation warning
+@LaTeX{} output customization is experimental.  Nothing is decided,
+everything can change, and we would welcome any feedback.
+@end quotation
+@end cartouche
+
+This table gives the customization variables which apply to @LaTeX{} output
+only.
+
+@vtable @code
+@item CLASS_BEGIN_USEPACKAGE
+If set, the corresponding text will replace the @LaTeX{} @code{\documentclass},
+package imports that are always output and are output right after
+@code{\documentclass}, and package imports that depend on the document encoding
+setting the input and font encoding (@code{inputenc} and @code{fontenc}).
+
+The text replaced is along:
+@example LaTeX
+\documentclass@{book@}
+\usepackage@{amsfonts@}
+\usepackage@{amsmath@}
+\usepackage[gen]@{eurosym@}
+\usepackage@{textcomp@}
+\usepackage@{graphicx@}
+\usepackage@{etoolbox@}
+\usepackage@{titleps@}
+\usepackage[utf8]@{inputenc@}
+\usepackage[T1]@{fontenc@}
+@end example
+
+@item END_USEPACKAGE
+If set, the corresponding text will replace the package imports that depend
+on the Texinfo commands used, and the last packages imports that are always
+output and output after all the other packages imports.  The last package
+imports corresponds to @samp{\usepackage[hidelinks]@{hyperref@}}.
+
+Here is an example of the corresponding text for a document with indices,
+@code{@@need}, @code{@@multitable}, definition commands, @code{@@cartouche},
+lists, and @code{@@float}:
+@example LaTeX
+\usepackage@{imakeidx@}
+\usepackage@{needspace@}
+\usepackage@{array@}
+\usepackage@{embrac@}
+\usepackage@{expl3@}
+\usepackage@{tabularx@}
+\usepackage[framemethod=tikz]@{mdframed@}
+\usepackage@{enumitem@}
+\usepackage@{float@}
+\usepackage[hidelinks]@{hyperref@}
+@end example
+@end vtable
+
+
+@node Info and Plaintext Customization Variables
+@subsection Info and Plaintext Customization Variables
+
+This table gives the customization variables which apply to Info
+and Plaintext formats only.
+
+@vtable @code
+@item ASCII_DASHES_AND_QUOTES
+For Info output, when set, use plain ASCII characters to represent
+quotation marks, hyphens and dashes when these are given in the Texinfo
+source as @samp{-}, @samp{--}, @samp{---}, @samp{`}, @samp{``},
+@samp{'}, and @samp{''}, rather than UTF-8 directional quotation marks,
+en dashes, vel sim.  On by default.
+
+@item ASCII_GLYPH
+For Info output, use ASCII output for glyph commands such as the copyright
+sign (@command{@@copyright@{@}}, becoming @samp{(C)}),
+and the bullet symbol (@command{@@bullet@{@}}, becoming @samp{*}), rather
+than other Unicode sequences.  Off by default.
+
+@item ASCII_PUNCTUATION
+Avoid any unncessary or gratuitious non-ASCII, UTF-8 sequences in the
+output.  Implies both @code{ASCII_DASHES_AND_QUOTES} and @code{ASCII_GLYPH}
+and additionally affects the output of commands such as @code{@@samp} which
+output quotation marks.
+
+@item AUTO_MENU_DESCRIPTION_ALIGN_COLUMN
+For Info output, column at which to start a menu entry description
+provided by @code{@@nodedescription} or @code{@@nodedescriptionblock}.
+Undefined by default, in which case 45% of the fill column value is used
+(@pxref{Invoking @command{texi2any}}).
+
+@item AUTO_MENU_MAX_WIDTH
+Maximum number of columns in a menu entry line in Info when adding a
+description from @code{@@nodedescription} or @code{@@nodedescriptionblock}.
+Undefined by default, in which case 10% more than the fill column value
+is used (@pxref{Invoking @command{texi2any}}).
+
+@item CLOSE_DOUBLE_QUOTE_SYMBOL
+When a closing double quote is needed, for @samp{@@dfn} in Info, use this
+character.  The default for Info is set the same as for
+@code{OPEN_DOUBLE_QUOTE_SYMBOL}, except that the Unicode code is a closing
+double quote (see below).
+
+@item INDEX_SPECIAL_CHARS_WARNING
+If set, warn about @samp{:} in index entry, as not all Info readers may
+be able to process these.  For Info and plaintext only.  Default false,
+because parsing problems there don't prevent navigation; readers can still
+relatively easily find their way to the node in question.
+
+@item INFO_SPECIAL_CHARS_QUOTE
+If set, whenever there are problematic characters for Info output in
+places such as node names or menu items, surround the part of the
+construct where they appear with quoting characters, as described in
+@ref{Info Format Specification}.  Default is set for Info and unset
+for plaintext.  @xref{Node Line Requirements}.
+
+@item INFO_SPECIAL_CHARS_WARNING
+If set, warn about problematic constructs for Info output (such as the
+string @samp{::}) in node names, menu items, and cross-references.
+If not defined, set unless @code{INFO_SPECIAL_CHARS_QUOTE} is set.
+Default is set for Info and not defined for plaintext. Similar warnings in
+index entries are covered by @code{INDEX_SPECIAL_CHARS_WARNING}.
+
+@item OPEN_DOUBLE_QUOTE_SYMBOL
+When an opening double quote is needed, for @samp{@@dfn} output in Info, use
+the specified character.  If @option{--disable-encoding} is set or the document
+encoding is not UTF-8, @samp{"} is used.  Otherwise, the Info output uses a
+Unicode left double quote.
+
+@end vtable
+
+
+@node Other Customization Variables
+@subsection Other Customization Variables
+
+This table gives the customization which apply to multiple formats.
+
+@vtable @code
+@item CLOSE_QUOTE_SYMBOL
+When a closing quote is needed, e.g. for @code{@@samp} output, use
+this character; default @code{&#8217;} in DocBook.
+Undefined in the default case in HTML and set to @code{&rsquo;}
+if @code{USE_NUMERIC_ENTITY} is not set, to @code{&#8217;} if set, and
+to a quote character if @code{OUTPUT_CHARACTERS} is set and the output
+encoding includes that character.
+
+The default for Info is set the same as for @code{OPEN_QUOTE_SYMBOL},
+except that the Unicode code is a closing quote (see below).
+
+@vindex SystemLiteral
+@item DOCTYPE
+For DocBook, HTML, XML@.  Specifies the @code{SystemLiteral}, the
+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 value is different for each of HTML, DocBook
+and XML.
+
+@item EXTENSION
+The extension added to the output file name.  The default is different
+for each output format.
+
+@item NO_TOP_NODE_OUTPUT
+@anchor{@code{NO_TOP_NODE_OUTPUT}}
+If set do not output the Top node content.  The Top node is still
+parsed, but the content is discarded.  Not set in the default case
+for HTML@.  Set in the default case for EPUB@.  If @code{SHOW_TITLE}
+is @samp{undef}, setting @code{NO_TOP_NODE_OUTPUT} also sets
+@code{SHOW_TITLE} for HTML.
+
+Setting @code{NO_TOP_NODE_OUTPUT}, which removes the Top node and adds
+a title page corresponds more to the formatting of a book.  Setting
+@code{NO_TOP_NODE_OUTPUT} to false, with @code{SHOW_TITLE} remaining
+@samp{undef}, and false, corresponds more to a document setup for browsing,
+with a direct access to the information at the Top node.
+
+For DocBook, @code{NO_TOP_NODE_OUTPUT} is set to true.  Setting
+@code{NO_TOP_NODE_OUTPUT} to false causes the Top node content to be
+output.  It is not recommended to output the Top node in DocBook as
+the title and copying informations are always output.  This option
+is kept for DocBook for compatibility, as before 2022 the Top node was output
+in DocBook.  It could be removed in the future.
+
+@item NODE_NAME_IN_MENU
+If set, use node names in menu entries, otherwise prefer section names;
+default true.
+
+@item OPEN_QUOTE_SYMBOL
+When an opening quote is needed, e.g., for @samp{@@samp} output, use
+the specified character; default @code{&#8216;} for DocBook.
+Undefined in the default case in HTML and set to @code{&lsquo;}
+if @code{USE_NUMERIC_ENTITY} is not set, to @code{&#8216;} if set, and
+to a quote character if @code{OUTPUT_CHARACTERS} is set and the output
+encoding includes that character.
+
+For Info, the default depends on the enabled document encoding.  If
+@option{--disable-encoding} is set or the document encoding is not UTF-8,
+@samp{'} is used.  This character usually appears
+as an undirected single quote on modern systems.  Otherwise, the Info
+output uses a Unicode left quote.
+
+@item OUTPUT_CHARACTERS
+If not set, the default, output accented and special characters in HTML, XML
+and DocBook using XML entities, and in @LaTeX{} using macros.  If set, output
+accented characters in HTML, XML, DocBook and @LaTeX{} output and special
+characters in HTML and @LaTeX{} output based on the document encoding.
+@xref{@code{@@documentencoding}}, and @ref{Inserting Accents}.
+
+@item TEXINFO_DTD_VERSION
+For XML@.  Version of the DTD used in the XML output preamble.  The
+default is set based on a variable in @file{configure.ac}.
+
+@item TOP_NODE_UP
+Up node for the Top node; default @samp{(dir)}.  This node name is
+supposed to be already formatted for the output format.  In HTML
+can be used in attribute, so should not contain any element.  Used for
+HTML output only if @code{TOP_NODE_UP_URL} is set to override the URL@:,
+see @code{TOP_NODE_UP_URL} in @ref{HTML Customization Variables List}.
+@xref{File Names and Links Customization for HTML}.
+
+@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.  The default is true.
+
+@item USE_NUMERIC_ENTITY
+For HTML, XML and DocBook@.  If set, use numeric entities instead of named
+entities.  By default, set to true for DocBook output.
+
+@end vtable
+
+
 @node Internationalization of Document Strings
 @nodedescription Translating program-inserted text.
 @section Internationalization of Document Strings