branch master updated: * doc/texinfo.texi (Nodes): No need to compare cross-references with the "document structure". (Node Line Requirements): Avoid obscure word "unicity". Tweak reference to node name quoting support. (Cross Reference Parts): Consistent referencing to xref targets.

[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 a413b8d166 * doc/texinfo.texi (Nodes): No need to compare 
cross-references with the "document structure". (Node Line Requirements): Avoid 
obscure word "unicity".  Tweak reference to node name quoting support. (Cross 
Reference Parts): Consistent referencing to xref targets.
a413b8d166 is described below

commit a413b8d16604722e907036cab2650b1b3b8b5b12
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Wed Jul 20 21:58:47 2022 +0100

    * doc/texinfo.texi
    (Nodes): No need to compare cross-references with the "document
    structure".
    (Node Line Requirements): Avoid obscure word "unicity".  Tweak
    reference to node name quoting support.
    (Cross Reference Parts): Consistent referencing to xref targets.
---
 ChangeLog        | 11 ++++++++++-
 doc/texinfo.texi | 16 +++++++---------
 2 files changed, 17 insertions(+), 10 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 14f881ae06..c79046758a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,4 +1,13 @@
-2022-07-05  Gavin Smith  <gavinsmith0123@gmail.com>
+2022-07-20  Gavin Smith  <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi
+       (Nodes): No need to compare cross-references with the "document
+       structure".
+       (Node Line Requirements): Avoid obscure word "unicity".  Tweak
+       reference to node name quoting support.
+       (Cross Reference Parts): Consistent referencing to xref targets.
+
+2022-07-20  Gavin Smith  <gavinsmith0123@gmail.com>
 
        Edit recent changes for grammar and style and make other minor edits.
 
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 0df646258c..d159885a1c 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -2755,8 +2755,7 @@ user to move to related nodes.  The HTML output can be 
similarly navigated.
 Nodes are used as the targets of cross-references.  Cross-references,
 such as the one at the end of this sentence, are made with @code{@@xref}
 and related commands; see @ref{Cross References}.  Cross-references can
-be sprinkled throughout the text, and provide a way to represent links
-that do not fit the main document structure.  Other @@-commands may also
+be sprinkled throughout the text.  Other @@-commands may also
 be the target of cross-references (@pxref{@code{@@anchor}}, @pxref{Floats}).
 
 Normally, you put a node command immediately before each chapter
@@ -2939,9 +2938,8 @@ chapters, sections, and the like.  Thus you can end each 
chapter with
 a section called ``Summary'', so long as the node names for those
 sections are all different.
 
-Unicity extends to anchor names (@pxref{@code{@@anchor}}) and float labels
-(@pxref{@code{@@float}}). Node names, anchor names, and float labels may not
-conflict.
+Node names, anchor names (@pxref{@code{@@anchor}}),
+and float labels (@pxref{@code{@@float}}) must all be unique.
 
 @item
 @cindex Commands in node names
@@ -2973,8 +2971,8 @@ Unfortunately, you cannot reliably use periods, commas, 
or colons
 within a node name; these can confuse the Info reader.  Also, a node
 name may not start with a left parenthesis preceding a right
 parenthesis, as in @code{(not)allowed}, since this syntax is used to
-specify an external manual.  These limitations will be removed some
-day when Info-reading programs that recognize quoting of node names
+specify an external manual.  These limitations will be removed if
+Info-reading programs that recognize quoting of node names ever
 become common (@pxref{INFO_SPECIAL_CHARS_QUOTE}).
 
 @command{makeinfo} warns about such problematic usage in node names,
@@ -4374,8 +4372,8 @@ manuals).  This is the location to which the 
cross-reference takes
 you.  In a printed document, the location of the node provides the
 page reference only for references within the same document.
 Use @code{@@node} to define the node (@pxref{Writing a Node}),
-@code{@@anchor} (@pxref{@code{@@anchor}}), or @code{@@float} with
-a label (@pxref{@code{@@float}}).
+@code{@@anchor} (@pxref{@code{@@anchor}}), or @code{@@float}
+(@pxref{@code{@@float}}) with a label.
 
 Write a node name in a cross-reference in exactly the same way as in
 the @code{@@node} line, including the same capitalization; otherwise, the