Re: mandoc and volume titles

From: Baptiste Daroussin <bapt_at_FreeBSD.org>
Date: Thu, 09 Jun 2022 07:17:02 UTC
On Wed, Jun 08, 2022 at 04:35:08PM -0700, Steve Kargl wrote:
> 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

Hello Steve,

Regarding mandoc, I would like to keep it with as little custom patches
as possible, regarding your patch, it sounds like a useful feature, have
you considered talking directly to upstream about it to see if they are
willing to integrate it directly?

https://mandoc.bsd.lv/contact.html ?

They are friendly and usually reactive.

Best regards,
Bapt