[groff] 17/51: [mdoc]: Update comments.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit f023575c2c42ae5dc432642801a65d067c895ef3
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Sep 6 18:19:42 2022 -0500

    [mdoc]: Update comments.
    
    * tmac/mdoc/doc-common: Update comments.  Prevent whitespace leakage in
      string definitions, use idiomatic English, and drop stale annotation
      of string update from `Os` macro definition heading.
---
 tmac/mdoc/doc-common | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/tmac/mdoc/doc-common b/tmac/mdoc/doc-common
index 9e13ad0da..1bf5cd285 100644
--- a/tmac/mdoc/doc-common
+++ b/tmac/mdoc/doc-common
@@ -197,13 +197,13 @@
 .\" NS doc-document-title global string
 .\" NS   the title of the manual page
 .
-.ds doc-document-title UNTITLED
+.ds doc-document-title UNTITLED\"
 .
 .
 .\" NS doc-volume global string
-.\" NS   the volume where the manual page belongs to
+.\" NS   the volume to which the manual page belongs
 .
-.ds doc-volume LOCAL
+.ds doc-volume LOCAL\"
 .
 .
 .\" NS doc-section global string
@@ -399,17 +399,17 @@
 .
 .
 .\" NS doc-default-operating-system global string
-.\" NS   the exact (default) version of the operating system
+.\" NS   the default OS to associate with man pages
 .\" NS
 .\" NS override this in 'mdoc.local', if necessary
 .
-.ds doc-default-operating-system BSD
+.ds doc-default-operating-system BSD\"
 .
 .
 .\" NS doc-operating-system global string
-.\" NS   the exact version of the operating system
+.\" NS   the OS or software project associated with the man page
 .
-.ds doc-operating-system
+.ds doc-operating-system \" empty
 .
 .
 .\" NS Os user macro (not parsed, not callable)
@@ -417,7 +417,6 @@
 .\" NS
 .\" NS modifies:
 .\" NS   doc-operating-system
-.\" NS   doc-topic-name
 .\" NS
 .\" NS local variables:
 .\" NS   doc-operating-system-XXX-XXX