> mdoc(5) is just a format;
I mean mdoc(7), sorry.
> A good start is
>
> $ wc -l /usr/share/man/man1/*.1 | sort -n | less
>
> (or wherever your system keeps manpages),
> pick the shortest one for a program you know and use,
> and read the (input) manpage, such as
>
> $ vim /usr/share/man/man1/yes.1
I forgot an important thing: on many systems outside of the *BSD family,
the system manpages will be written in the legacy man(7) format,
built on top of roff(7), a general purpose typesetting language.
Both man(1) and mandoc(1) can read both; but mdoc(5) ficilitates
semantic markup ("this is a commandline option"), as opposed to
low-level formating instructions ("type this in italic").
In case your system uses man(7), not mdoc(7), as e.g. most linuxes do,
you will have to learn mdoc elsewhere, e.g.
http://cvsweb.openbsd.org/src/usr.bin/yes/yes.1
Jan
--
To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv