gbranden pushed a commit to branch master
in repository groff.
commit eb5f3bc48b69eecb02172d45279e0f5e37741712
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Jan 22 12:41:31 2026 -0600
[man,mdoc]: Recommend ISO 8601 date format.
* tmac/groff_man.7.man.in (Document structure macros):
* tmac/groff_mdoc.7.man (Title macros): Explicitly recommend ISO
8601 date format.
Fixes <https://savannah.gnu.org/bugs/?66903>. Thanks to Alex Colomar
for the suggestion.
Also recast man(7)'s `TH` macro description, mainly to solve the dual
knapsack problem imposed by seeking to preserve pleasant page breaks
when formatting PostScript and PDF for U.S. letter paper in both
groff_man(7) _and_ groff_man_style(7).
---
ChangeLog | 9 +++++++++
tmac/groff_man.7.man.in | 34 +++++++++++++++-------------------
tmac/groff_mdoc.7.man | 3 ++-
3 files changed, 26 insertions(+), 20 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index fea893e7a..428fbeff1 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2026-01-22 G. Branden Robinson <[email protected]>
+
+ * tmac/groff_man.7.man.in (Document structure macros):
+ * tmac/groff_mdoc.7.man (Title macros): Explicitly recommend ISO
+ 8601 date format.
+
+ Fixes <https://savannah.gnu.org/bugs/?66903>. Thanks to Alex
+ Colomar for the suggestion.
+
2026-01-21 G. Branden Robinson <[email protected]>
* Makefile.am: Add "filename-length-max=99" to
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 676b3ee78..a6d9711d1 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -451,7 +451,12 @@ to inset a region within a (sub)section.
.RI [ footer-middle \~\c
.RI [ footer-inside \~\c
.RI [ header-middle ]]]
-Populate the page header and footer.
+Break the page,
+reset the page number to\~1
+(unless the
+.B \-rC1
+option is given),
+and use the arguments to populate the page header and footer.
_ifstyle()dnl
.
.I roff
@@ -537,21 +542,13 @@ ellipses
.RB ( .\|.\|.\& ).
_endif()dnl
.
-In HTML output,
-headers and footers are suppressed.
-.
-.
-.IP
-Additionally,
-this macro breaks the page,
-resetting the number to\~1
-(unless the
-.B \-rC1
-option is given).
+.I "groff man"
+suppresses headers and footers in HTML output.
.
-This feature is intended only for formatting multiple
-.I man
-documents in sequence.
+.\" Does anyone try to do anything different? GBR hasn't seen it.
+.\" This feature is intended only for formatting multiple
+.\" .I man
+.\" documents in sequence.
.
.
.IP
@@ -564,12 +561,11 @@ early in the file,
prior to any other macro calls.
_ifstyle()dnl
.
-.
-.IP
By convention,
.I footer-middle
-is the date of the most recent modification to the man page source
-document,
+is the date of the most recent modification to the source document,
+in ISO\~8601 format
+.RI ( YYYY - MM - DD ),
and
.I footer-inside
is the name and version or release of the project providing it.
diff --git a/tmac/groff_mdoc.7.man b/tmac/groff_mdoc.7.man
index 8ef0d6078..287868a85 100644
--- a/tmac/groff_mdoc.7.man
+++ b/tmac/groff_mdoc.7.man
@@ -948,7 +948,8 @@ the four-digit year.
This localism is not enforced,
however.
.
-You may prefer ISO 8601 format,
+.Xr groff
+recommends ISO\~8601 format,
.Em YYYY-MM-DD.
.
A
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
