Date: Fri, 10 Jun 2022 14:31:26 +0200 From: Steffen Nurpmeso <steffen@sdaoden.eu> To: Steve Kargl <sgk@troutmask.apl.washington.edu> Cc: Baptiste Daroussin <bapt@freebsd.org>, freebsd-hackers@freebsd.org Subject: Re: mandoc and volume titles Message-ID: <20220610123126.oXt_A%steffen@sdaoden.eu> In-Reply-To: <YqJ1VOcJYbXBg85T@troutmask.apl.washington.edu> References: <YqEyLFHI8GQi6NLc@troutmask.apl.washington.edu> <20220609071702.umix3bbub3qxunlq@aniel.nours.eu> <YqIEl0SgJytjD%2BAW@troutmask.apl.washington.edu> <20220609152904.gc9ue%steffen@sdaoden.eu> <YqIiLQUI7Y/QH3Qg@troutmask.apl.washington.edu> <20220609165536.A5vGK%steffen@sdaoden.eu> <YqJihG7hegKkNj6M@troutmask.apl.washington.edu> <20220609214906.6--d0%steffen@sdaoden.eu> <YqJ1VOcJYbXBg85T@troutmask.apl.washington.edu>
next in thread | previous in thread | raw e-mail | index | archive | help
Steve Kargl wrote in
<YqJ1VOcJYbXBg85T@troutmask.apl.washington.edu>:
|On Thu, Jun 09, 2022 at 11:49:06PM +0200, Steffen Nurpmeso wrote:
|> Steve Kargl wrote in
...
|>|.ds volume-operating-system steve
|>|.ds volume-ds-8 kargl
|>
|> If you use ".Dt TDI 1", you must set volume-ds-1.
|>
|>|.Dd June 8, 2022
|>|.Dt TDI 1
|>|.Sh NAME
|>|.Nm tdi
|>|
|>|% mandoc tdi.1 | head -1
|>
|> This is mandoc Mr. Kargl.
...
|% cat steve.4
|.Dd June 8, 2022
|.ds doc-volume-operating-system Steve
|.ds doc-volume-ds-4 Kargl
|.Dt TDI 4
|.Sh NAME
|.Nm tdi
|Hi.
|% mandoc steve.4
Well you can ignore totally what i say. And you can mess up
software in the FreeBSD base system and introduce incompatible
islands whenever you want to.
I pointed out that the mandoc maintainer is currently having
a run, i think i saw .ds request fly by, and from that to
introducing up-upstream compatible handling of 20+ years old
mdoc(7) macros would only be a small step.
...
|Having to install groff and adding undocumented .ds magic isn't the
...
This is not magic but decade old stuff, whether you like it or
not.
#?0|kent:free-src.git$ git grep -i doc-volume-ds release/5.5.0~50784 |
wc -l
31
(I do not track anything before 5.5.0.)
|solution for a FreeBSD base system functionality. In fact, I think
|it would be better to have the mdoc(7) package grow a .Vl macro to
|allow the volume title to be easily overridden.
You can think whatever you want, and fill the remaining two letter
combinations until they are all gone.
Have a nice day.
--steffen
|
|Der Kragenbaer, The moon bear,
|der holt sich munter he cheerfully and one by one
|einen nach dem anderen runter wa.ks himself off
|(By Robert Gernhardt)
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20220610123126.oXt_A%steffen>