From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from smtp-1.sys.kth.se (smtp-1.sys.kth.se [130.237.32.175])
	by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id p26Nq3QH015389
	for <tech@mdocml.bsd.lv>; Sun, 6 Mar 2011 18:52:04 -0500 (EST)
Received: from mailscan-1.sys.kth.se (mailscan-1.sys.kth.se [130.237.32.91])
	by smtp-1.sys.kth.se (Postfix) with ESMTP id 2F7CD156EE6;
	Mon,  7 Mar 2011 00:51:57 +0100 (CET)
X-Virus-Scanned: by amavisd-new at kth.se
Received: from smtp-1.sys.kth.se ([130.237.32.175])
	by mailscan-1.sys.kth.se (mailscan-1.sys.kth.se [130.237.32.91]) (amavisd-new, port 10024)
	with LMTP id rKKz34ntQeuC; Mon,  7 Mar 2011 00:51:54 +0100 (CET)
X-KTH-Auth: kristaps [85.8.60.119]
X-KTH-mail-from: kristaps@bsd.lv
Received: from h85-8-60-119.dynamic.se.alltele.net (h85-8-60-119.dynamic.se.alltele.net [85.8.60.119])
	by smtp-1.sys.kth.se (Postfix) with ESMTP id E3992156EAA;
	Mon,  7 Mar 2011 00:51:53 +0100 (CET)
Message-ID: <4D741E18.6000903@bsd.lv>
Date: Mon, 07 Mar 2011 00:51:52 +0100
From: Kristaps Dzonsons <kristaps@bsd.lv>
User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv:1.9.2.13) Gecko/20101207 Thunderbird/3.1.7
X-Mailinglist: mdocml-tech
Reply-To: tech@mdocml.bsd.lv
MIME-Version: 1.0
To: tech@mdocml.bsd.lv
CC: Ingo Schwarze <schwarze@usta.de>, Jason McIntyre <jmc@cava.myzen.co.uk>,
        Tim van der Molen <tbvdm@xs4all.nl>
Subject: Re: clean up date handling
References: <20110304001451.GA8690@iris.usta.de> <20110304222437.GA21838@iris.usta.de> <20110305001540.GC21838@iris.usta.de> <20110305075314.GC18361@harkle.bramka> <20110305192749.GH27137@iris.usta.de>
In-Reply-To: <20110305192749.GH27137@iris.usta.de>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

On 05/03/2011 20:27, Ingo Schwarze wrote:
> Hi Jason,
>
> Jason McIntyre wrote on Sat, Mar 05, 2011 at 07:52:50AM +0001:
>> On Sat, Mar 05, 2011 at 01:15:40AM +0100, Ingo Schwarze wrote:
>
> [...]
>>> +Other arguments are not portable; the
>>> +.Xr mandoc 1
>>> +utility handles them as follows:
>>> +.Bl -dash -offset 3n -compact
>>> +.It
>>> +To have the date automatically filled in by
>>>   .Xr cvs 1 ,
>>> -or instead a valid canonical date as specified by
>>> -.Sx Dates .
>>> -If a date does not conform or is empty, the current date is used.
>>> +the special string
>>> +.Dq $\&Mdocdate$
>>> +can be given as an argument.
>
>> shouldn;t you mention this is openbsd only?
>
> Yes, that makes sense.
> However, it's just OpenBSD's cvs(1) that is special,
> mandoc(1) can handle $Mdocdate$ on any platform,
> so i will use this wording:
>
>    To have the date automatically filled in by the
>    .Ox
>    version of
>    .Xr cvs 1 ,
>    the special string
>    .Dq $\&Mdocdate$
>    can be given as an argument.
>
> I have fixed your other findings in my tree, so if this goes in,
> they will be contained.

Ingo,

I like these changes very much---I remember writing the date code in the 
first versions of mandoc and being very puzzled with the canonical 
format (hint: there is none).

I do feel that a "canonical" date format (or set of formats, e.g., 
YYYY-MM-DD, YYYY-MM, YYYY) should be suggested just so that people have 
some direction, I agree that warning about it is superfluous.

So please check this in; when the code is committed I'll give it a 
closer look-over and we can go from there.

Thanks again,

Kristaps
--
 To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv