groff-commit
[Top][All Lists]
Advanced

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

[groff] 26/30: [man,mdoc]: Fix code style nits.


From: G. Branden Robinson
Subject: [groff] 26/30: [man,mdoc]: Fix code style nits.
Date: Thu, 10 Oct 2024 20:18:14 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit b46cc2ee2c98fbc439067331af19d4989cb19d9a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Oct 10 10:38:18 2024 -0500

    [man,mdoc]: Fix code style nits.
    
    * tmac/an.tmac:
    * tmac/doc.tmac: Fix code style nits; parallelize handling of rendering
      option registers and strings.
---
 ChangeLog     |  6 ++++++
 tmac/an.tmac  |  4 ++--
 tmac/doc.tmac | 45 +++++++++++++++++++++++++++------------------
 3 files changed, 35 insertions(+), 20 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 10460ee97..8d58062aa 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2024-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * tmac/an.tmac:
+       * tmac/doc.tmac: Fix code style nits; parallelize handling of
+       rendering option registers and strings.
+
 2024-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * tmac/refer.tmac (ref*biblio-item-sfx): Define new string (if
diff --git a/tmac/an.tmac b/tmac/an.tmac
index 8221fc7c3..d06f3c71f 100644
--- a/tmac/an.tmac
+++ b/tmac/an.tmac
@@ -1515,7 +1515,7 @@ contains unsupported escape sequence
 .if !r CS \
 .  nr CS 0
 .
-.\" full capitalization of page topic
+.\" full capitalization of page identifier
 .if !r CT \
 .  nr CT 0
 .
@@ -1658,7 +1658,7 @@ contains unsupported escape sequence
 .if !r SN \
 .  nr SN 3n
 .
-.\" URI enablement desired
+.\" hyperlinked text desired
 .if !r U \
 .  nr U 1
 .
diff --git a/tmac/doc.tmac b/tmac/doc.tmac
index bca57018d..8a39d0935 100644
--- a/tmac/doc.tmac
+++ b/tmac/doc.tmac
@@ -94,11 +94,21 @@
 .if r ps4html \
 .  nr doc-is-output-html 1
 .
-.\" Use -dAD to set the adjustment mode for ordinary body text.
+.\" adjustment mode
 .if !d AD \
 .  ds AD b\"
 .
-.\" Use -rC1 to consecutively number pages across multiple documents.
+.\" base paragraph indentation
+.if !r BP \
+.  nr BP 5n
+.
+.\" continuous rendering (one long page)
+.if !r cR \{\
+.  ie n .nr cR 1
+.  el   .nr cR 0
+.\}
+.
+.\" consecutive page numbering across multiple documents
 .\"
 .\" We must use consecutive page numbers when using PostScript to
 .\" generate HTML images; we must not reset the page number at the
@@ -114,17 +124,13 @@
 .if \n[doc-is-output-html] \
 .  nr C 1
 .
-.\" Use -rCS=1 to force capitalization of section headings.
-.if !r CS .nr CS 0
+.\" full capitalization of section headings
+.if !r CS \
+.  nr CS 0
 .
-.\" Use -rCT=1 to force capitalization of page titles in headers.
-.if !r CT .nr CT 0
-.
-.\" Use -rcR=0 for multiple pages instead of a single, very long page.
-.if !r cR \{\
-.  if t .nr cR 0
-.  if n .nr cR 1
-.\}
+.\" full capitalization of page identifier
+.if !r CT \
+.  nr CT 0
 .
 .\" If continuous rendering, tell tbl not to use keeps.
 .ie \n[cR] \
@@ -201,10 +207,12 @@
 .
 .\" \n[HY] is recognized for groff_man(7) compatibility, particularly
 .\" via andoc.tmac and man(1); see \n[doc-hyphen-flags] in doc-common.
-.if !r HY .nr HY 1
+.\"
+.\" hyphenation enablement
+.if !r HY \
+.  nr HY 1
 .
-.\" Use -rBP=<xxx> to set the paragraph indentation amount.
-.if !r BP .nr BP 5n
+.\" groff mdoc does _not_ use groff man's `IN` register.
 .
 .\" LL and LT registers are handled by the doc-setup-page-layout macro.
 .
@@ -257,10 +265,11 @@
 .  \}
 .\}
 .
-.\" Use -rSN=<xxx> to set the subsection heading indentation amount.
-.if !r SN .nr SN 3n
+.\" subsection indentation
+.if !r SN \
+.  nr SN 3n
 .
-.\" URI enablement desired
+.\" hyperlinked text desired
 .if !r U \
 .  nr U 1
 .



reply via email to

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