Re: [gentoo-dev] Removing retired developers from project pages

[Xavier Neys <neysx@gentoo.org>]

[-- Attachment #1: Type: text/plain, Size: 1414 bytes --]

Jan Kundrát wrote:
> Petteri Räty wrote:
>> -<date>2006-05-02</date>
>> +<date>$DATE: $</date>
> 
> Please revert all date changes you've made for following reasons:
> 
> a) "$DATE: $" isn't expanded by CVS
> b) Even if it was expanded, I won't be expanded to the YYYY-mm-dd format
> c) Even if it was in YYYY-mm-dd format, it won't be fully usable by our
> XSLT stylesheets as we can't handle "$Date 2007-05-02$", only "2007-05-02"

Not exactly true. Look at http://www.gentoo.org/proj/en/portage/ where
<date>$Date: 2007/05/02 08:04:44 $</date> becomes "Updated May 2, 2007"

Only handbooks would be affected, and only if there were mixed formats because
dates of handbooks are sorted first and the latest is formatted later.
That would be easy to change, but I don't think there's any demand for that.

> d) We don't bump date automatically because some changes (typo fixes
> etc) aren't important enough to warrant that.

Indeed, that's why we do not use $Date$ inside the <date/> tag. For instance,
if you fix a typo in a 2 year old file, you do not want to change the date
because 1) the content did not change 2) you did not check whether the
document is still valid today.
If that's not a problem for you, there's no problem with using $Date$, just do
not use $DATE$ :)


Cheers,
-- 
/  Xavier Neys
\_ Gentoo Documentation Project
/
/\ http://www.gentoo.org/doc/en/


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 252 bytes --]