[Top][All Lists]

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

[groff] 02/39: doc/ Fix content and style nits.

From: G. Branden Robinson
Subject: [groff] 02/39: doc/ Fix content and style nits.
Date: Sun, 9 Oct 2022 23:53:35 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 95fa09dae009659583a1f3ea8f6f77234849e99a
Author: G. Branden Robinson <>
AuthorDate: Thu Oct 6 23:02:30 2022 -0500

    doc/ Fix content and style nits.
    * Annotate display vertical spacing `\n(dv` as a percentage.
    * Stop saying footnote and delayed text is "automatically"; the
      mechanism is spelled out; nothing more should be implied.
    * Take notice of the fact that footnotes might contain something other
      than text.
    * Use active voice more.
    * Wrap `sz` presentation and its preceding section heading in a keep
      because we've bought so much space on the previous page.  Temporarily
      set `bs` register to zero to make the keep invisible.
    * Tighten description of `sz` macro considerably.
    * Try to clarify usage of `TH`.
    * Suppress sentence-ending detection after a Latin abbreviation.
    * Drop spurious word.
 doc/ | 60 +++++++++++++++++++++++++--------------------------------
 1 file changed, 26 insertions(+), 34 deletions(-)

diff --git a/doc/ b/doc/
index ec9f41458..464a66ace 100644
--- a/doc/
+++ b/doc/
@@ -703,7 +703,7 @@ by an extra
 of vertical space
 and use a vertical spacing of
 .NR (dv
 Long quotation pre- and post-space is stored in a dedicated register,
 while centered blocks have none;
 both use the vertical spacing of normal text,
@@ -870,7 +870,7 @@ Input until
 .b .)d
 is saved for later output by
 .b .pd .
-Delayed text regions are automatically numbered
+Delayed text regions are numbered
 starting at 1;
 the number is kept in
 .NR ($d
@@ -906,7 +906,7 @@ Input until
 .b .)f
 is saved for output
 when the foot of the page is reached.
-Footnotes are automatically numbered
+Footnotes are numbered
 starting at 1;
 the number is kept in
 .NR ($f
@@ -939,9 +939,9 @@ by
 Footnotes line up underneath
 columns in the page layout.
 .\" XXX: Quantify when debugged.  See Savannah #58447, #63163, #63164.
-If the text of the footnote
+If the footnote's content
 does not fit on the page,
-it is carried over
+it carries over
 to the next.
 .b .)f
@@ -1029,7 +1029,7 @@ Emit index
 .i X
 .b x ]
-using the current font style and type size
+using the current font and type size
 with display vertical spacing
 .NR (dv ).
@@ -1082,6 +1082,8 @@ Like
 but begin a column
 on a new page
 only if necessary. bs 0
 .sh 1 "Type Size and Font Styles"
 .b .sz
@@ -1090,33 +1092,23 @@ only if necessary.
 Set the type size to
 .i \(+-p
-and the vertical spacing proportionally
-(see section \[lq]Displays\[rq] above).
-This size is
+and the vertical spacing per
+.NR (tv .
+These do
 .i not
-persistent beyond most \*(ME macro calls:
-when a new paragraph is begun
-.b .pp ,
-.b .lp ,
-.b .ip ,
-.b .np ,
-.b .bu,
-the type size is set to that stored in
-.NR (pp
-(paragraph point size).
+persist beyond most \*(ME macro calls:
+when a paragraphing macro is called,
+the type size and vertical spacing are set.
-.NR (fp
-(footnote point size),
-.NR (qp
-(long quotation point size),
-.NR (sp
-(section heading point size),
+section headings,
+long quotations,
-.NR (tp
-(title point size)
-set the type size of their corresponding contexts.
+chapter titles
+alter these parameters.
+.)b bs \n(ps
 The following macros
 style or decorate an argument
@@ -1310,8 +1302,8 @@ is
 .b H ,
 you can call
 .b .TH
-after the table header
-to repeat it across columns or pages.
+after some table rows
+to repeat them across columns or pages.
 If you want a table to float,
 surround the
 .b .TS
@@ -1575,7 +1567,7 @@ is called.
 Format a chapter heading
 centered in boldface.
-The text is
+The text
 .ST (wc
 .b Chapter ]
@@ -2140,7 +2132,7 @@ Those marked with
 changing them may have unexpected side effects.
 The degree sign \(de notes features requiring AT&T device-independent
 \*T extensions
-(ca. 1981),
+(ca.\& 1981),
 and a square \(sq labels \*G extensions.
 .de $H
 .ev 1

reply via email to

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