gbranden pushed a commit to branch master
in repository groff.
commit e7b0bd101f84f9ab85783132614932a073fe2260
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Oct 4 04:04:07 2026 -0500
groff_man*(7): Strengthen stylesheet concept.
Except for a handful, man's strings and registers are reserved to the
user.
Writing a man(7) document for public distribution? KEEPA U HANDS OFF!
(That reference is so old, I can smell the leaded gasoline...)
---
tmac/groff_man.7.man.in | 36 +++++++++++++++++++++++++++---------
1 file changed, 27 insertions(+), 9 deletions(-)
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 28e624042..8794eba58 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -2510,19 +2510,29 @@ device.
.SS Registers
.\" ====================================================================
.
-Registers are described in section \[lq]Options\[rq] below.
+The
+.I man
+package reserves certain registers
+to permit a document's readers to fine tune its rendering.
+.
+By not manipulating these registers,
+the document honors user preferences.
.
-They can be set not only on the command line but in the site
+Configure such \[lq]stylesheet\[rq] registers on the command line
+(see section \[lq]Options\[rq] below)
+or in the
.I man.local
-file as well;
-see section \[lq]Files\[rq] below.
+file
+(see section \[lq]Files\[rq] below).
.
.
.\" ====================================================================
.SS Strings
.\" ====================================================================
.
-The following strings are defined for use in man pages.
+The
+.I man
+package defines the following strings for use by documents.
.
_ifnotstyle()dnl
None of these is necessary in man pages
@@ -2532,7 +2542,7 @@ see
_endif()dnl
.
.I "groff man"
-supports others for configuration of rendering parameters;
+reserves others for configuration of rendering parameters;
see section \[lq]Options\[rq] below.
.
.
@@ -4684,9 +4694,17 @@ especially when no mark argument is supplied\[em]an
indentation argument
is not required.
.
By setting an explicit indentation,
-you may be overriding the reader's preference as set with the
-.B \-rIN
-option.
+you may be overriding the reader's
+.\" avoid stranded line at page top
+.\" ...and then hyphenated word at preceding page bottom
+.\" Note: `ne` defeats hyphenation value 2, because the trap isn't
+.\" "close" yet.
+.if t \%\c
+preference
+.ne 2v
+as set by the
+.B IN
+register.
.
If your page renders adequately without one,
use the simpler form.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
