gbranden pushed a commit to branch master
in repository groff.
commit d003fa41eebaadeb7aae44ac0be6e2a9175d7fec
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Jul 5 20:40:44 2024 -0500
NEWS: Reorganize man(7) and mdoc(7) items.
Brandish garlic, crucifixes, running water, et al. against man page
document authors who might be tempted to abuse new user-oriented
rendering options.
---
NEWS | 21 +++++++++++++--------
1 file changed, 13 insertions(+), 8 deletions(-)
diff --git a/NEWS b/NEWS
index 941c80523..5da00dd71 100644
--- a/NEWS
+++ b/NEWS
@@ -245,6 +245,19 @@ o The an (man), doc (mdoc), and doc-old (mdoc-old) macro
packages have
can still instruct groff to format for any desired line length by
setting the `LL` register on {g,n,t}roff's command line.
+o The an (man) and doc (mdoc) macro packages now use slightly different
+ vertical margins to align more closely with the traditional
+ implementations of these packages. Per man(7) in the AT&T Unix System
+ III manual (June 1980), the text area was 6.5 by 10 inches (on
+ typesetters). When formatting for terminals with continuous rendering
+ disabled (by default, it is enabled), the page footer now sets 1 line
+ higher than before.
+
+o The an (man) and doc (mdoc) macro packages have added additional
+ registers `BP`, `PO`, and `TS` for user configuration of man page
+ rendering at formatting time. As noted in groff_man(7) and
+ groff_mdoc(7), documents should never manipulate these.
+
o The an (man) and doc (mdoc) macro packages now support a `BP` register
to configure the ("base") paragraph inset amount; that is the amount
used by man(7) for paragraphs not within an `RS`/`RE` relative inset,
@@ -271,14 +284,6 @@ o The an (man) macro package's `IP` macro no longer honors
the formerly
punctuation or a list enumerator for `IP`'s first argument, consider
migrating to `TP`.
-o The an (man) and doc (mdoc) macro packages now use slightly different
- vertical margins to align more closely with the traditional
- implementations of these packages. Per man(7) in the AT&T Unix System
- III manual (June 1980), the text area was 6.5 by 10 inches (on
- typesetters). When formatting for terminals with continuous rendering
- disabled (by default, it is enabled), the page footer now sets 1 line
- higher than before.
-
o The doc (mdoc) macro package's `Mt` macro now sets its argument in
roman, not italics (or whatever the string `doc-Pa-font` was
configured to use). A new string, `doc-Mt-font`, for use in
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
