[Top][All Lists]

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

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

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

gbranden pushed a commit to branch master
in repository groff.

commit 750227436d77f99f4e5eebb1150d9327035fd22a
Author: G. Branden Robinson <>
AuthorDate: Mon Dec 12 15:46:35 2022 -0600

    groff_mdoc(7): Revise "Description" section.
    * Try to soften the impact of the abstractions we immediately blitz the
      reader with.
    * Mention another use of the general text domain (abbreivation,
      basically), recognizing the substantial amount of macro name space
      given over to it.
 tmac/ | 29 +++++++++++++++--------------
 1 file changed, 15 insertions(+), 14 deletions(-)

diff --git a/tmac/ b/tmac/
index d0ead7246..f1437201d 100644
--- a/tmac/
+++ b/tmac/
@@ -74,10 +74,7 @@ document formatting system.
 .Xr mdoc
 is a
-.Em content-
-.Em domain Ns -based
-formatting package for writing
+structured and semantically oriented package for writing
 manual pages with
 .Xr @g@troff @MAN1EXT@ .
@@ -86,31 +83,35 @@ Its predecessor,
 .Xr man 7
-primarily addressed page layout concerns,
+primarily addressed page layout and presentational concerns,
 leaving the selection of fonts and other typesetting details to the
 individual author.
 This discretion has led to divergent styling practices among authors
 using it.
-.Xr mdoc ,
-page layout macros make up the
+.Xr mdoc
+organizes its macros into
+.Em domains .
+Those that lay out the page make up the
 .Em "page structure domain"
-that comprises macros for titles,
+comprising titles,
 section headings,
-and lists\[em]essentially items that affect the position of text on a
-formatted page.
+and lists.
 .Em "general text domain"
-contains macros to perfom tasks such as quoting or styling text.
+supplies macros to quote or style text,
+or to interpolate common noun phrases.
 .Em "manual domain"
-defines macros corresponding to the terminology used by practitioners
-in discussion of
+offers semantic macros corresponding to the terminology used by
+practitioners in discussion of

reply via email to

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