[Top][All Lists]

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

[groff] 48/49: doc/ Fix content nits.

From: G. Branden Robinson
Subject: [groff] 48/49: doc/ Fix content nits.
Date: Sun, 6 Nov 2022 00:37:24 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit e877c6d36b80002afefa15a2da499d8fb43321b3
Author: G. Branden Robinson <>
AuthorDate: Sat Nov 5 21:51:13 2022 -0500

    doc/ Fix content nits.
    * Drop word "string" from reference to macro arguments.  Strings are
      things you define with `ds` (`as`, etc.) and interpolate with `\*`.
    * Identify `bp` as a request so the reader doesn't expect to see it
      defined as part of this reference.
    * Add `.p` register to summary index.  We document the `pl` request
      (actually intercepted by a macro, but that's supposed to be
      transparent), so it makes sense to tell the user how to query the
      parameter we tell them how to set; q.v. `\n(.l`, `.ll`, `.xl`.
    * Use lowercase 'n' instead of 'S' as metasyntactic parameter to \s
      escape sequence, to follow convention established on first page.
 doc/ | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/doc/ b/doc/
index a9e88a054..9c3fe2bde 100644
--- a/doc/
+++ b/doc/
@@ -484,7 +484,7 @@ and
 .b .sx
 all three,
 but the first two
-are empty strings.
+are empty.
 .i n
 is present,
@@ -1693,7 +1693,7 @@ but other than
 that hardly ever used.
 Must be followed by a
 .b .bp
-or the end of input.
+request or the end of input.
 \*(ME uses \*T's environment 0 for body text,
 1 for keeps,
@@ -2226,6 +2226,7 @@ and a square \(sq labels \*G extensions.
 \en(.$ R\(sc   macro parameter count
 \en(.i R\(sc   current indentation
 \en(.l R\(sc   current line length
+\en(.p R\(sc   current page length
 \en(.s R\(sc   current type size in points
 \e0    F\(sc   unadjustable digit-width space
 \&.1c  M       end multi-column layout
@@ -2365,8 +2366,8 @@ and a square \(sq labels \*G extensions.
 \&.rr  M\(sc   remove register
 \&.rs  M\(sc   restore spacing (end no-space mode)
 \&.rt  M\(sc   return to vertical position set by \\fP
-\es\(aq\fI\,\(+-S\/\fP\(aq     F\(sc\(de       inline type size change\
- to/by \fIS\fP points
+\es\(aq\fI\,\(+-n\/\fP\(aq     F\(sc\(de       inline type size change\
+ to/by \fIn\fP points
 \en(sf R       section title font
 \&.sh  M       begin numbered section
 \en(si R       section indentation per level of depth

reply via email to

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