Date: Thu, 9 Jun 2022 09:17:02 +0200 From: Baptiste Daroussin <bapt@FreeBSD.org> To: Steve Kargl <sgk@troutmask.apl.washington.edu> Cc: freebsd-hackers@freebsd.org Subject: Re: mandoc and volume titles Message-ID: <20220609071702.umix3bbub3qxunlq@aniel.nours.eu> In-Reply-To: <YqEyLFHI8GQi6NLc@troutmask.apl.washington.edu> References: <YqEyLFHI8GQi6NLc@troutmask.apl.washington.edu>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20220609071702.umix3bbub3qxunlq>