On Mon, Aug 18, 2014 at 07:58:49PM +0100, Dominik Vogt wrote:
> Hi Roman,
>
> On Mon, Aug 18, 2014 at 10:43:55PM +0400, Roman Grazhdan wrote:
> > documentation conversion part - docbook to mdoc.
>
> Can you give me a max. ten line summary of what mdoc is and give
> a short example of a file converted to that format, please?
It's going back to using man pages. It's similar to roff, but not
quite.
.Dd $Mdocdate$
.Dt PROGNAME section
.Os
.Sh NAME
.Nm progname
.Nd one line about what it does
.\" .Sh LIBRARY
.\" For sections 2, 3, and 9 only.
.\" Not used in OpenBSD.
.Sh SYNOPSIS
.Nm progname
.Op Fl options
.Ar
.Sh DESCRIPTION
The
.Nm
utility processes files ...
I _really_ like it, and have been using it for years on several
projects.
The finer details:
http://mdocml.bsd.lv/man/mdoc.7.html
-- Thomas Adam
--
"Deep in my heart I wish I was wrong. But deep in my heart I know I am
not." -- Morrissey ("Girl Least Likely To" -- off of Viva Hate.)
