Date: Thu, 12 Oct 2017 21:39:53 +0300 From: Yuri Pankov <yuripv@gmx.com> To: Polytropon <freebsd@edvax.de> Cc: freebsd-questions@freebsd.org, "Sijmen J. Mulder" <ik@sjmulder.nl> Subject: Re: Should I use mdoc for user programs? Message-ID: <696e0fb1-7cbb-31d2-2105-8166a4c3d53e@gmx.com> In-Reply-To: <20171012200941.49fed687.freebsd@edvax.de> References: <cd1d3215-bfcd-57bf-89ec-c78981c60381@sjmulder.nl> <ad6d583f-db2e-a149-105d-b7c3b8894959@gmx.com> <20171012200941.49fed687.freebsd@edvax.de>
next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, 12 Oct 2017 20:09:41 +0200, Polytropon wrote: > On Thu, 12 Oct 2017 16:18:28 +0300, Yuri Pankov wrote: >> On Thu, 12 Oct 2017 11:02:49 +0200, Sijmen J. Mulder wrote: >> [...] >>> I noticed that the required .Os macro (man 7 mdoc) outputs "FreeBSD >>> General Commands Manual" which does not seem appropriate. >> >> It's not about the .Os macro, rather it's man-section-to-name mapping >> done by the formatter used, i.e. when using mandoc(1), on FreeBSD >> section 1 man pages would say "FreeBSD General Commands Manual", on >> illumos exactly the *same* man page would say just "User Commands" (for >> mandoc this can be customized editing one of the source files currently). > > According to "man mdoc", it's easy to redefine .Dt at the beginning > of the document (just like .Dt or Dd). Indeed, my answer was more about that output shouldn't stop the OP from using mdoc. And redefining the section name rarely serves any purpose; if you absolutely need it, go with a new section (yes, I know it's bad).
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?696e0fb1-7cbb-31d2-2105-8166a4c3d53e>