On Sun, May 19, 2019 at 08:19:09PM +0200, Klemens Nanni wrote:
> jmc noted that I didn't include my actual line, so here it is.
> 

ah!

> First I was using only
> 
>       .Dd $Mdocdate$
> 
> but that warned me
> 
>       mandoc: ./files/varnishreload.1:2:2: WARNING: missing date, using 
> today's date
>

yes. this will happen until an initial commit. then the date gets
expanded.

> so I did what I was told, according to mdoc(7)
> 
>       .Dd $Mdocdate: May 19, 2019 $
> 

no. just use $Mdocdate$ and it gets expanded on commit. just like when
you add $OpenBSD$: you don;t fill that in, right?

> but it still warned me
> 
>       mandoc: ./files/varnishreload.1:2:2: WARNING: cannot parse date, using 
> it verbatim: $Mdocdate: May 19, 2019 $
> 
> So I removed the comma and mandoc(1) was happy.
> 
>       .Dd $Mdocdate: May 19 2019 $
> 
> 
> What should be used here?  Either I'm warned or I'm using undocumented
> syntax, both seems wrong to me.
> 

use $Mdocdate$ and let expansion happen, or just use the
old format of "month day, year".

is that clear, or did the docs mislead you somehow?

jmc

Reply via email to