[groff] 05/14: [docs]: Clarify discussion of aliased names.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit a7e411c19667a4a9469e8776feb1f2002103a987
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Apr 20 12:43:13 2024 -0500

    [docs]: Clarify discussion of aliased names.
    
    Try to discourage the assumption that alias names are somehow special;
    they aren't.  A name is a name, in close analogy to hard links in Unix
    file systems.
---
 doc/groff.texi.in | 9 ++++-----
 man/groff.7.man   | 7 +++----
 2 files changed, 7 insertions(+), 9 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index dad6dd7f3..a0d14bbc6 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -464,7 +464,7 @@ Documentation License''.
 @title groff
 @subtitle The GNU implementation of @code{troff}
 @subtitle version @VERSION@
-@subtitle March 2024
+@subtitle April 2024
 @author Trent@tie{}A.@: Fisher
 @author Werner Lemberg
 @author G.@tie{}Branden Robinson
@@ -12870,10 +12870,9 @@ an error.  @xref{Writing Macros}.
 To remove an alias, call @code{rm} on its name.  The object itself is
 not destroyed until it has no more names.
 
-When a request, macro, string, or diversion is aliased, redefinitions
-and appendments ``write through'' alias names.  To replace an alias with
-a separately defined object, you must use the @code{rm} request on its
-name first.
+Redefinitions and appendments ``write through'' request, macro, string,
+and diversion names.  To replace an aliased object with a separately
+defined one, you must use the @code{rm} request on its name first.
 @endDefreq
 @c END Keep (roughly) parallel with section "Strings" of groff(7).
 
diff --git a/man/groff.7.man b/man/groff.7.man
index 9c28f9ed4..c0b828222 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5960,13 +5960,12 @@ and aliasing
 .br
 .ne 2v
 .P
-When a request,
+Redefinitions and appendments \[lq]write through\[rq] request,
 macro,
 string,
-or diversion is aliased,
-redefinitions and appendments \[lq]write through\[rq] alias names.
+and diversion names.
 .
-To replace an alias with a separately defined object,
+To replace an aliased object with a separately defined one,
 you must use the
 .B rm
 request on its name first.