On Wed, Jun 21, 2017 at 11:39:53AM +0200, Jeremie Courreges-Anglas wrote:
> Sebastien Marie <sema...@online.fr> writes:
>
> >
> > But mandoc -Tlint complains about missing Mdocdate.
> >
> > $ mandoc -Tlint sysclean.8
> > mandoc: sysclean.8:17:5: STYLE: Mdocdate missing: Dd June
>
> With another project, I get this warning about Dd, plus a message about
> a missing RCS Id.
>
ah, I don't have this one. But after checking, my man page has a
$OpenBSD$ tag inside it... it should come from the mdoc.template I used
to start writing the file. :)
If I remove it, I have the same STYLE warning.
> > Alternatively, I could maintain manually Dd as "$Mdocdate: month day year
> > $",
> > but it seems a limitation for me, so I prefer reported it.
>
> I can just ignore those STYLE warnings. Using -Wwarning to get rid of
> STYLE warnings would lose quite a useful tips, right?
According to mandoc man page, -Wwarning will avoid all styles warning.
Here the complete list (taken from mandoc.h):
MANDOCERR_MDOCDATE, /* Mdocdate found: Dd ... */
MANDOCERR_MDOCDATE_MISSING, /* Mdocdate missing: Dd ... */
MANDOCERR_DATE_LEGACY, /* legacy man(7) date format: Dd ... */
MANDOCERR_RCS_MISSING, /* RCS id missing */
MANDOCERR_RCS_REP, /* duplicate RCS id: ... */
MANDOCERR_MACRO_USELESS, /* useless macro: macro */
MANDOCERR_BX, /* consider using OS macro: macro */
MANDOCERR_ER_ORDER, /* errnos out of order: Er ... */
MANDOCERR_ER_REP, /* duplicate errno: Er ... */
MANDOCERR_ND_DOT, /* description line ends with a full stop */
MANDOCERR_DELIM, /* no blank before trailing delimiter: macro ... */
MANDOCERR_FUNC, /* function name without markup: name() */
--
Sebastien Marie
