branch master updated: * doc/texinfo.texi (EPUB HTML): Add a @nodedescription. Make explicit that it is texi2any setting variables internally, not anything that the user needs to or can do.

[Gavin D. Smith]

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

gavin pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new 7f3713ba89 * doc/texinfo.texi (EPUB HTML): Add a @nodedescription.  
Make explicit that it is texi2any setting variables internally, not anything 
that the user needs to or can do.
7f3713ba89 is described below

commit 7f3713ba8912fd2aefa430d74b82d5f23a9836db
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Tue Apr 2 20:36:42 2024 +0100

    * doc/texinfo.texi (EPUB HTML): Add a @nodedescription.  Make
    explicit that it is texi2any setting variables internally, not
    anything that the user needs to or can do.
---
 ChangeLog        |  6 ++++++
 doc/texinfo.texi | 22 +++++++++++++---------
 2 files changed, 19 insertions(+), 9 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 4715577468..fa8b1903c4 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2024-04-02  Gavin Smith <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi (EPUB HTML): Add a @nodedescription.  Make
+       explicit that it is texi2any setting variables internally, not
+       anything that the user needs to or can do.
+
 2024-04-02  Gavin Smith <gavinsmith0123@gmail.com>
 
        * doc/texinfo.texi (Customization of Navigation and Headers):
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index f721cedf55..918a3bfd52 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -17355,25 +17355,29 @@ set @code{CHECK_HTMLXREF} to 0.
 
 
 @node EPUB HTML
+@nodedescription Variables set internally.
 @subsection HTML Generated for EPUB
 
 The HTML generated for EPUB is XHTML conformant, UTF-8 encoded, and
 formatted without the usual HTML navigation headers and footers.
-Most of these features are enabled with customization variables, such as
-@code{USE_XML_SYNTAX}, @code{HEADERS} or @code{OUTPUT_ENCODING_NAME}.  Some
-features of printed output are used in EPUB@.  In particular, the Top node does
-not appear in the EPUB output, while a title page is generated.  This is
-obtained by setting @code{NO_TOP_NODE_OUTPUT}.
-@xref{HTML Output Customization}.
+
+@command{texi2any} achieves this internally by setting customization
+variables, such as @code{USE_XML_SYNTAX}, @code{HEADERS} or
+@code{OUTPUT_ENCODING_NAME}.  Some features of printed output are used
+in EPUB@.  In particular, the Top node does not appear in the EPUB
+output, while a title page is generated.  This is obtained by setting
+@code{NO_TOP_NODE_OUTPUT}.  @xref{HTML Output Customization}.
 
 The @code{OUTFILE} and @code{SUBDIR} customization variables values
 correspond initially to the EPUB directory container and/or the
 EPUB output file (@pxref{EPUB Output File and Directory}).  These
 customization variables values are undefined or reset to the
 locations in the container directory where the XHTML files are output
-for the HTML generation.  It is mentioned here because resetting
-customization variables is unusual; however, the variables reset are
-used internally for the conversion, and should not interact with any
+for the HTML generation.
+
+This use of customization variables by @command{texi2any} is mentioned here
+because resetting such variables is unusual; however, the variables reset
+are used internally for the conversion, and should not interact with any
 customization set by the user.