mirror/groff
1
0
Fork 0
mirror of https://https.git.savannah.gnu.org/git/groff.git synced 2026-01-26 07:37:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

[man,mdoc]: Recommend ISO 8601 date format.

Browse Source 
* 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).
This commit is contained in:
G. Branden Robinson 2026-01-22 12:41:31 -06:00
parent c8b6ba92a1
commit eb5f3bc48b
3 changed files with 26 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
ChangeLog
View File

@ -1,3 +1,12 @@
2026-01-22 G. Branden Robinson <g.branden.robinson@gmail.com>
* 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 <g.branden.robinson@gmail.com>
* Makefile.am: Add "filename-length-max=99" to

34
tmac/groff_man.7.man.in
View File

@ -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.
.I "groff man"
suppresses headers and footers in HTML output.
.
.
.IP
Additionally,
this macro breaks the page,
resetting the number to\~1
(unless the
.B \-rC1
option is given).
.
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.

3
tmac/groff_mdoc.7.man
View File

@ -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