[groff] 25/38: groff_mdoc(7): Make terminological reform.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit b235768759795ceb360b27973bf7fdfe493708c5
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Mar 22 21:04:21 2024 -0500

    groff_mdoc(7): Make terminological reform.
    
    Follow the identifier/topic distinction now used in groff_man(7).
    
    See commit 486e34725e, 25 February.
---
 tmac/groff_mdoc.7.man | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/tmac/groff_mdoc.7.man b/tmac/groff_mdoc.7.man
index 27dc71e52..4b9f54747 100644
--- a/tmac/groff_mdoc.7.man
+++ b/tmac/groff_mdoc.7.man
@@ -664,7 +664,7 @@ to construct a man page from the following template.
 .Bd -literal -offset indent
 \&.\e" The following three macro calls are required.
 \&.Dd date
-\&.Dt topic [section-identifier [section-keyword-or-title]]
+\&.Dt identifier [section-id [section-keyword-or-title]]
 \&.Os [package-or-operating system [version-or-release]]
 \&.Sh Name
 \&.Nm topic
@@ -853,7 +853,7 @@ belong to the page structure domain macros.
 .\" that kind of reader last _week_.
 .
 They designate the
-topic,
+page identifier and section of the manual,
 date of last revision,
 and the operating system or software project associated with the page.
 .
@@ -917,14 +917,16 @@ This macro is neither callable nor parsed.
 .
 .br
 .ne 5v
-.It Li .Dt Ar topic Op Ar section-identifier \
+.It Li .Dt Ar identifier Op Ar section-id \
 Op Ar section-keyword-or-title
 .
-.Ar topic
-is the subject of the man page.
+.Ar identifier
+and
+.Ar section-id
+together should uniquely indicate the man page on the system.
 .
 A
-.Ar section-identifier
+.Ar section-id
 that begins with an integer in the range 1\[en]9
 or is one of the words
 .Ql unass ,
@@ -2284,16 +2286,15 @@ The default width is 16n.
 .
 The
 .Ql \&Nm
-macro is used for the document title or page topic.
+macro identifies the document's central topic.
 .
 Upon its first call,
-it has the peculiarity of remembering its argument,
-which should always be the topic of the man page.
+it has the peculiarity of remembering its argument.
 .
 When subsequently called without arguments,
 .Ql \&Nm
 regurgitates this initial name for the sole purpose of making less work
-for the author.
+for the document's author.
 .
 Use of
 .Ql \&Nm