branch master updated: * doc/texinfo.texi (Other Customization Variables): expand on NO_TOP_NODE_OUTPUT corresponding more to book formatting if set, or to browsing if not set.

[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 354b77fc72 * doc/texinfo.texi (Other Customization Variables): expand 
on NO_TOP_NODE_OUTPUT corresponding more to book formatting if set, or to 
browsing if not set.
354b77fc72 is described below

commit 354b77fc72faba32984c622759fc106942adcdc9
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Fri Mar 11 02:08:28 2022 +0100

    * doc/texinfo.texi (Other Customization Variables): expand
    on NO_TOP_NODE_OUTPUT corresponding more to book formatting
    if set, or to browsing if not set.
---
 ChangeLog        | 6 ++++++
 doc/texinfo.texi | 9 ++++++++-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/ChangeLog b/ChangeLog
index af83a4cc99..9270afa6e5 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2022-03-10  Patrice Dumas  <pertusus@free.fr>
+
+       * doc/texinfo.texi (Other Customization Variables): expand
+       on NO_TOP_NODE_OUTPUT corresponding more to book formatting
+       if set, or to browsing if not set.
+
 2022-03-10  Patrice Dumas  <pertusus@free.fr>
 
        * tp/tests/Makefile.am (input_file_names_recoded_stamp.txt):
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 5cad1b719a..ad960db592 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -16839,7 +16839,14 @@ avoid infinite recursions.
 @item 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.
+for HTML.  If @code{USE_TITLEPAGE_FOR_TITLE} is @samp{undef}, setting
+@code{NO_TOP_NODE_OUTPUT} also sets @code{USE_TITLEPAGE_FOR_TITLE}.
+
+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{USE_TITLEPAGE_FOR_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.
 
 @item NO_USE_SETFILENAME
 If set, do not use @code{@@setfilename} to set the document name;