mandoc and volume titles

Reply: Baptiste Daroussin : "Re: mandoc and volume titles"
Reply: Steve Kargl : "Re: mandoc and volume titles"
Go to: [ bottom of page ] [ top of archives ] [ this month ]

From: Steve Kargl <sgk_at_troutmask.apl.washington.edu>
Date: Wed, 08 Jun 2022 23:35:08 UTC

All,

mandoc and mdoc(7) are a convenient system for writing
documentation, but it has a drawback.  The volume
title is hardcoded to a FreeBSD manual page.  For my
personal projects, I would like to change the volume
title.  For example.

% mandoc tier.1 | head -1
TIER(1)           FreeBSD General Commands Manual             TIER(1)

I have hacked up mandoc to accept a -V option, which allows e.g.,

% mandoc -V "Steve's Menagerie" tier.1 | head -1
TIER(1)                  Steve's Menagerie                     TIER(1)

I have created a bug report and attached the diff to it
if anyone is interested.

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=264560

-- 
Steve