texinfo-commits
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

branch master updated: * doc/texinfo.texi (HTML Xref Configuration): edi


From: Gavin D. Smith
Subject: branch master updated: * doc/texinfo.texi (HTML Xref Configuration): edit description of splitting search order.
Date: Tue, 01 Oct 2024 13:57:09 -0400

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 a0efe2f41f * doc/texinfo.texi (HTML Xref Configuration): edit 
description of splitting search order.
a0efe2f41f is described below

commit a0efe2f41f8f75a38e3236e83a1a581fa53fabf1
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Tue Oct 1 18:53:16 2024 +0100

    * doc/texinfo.texi (HTML Xref Configuration): edit description
    of splitting search order.
---
 ChangeLog        |  5 +++++
 doc/texinfo.texi | 17 ++++++++++-------
 2 files changed, 15 insertions(+), 7 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index d1397adbda..edfc6c4907 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2024-10-01  Gavin Smith <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi (HTML Xref Configuration): edit description
+       of splitting search order.
+
 2024-07-27  Patrice Dumas  <pertusus@free.fr>
 
        * tp/Texinfo/Convert/HTML.pm (html_get_css_elements_classes)
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 17cb637e4c..1f8ac7727e 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -17972,13 +17972,16 @@ If the keyword is @code{node}, @code{section}, or 
@code{chapter},
 @var{urlprefix} gives the host and directory for @var{manual} split
 into nodes, sections, or chapters, respectively.
 
-When available, @command{texi2any} will use the ``corresponding''
-value for cross-references between manuals.  That is, when generating
-monolithic output (@option{--no-split}), the @code{mono} URL will be
-used, when generating output that is split by node, the @code{node}
-URL will be used, etc.  However, if a manual is not available in that
-form, anything that is available can be used.  Here is the search
-order for each style:
+When @command{texi2any} is generating a link to another Texinfo manual,
+it will prefer to use a line for the manual with the same
+splitting option as the current output.  That is, when generating
+monolithic output (@option{--no-split}), a @code{mono} URL will be
+preferred; when generating output that is split by node, a @code{node}
+URL will be preferred, etc.
+
+If no information line with the preferred splitting option is present
+for a given manual, then other lines for that manual can be used if
+present.  Here is the full search order for each splitting option:
 
 @example
 node    @result{} node,    section, chapter, mono



reply via email to

[Prev in Thread] Current Thread [Next in Thread]