[Top][All Lists]

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

[groff] 40/40: groff_mdoc(7): Revise "Files" section.

From: G. Branden Robinson
Subject: [groff] 40/40: groff_mdoc(7): Revise "Files" section.
Date: Mon, 12 Dec 2022 19:28:08 -0500 (EST)

gbranden pushed a commit to branch master
in repository groff.

commit 94746cbd4f189ddc976448d97cb58170881b3618
Author: G. Branden Robinson <>
AuthorDate: Mon Dec 12 16:42:49 2022 -0600

    groff_mdoc(7): Revise "Files" section.
    Resurrect discussion of strings used for lookups by various mdoc
    macros, using accurate names this time.
 tmac/ | 48 ++++++++++++++++++++++++++++++++++++++++++------
 1 file changed, 42 insertions(+), 6 deletions(-)

diff --git a/tmac/ b/tmac/
index da0dc4bf4..d4cb3af1d 100644
--- a/tmac/
+++ b/tmac/
@@ -5092,12 +5092,21 @@ is a wrapper that loads
 defines macros,
 and strings
-primarily concerned with the production of formatted output.
+concerned with the production of formatted output.
 .\" XXX: This is a weak explanation.  The boundary between doc.tmac's
-.\" concerns and doc-common's is not at all clear to GBR.  Further, many
-.\" operating system-related strings are defined here that would seem
-.\" more appropriately placed in doc-syms.  Possibly all three of these
-.\" files should be merged.
+.\" concerns and doc-common's is not at all clear to GBR.  Should some
+.\" of these files be merged?
+It includes strings of the form
+.Ql doc\-volume\-ds\- Ns Ar X
+.Ql doc\-volume\-as\- Ns Ar X
+for manual section titles and architecture identifiers,
+.Ar X
+is an argument recognized by
+.Pf . Ic \&Dt .
 .It Pa @MACRODIR@/\:mdoc/\:doc\-nroff
@@ -5110,7 +5119,34 @@ defines parameters appropriate for rendering to 
typesetter devices.
 .It Pa @MACRODIR@/\:mdoc/\:doc\-syms
 defines many strings and macros that interpolate formatted text,
-such as names of operating systems and standards documents.
+such as names of operating system releases,
+*BSD libraries,
+and standards documents.
+The string names are of the form
+.Ql doc\-str\- Ns Ar O Ns Li \- Ns Ar V ,
+.Ql doc\-str\-St Ns Li \-\- Ns Ar S Ns Li \- Ns Ar I
+(observe the double dashes),
+.Ql doc\-str\-Lb\- Ns Ar L ,
+.Ar O
+is one of the operating system macros from section
+.Sx "General text domain"
+.Ar V
+is an encoding of an operating system release
+(sometimes omitted along with the
+.Ql \-
+preceding it),
+.Ar S
+an identifier for a standards body or committee,
+.Ar I
+one for an issue of a standard promulgated by
+.Ar S ,
+.Ar L
+a keyword identifying a *BSD library.
 .It Pa @LOCALMACRODIR@/\:mdoc\:.local

reply via email to

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