Suggestion: add revision number to docs

[Astrid Keßler <ke...@kess-net.de>]

Two weeks ago I started translating the next file. But I had to break my
work due to very less spare time. Today, I want to go on with it while
I'm wondering, if the original file has been changed since then, or not.

Because I'm doing the translation with both files - original and ongoing
translation - side by side. And I'm opening both files from my checkout
directory. So when opening them after a break, I can't realized, if the
original has been changed. Sure, i could check the commit messages or
look at cvs. But it would be much easier for me, and maybe for other
translators too, to have the revision number inside the xml file.

This could be done by writing $Revision$ into the file. The CVS will
replace it to $Revision: x.y $, where x.y is the revision number. As
long as this string exists, revision number will automatically be
updated.

I would suggest a comment within each xml file, or an attribute, if we
want to overtake this number into the html conversions. If you agree to
use this, I would do the neccessary change on all xml files with a
small script and commit them...

Kess

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org

Re: Suggestion: add revision number to docs

[Justin Erenkrantz <je...@apache.org>]

On Sun, Sep 15, 2002 at 01:28:41AM +0200, Astrid Keßler wrote:
> This could be done by writing $Revision$ into the file. The CVS will
> replace it to $Revision: x.y $, where x.y is the revision number. As
> long as this string exists, revision number will automatically be
> updated.

I think this is a bad idea.  -0.  

There are much better ways to get the revision of the file - such as
cvs stat, watching commit logs, etc. - without polluting the original
file.

"Commit early and often" if you are worried about getting
out-of-sync.  -- justin

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org