branch master updated: * doc/texinfo.texi (HTML Output Structure Customization) (JavaScript Interface and Licenses): add the 'JavaScript Interface and Licenses' node from content formerly in 'HTML Output Structure Customization'. Leave USE_NEXT_HEADING_FOR_LONE_NODE description in 'HTML Output Structure Customization'.

[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 8b36e3cffe * doc/texinfo.texi (HTML Output Structure Customization) 
(JavaScript Interface and Licenses): add the 'JavaScript Interface and 
Licenses' node from content formerly in 'HTML Output Structure Customization'.  
Leave USE_NEXT_HEADING_FOR_LONE_NODE description in 'HTML Output Structure 
Customization'.
8b36e3cffe is described below

commit 8b36e3cffe19d5fbb0cd0e429f004d424e61f3ac
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Tue Apr 2 19:26:31 2024 +0200

    * doc/texinfo.texi (HTML Output Structure Customization)
    (JavaScript Interface and Licenses): add the 'JavaScript Interface and
    Licenses' node from content formerly in 'HTML Output Structure
    Customization'.  Leave USE_NEXT_HEADING_FOR_LONE_NODE description in
    'HTML Output Structure Customization'.
    
    * doc/texinfo.texi (HTML Features Customization)
    (Customization of HTML Code Inserted): split 'General Customization of
    HTML Code' in two, with 'HTML Features Customization', containing the
    beginning of th eremoved node and COPIABLE_LINKS description and
    'Customization of HTML Code Inserted'.
    
    * doc/texinfo.texi (HTML Features Customization): add examples of
    DOCTYPE setting. Refer to the user of the program as "you".
    
    * doc/texinfo.texi (Customization of HTML Code Inserted): explain how
    opening and closing quotes are formatted by using a @table.
---
 ChangeLog        | 22 +++++++++++++-
 doc/texinfo.texi | 93 ++++++++++++++++++++++++++++++++++++--------------------
 2 files changed, 81 insertions(+), 34 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 1d82d4d975..b958331b25 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,6 +1,26 @@
 2024-04-02  Patrice Dumas  <pertusus@free.fr>
 
-       * doc/texinfo.texi (HTML Customization for Math):  Refer to the user
+       * doc/texinfo.texi (HTML Output Structure Customization)
+       (JavaScript Interface and Licenses): add the 'JavaScript Interface and
+       Licenses' node from content formerly in 'HTML Output Structure
+       Customization'.  Leave USE_NEXT_HEADING_FOR_LONE_NODE description in
+       'HTML Output Structure Customization'.
+
+       * doc/texinfo.texi (HTML Features Customization)
+       (Customization of HTML Code Inserted): split 'General Customization of
+       HTML Code' in two, with 'HTML Features Customization', containing the
+       beginning of th eremoved node and COPIABLE_LINKS description and
+       'Customization of HTML Code Inserted'.
+
+       * doc/texinfo.texi (HTML Features Customization): add examples of
+       DOCTYPE setting. Refer to the user of the program as "you". 
+
+       * doc/texinfo.texi (Customization of HTML Code Inserted): explain how
+       opening and closing quotes are formatted by using a @table.
+
+2024-04-02  Patrice Dumas  <pertusus@free.fr>
+
+       * doc/texinfo.texi (HTML Customization for Math): Refer to the user
        of the program as "you".
 
        * doc/texinfo.texi: replace 'In the default case' by 'By default'.
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 4e22c02ff1..6ac3ff1b17 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -17999,6 +17999,19 @@ set @code{MONOLITHIC} to 0 to output special elements 
to separate files.  As
 already described, the table of contents location may also be tuned with
 @code{CONTENTS_OUTPUT_LOCATION}.
 
+@vindex USE_NEXT_HEADING_FOR_LONE_NODE
+In Texinfo code, a @code{@@node} command is usually followed by a
+sectioning command, providing a heading for the node.  By default, a
+node with no following sectioning command, but followed by a command like
+@code{@@heading}, has its heading provided by the heading command.  This
+avoids having both the node name and the heading command as headings.  To
+have the node name used as heading in that case, set
+@code{USE_NEXT_HEADING_FOR_LONE_NODE} to 0.
+
+
+@node JavaScript Interface and Licenses
+@subsection JavaScript Interface and Licenses
+
 @vindex INFO_JS_DIR
 @cindex JavaScript browsing interface for HTML
 You can add an experimental JavaScript browsing interface to the manual by
@@ -18027,15 +18040,6 @@ website that includes your manual.
 Labels files are generated for @code{INFO_JS_DIR} and with @code{HTML_MATH}
 set to @samp{mathjax} for @code{MATHJAX_SOURCE} (@pxref{MathJax scripts}).
 
-@vindex USE_NEXT_HEADING_FOR_LONE_NODE
-In Texinfo code, a @code{@@node} command is usually followed by a
-sectioning command, providing a heading for the node.  By default, a
-node with no following sectioning command, but followed by a command like
-@code{@@heading}, has its heading provided by the heading command.  This
-avoids having both the node name and the heading command as headings.  To
-have the node name used as heading in that case, set
-@code{USE_NEXT_HEADING_FOR_LONE_NODE} to 0.
-
 
 @node File Names and Links Customization for HTML
 @subsection File Names and Links Customization for HTML
@@ -18282,12 +18286,8 @@ using an initialization file (@pxref{Invoking 
@command{texi2any}}).
 @xref{,,, texi2any_api, GNU Texinfo @command{texi2any} Output Customization}.
 
 
-@node General Customization of HTML Code
-@subsection General Customization of HTML Code
-
-You can modify the generated HTML code in two ways.  Firstly by specifying
-broad features of the generated HTML, and secondly by specifying HTML code
-to be inserted in specific places in the output.
+@node HTML Features Customization
+@subsection HTML Features Customization
 
 @vindex USE_XML_SYNTAX
 @cindex DOCTYPE customization
@@ -18300,6 +18300,20 @@ opening element, but no closing element, such as 
@code{<img>} or @code{<link>}
 To set the @dfn{DOCTYPE}, set the @code{DOCTYPE} customization variable.
 The default is the HTML5 DTD-less simple DOCTYPE.
 
+You can set an XML compatible file beginning instead:
+@example
+@command{texi2any} --html my_manual.texi -c USE_XML_SYNTAX \
+   -c DOCTYPE='<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html>'
+@end example
+
+You could also set the DOCTYPE to HTML 4.01 Transitional:
+@example
+@command{texi2any} --html my_manual.texi -c DOCTYPE=\
+'<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+  "http://www.w3.org/TR/html4/loose.dtd";>'
+@end example
+
 @vindex USE_ISO
 @vindex USE_NUMERIC_ENTITY
 @vindex OUTPUT_CHARACTERS
@@ -18319,16 +18333,39 @@ If it is not desirable, for example to generate 
strict XHTML, you can
 set @code{NO_CUSTOM_HTML_ATTRIBUTE} to prevent custom attributes being
 output.
 
+@vindex COPIABLE_LINKS
+Copiable links are output for link targets for the definition commands
+(@pxref{Definition Commands}), table commands (@pxref{Two-column
+Tables}) where an index entry is defined and headings.  A link appears
+as a `@U{00B6}'
+@c pilcrow sign
+sign that appears when you hover the mouse pointer over the heading text.
+Unset @code{COPIABLE_LINKS} to prevent copiable links output.
+
+
+@node Customization of HTML Code Inserted
+@subsection Customization of HTML Code Inserted
+
 @vindex CLOSE_QUOTE_SYMBOL
 @vindex OPEN_QUOTE_SYMBOL
-By default opening quote and closing quotes needed, e.g.  for
-@code{@@samp} output are set to @code{&lsquo;} and @code{&rsquo;} if
-@code{USE_NUMERIC_ENTITY} is not set, to @code{&#8216;} and @code{&#8217;} if
-set, and to a quote character if @code{OUTPUT_CHARACTERS} is set and the output
-encoding includes that character.  This default case corresponds to
-@code{OPEN_QUOTE_SYMBOL} and @code{CLOSE_QUOTE_SYMBOL} undefined.  Set those
-variables to the opening quote and to the closing quote respectively to
-override the default behaviour.
+Opening quote and closing quotes needed, e.g. for @code{@@samp} output
+are set to:
+
+@table @asis
+@item @code{&lsquo;} and @code{&rsquo;}
+By default, with @code{OPEN_QUOTE_SYMBOL} and @code{CLOSE_QUOTE_SYMBOL}
+undefined.
+
+@item @code{&#8216;} and @code{&#8217;}
+If you set @code{USE_NUMERIC_ENTITY}.
+
+@item An opening and closing quote character
+If you set @code{OUTPUT_CHARACTERS} and the output
+encoding includes that character.
+
+@item @code{OPEN_QUOTE_SYMBOL} and @code{CLOSE_QUOTE_SYMBOL}
+If you set those customization variables.
+@end table
 
 @vindex DEFAULT_RULE
 @vindex BIG_RULE
@@ -18337,17 +18374,7 @@ contexts, set @code{DEFAULT_RULE},
 used for most horizontal separators output in the resulting HTML,
 and set @code{BIG_RULE} for the wider separator sometime used.
 
-@vindex COPIABLE_LINKS
-Copiable links are output for link targets for the definition commands
-(@pxref{Definition Commands}), table commands (@pxref{Two-column
-Tables}) where an index entry is defined and headings.  A link appears
-as a `@U{00B6}'
-@c pilcrow sign
-sign that appears when you hover the mouse pointer over the heading text.
-Unset @code{COPIABLE_LINKS} to prevent copiable links output.
-
 @c Arguments are HTML content to be inserted at certain points in the output.
-
 @vindex HTML_ROOT_ELEMENT_ATTRIBUTES
 @vindex EXTRA_HEAD
 @vindex AFTER_BODY_OPEN