Hi Alex!
At 2022-10-30T19:16:51+0100, Alejandro Colomar wrote:
> I finally fixed the page titles for the Linux man-pages, using the
> same letter case as in the file name. I didn't compare against the
> NAME, as it would have complicated the script, and they normally
> match. I don't know from the top of my head if it's 100%, but we can
> assume some risk there.
For those to whom this change is coming as an unpleasant surprise, the
forthcoming groff 1.23.0 features an option that will reverse this
change at rendering time.
From groff_man(7):
-rCT=1 Capitalize titles, setting the man page title (the first
argument to .TH) in full capitals in headers and footers.
This transformation is off by default because it discards
case distinction information.
This register can also be set in a site-local "man.local" file to force
it on for all pages. On Debian-based systems, this file is in
/etc/groff. The following line will do the trick.
.nr CT 1
The groff_man_style(7) man page offers further examples of such
rendering customization.
/usr/local/share/groff/site-tmac/man.local
Put site‐local changes and customizations into this file.
.\" Use narrower indentation on terminals and similar.
.if n .nr IN 4n
.\" Put only one space after the end of a sentence.
.ss 12 0 \" See groff(7).
.\" Keep pages narrow even on wide terminals.
.if n .if \n[LL]>78n .nr LL 78n
.\" Ensure hyperlinks are enabled for terminals.
.nr U 1
On multi‐user systems, it is more considerate to users whose
preferences may differ from the administrator’s to be less
aggressive with such settings, or to permit their override
with a user‐specific man.local file. This can be achieved by
placing one or both of following requests at the end of the
site‐local file.
.soquiet \V[XDG_CONFIG_HOME]/man.local
.soquiet \V[HOME]/.man.local
However, a security‐sandboxed man(1) program may lack
permission to open such files.
Bertrand Garrigues and I hope to have the second groff 1.23.0 release
candidate out very soon; the list of unmet release-goal tickets is
almost exhausted.[1] I encourage people to have a look at what's
forthcoming in groff 1.23 and try building it from source; feedback will
improve the release.
https://git.savannah.gnu.org/cgit/groff.git/tree/ANNOUNCE
is a template for the release announcement.
https://git.savannah.gnu.org/cgit/groff.git/tree/NEWS
is a complete (we believe) list of user-visible changes in 1.23.
https://git.savannah.gnu.org/cgit/groff.git/tree/INSTALL.REPO
is a list of instructions for building groff from a Git checkout.
git clone https://git.savannah.gnu.org/git/groff.git
will get you started.
Regards,
Branden
[1] https://savannah.gnu.org/bugs/index.php?go_report=Apply&group=groff&func=&set=custom&msort=0&report_id=225&advsrch=0&bug_id=&summary=&submitted_by=0&resolution_id=0&assigned_to=0&bug_group_id=0&status_id=1&severity=0&category_id=0&plan_release_id=103&history_search=0&history_field=0&history_event=modified&history_date_dayfd=30&history_date_monthfd=10&history_date_yearfd=2022&chunksz=50&spamscore=5&boxoptionwanted=1#options
Attachment:
signature.asc
Description: PGP signature
