groff-commit
[Top][All Lists]
Advanced

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

[groff] 02/21: groff_man*(7): Clarify and tighten wording.


From: G. Branden Robinson
Subject: [groff] 02/21: groff_man*(7): Clarify and tighten wording.
Date: Sat, 2 Mar 2024 01:25:00 -0500 (EST)

gbranden pushed a commit to branch master
in repository groff.

commit f4d8f5c49a88765414c75bdc4c677bdfb0773ec8
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Feb 25 23:26:51 2024 -0600

    groff_man*(7): Clarify and tighten wording.
    
    Also fix duplicate word.
    
    Also tweak dead-tree pagination.
---
 tmac/groff_man.7.man.in | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 3540b048b..4f0142aa7 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -422,7 +422,7 @@ to inset a region within a (sub)section.
 .RI [ footer-middle \~\c
 .RI [ footer-inside \~\c
 .RI [ header-middle ]]]
-Determine the contents of the page header and footer.
+Populate the page header and footer.
 _ifstyle()dnl
 .
 .I roff
@@ -494,7 +494,7 @@ there is no need to specify
 .I an.tmac
 will supply text for it.
 .
-The macro package may also abbreviate
+This package may abbreviate
 .I identifier
 and
 .I footer-inside
@@ -505,7 +505,7 @@ _endif()dnl
 if they would overrun the space available in the header and footer,
 respectively.
 .
-For HTML output,
+In HTML output,
 headers and footers are suppressed.
 .
 .
@@ -2170,7 +2170,7 @@ Several macros insert vertical space:
 and the deprecated
 .BR .HP .
 .
-The default inter-section and inter-paragraph spacing is
+The default inter-section and inter-paragraph spacing
 is 1v for terminals and 0.4v for typesetters.
 _ifstyle()dnl
 \(lqv\(rq is a unit of vertical distance,
@@ -3967,12 +3967,13 @@ it may furthermore correspond closely to the file name 
of the document.
 The
 .MR man 1
 librarian is designed to permit convenient access to man pages,
-resolving topics to man page identifiers and sections.
+resolving topics to man page identifiers.
 .
 Thus,
 you can type
-.RB \(lq "man fprintf" \(rq
-without having to know whether the installed document uses
+.RB \(lq "man fprintf" \(rq,
+and other pages can refer to it,
+without knowing whether the installed document uses
 \(lqprintf\(rq,
 \(lqfprintf\(rq,
 or even \(lqc_printf\(rq
@@ -4251,6 +4252,8 @@ _
 .TE
 .
 .
+.br
+.ne 4v
 .IP \(bu
 Why doesn't the package provide a string to insert an ellipsis?
 .



reply via email to

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