Should I use mdoc for user programs?

Polytropon freebsd at
Thu Oct 12 10:05:53 UTC 2017

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.

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

More information about the freebsd-questions mailing list