On Wed, Jun 21, 2017 at 09:04:19AM +0200, Sebastien Marie wrote: > Hi, > > With latest commits on mandoc (particulary mdoc_validate.c r1.252), I > have a problem with mandoc -Tlint regarding Dd macro. > > Some days ago, I started to validate the man page of sysclean using > mandoc -Tlint. > > sysclean is a tool designed for OpenBSD, and maintained externally in a > git repository. > > The current preambule for sysclean.8 (in master) is : > > .Dd June 18, 2017 > .Dt SYSCLEAN 8 > .Os >
morning. presumably because you have a blank Os field, mandoc will look elesewhere and is concluding that this is openbsd. maybe you can use a dummy value, but wait for ingo's reply, as he will better know the criteria for Os matching, and what a good way to do this is. note that this is just flagging this as "STYLE": the old style Dd does work (hence just ignoring the message may be the best choice). but it's not "not respecting the specification". jmc > According to mdoc(7), there are valids: > > Document preamble and NAME section macros > Dd document date: $Mdocdate$ | month day, year > Dt document title: TITLE section [arch] > Os operating system version: [system [version]] > > But mandoc -Tlint complains about missing Mdocdate. > > $ mandoc -Tlint sysclean.8 > mandoc: sysclean.8:17:5: STYLE: Mdocdate missing: Dd June > > The current check requires Dd to be in "Mdocdate" format if the Os is > OpenBSD. It seems to me it doesn't respect the specification, which > allow Dd to be a plain date (month day, year). > > Due to the fact I am not using CVS for this project, I couldn't use > $Mdocdate$ keyword (and have the date isn't automatically filled). > > Alternatively, I could maintain manually Dd as "$Mdocdate: month day year $", > but it seems a limitation for me, so I prefer reported it. > > Thanks. > -- > Sebastien Marie >
