Should I use mdoc for user programs?

[Polytropon]

On Thu, 12 Oct 2017 11:35:13 +0200, Sijmen J. Mulder wrote:
> Op 12-10-2017 om 11:17 schreef Polytropon:
> > No, many programs from the ports collection provide a manpage in the 
> > standard format (for example "man opera" which is far from being a 
> > system program).
> 
> That manpage is not using mdoc (different macros) but I see that the 
> output is very similar, including the FreeBSD OS name. I'll just keep it 
> at that, then.

Well, I just mentioned Opera as an example of a non-system
manpage. I've not verified that they're using mdoc. My home
system has an older version of Opera, and it does not mention
the OS name in the header or footer (just "OPERA(1)").

I usually take the examples at /usr/share/examples/mdoc/ as
a template and redefine .Dd, .Ot., and .Os as needed.



-- 
Polytropon
Magdeburg, Germany
Happy FreeBSD user since 4.0
Andra moi ennepe, Mousa, ...