[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-i18n-doc
Subject:    Re: [RFC] Clean up the language docbooks
From:       Burkhard =?iso-8859-15?q?L=FCck?= <lueck () hube-lueck ! de>
Date:       2010-08-15 16:43:55
Message-ID: 201008151843.55198.lueck () hube-lueck ! de
[Download RAW message or body]

Am Sonntag, 15. August 2010, um 11:39:51 schrieb Chusslove Illich:
> > [: Burkhard Lück :]
> > Please cleanup your language docbooks.
> 
> As you saw empirically, this is easier said than done. 

At some point in kde4.x I used a brute force method for that. I removed all 
german docbooks and generated the docbooks again. That gave a clean german 
documentation. From then on I tried to follow the moved/removed/renamed german 
docmessages which I saw in my commit filter for l10n-kde4/de with the docbooks 
manually.

> This script that you
> use to detect out of date stuff, is it somewhere in the repository? 

No, where to upload it? Somewhere in l10n-support?

But be warned: Writing the scripts was only intended for my personal use to 
maintain the german documentation, and later on I extended some of them to 
handle all languages.
So you'll find german comments, hardcoded paths for my checkout dirs, no proper 
usage message, no proper error handling etc. As long as the scripts work for 
my personal usage I never found enough time to fix all these issues. But that 
should not be too hard...

> Can it
> also thoroughly delete obsolete files (as in, that one can just issue
> svn commit LANG/docs/ afterwards)?
> 
Afaik that should be possible with python, but for sure you will know that 
better.

But I won't delete old language documentation atomatically, only with an 
additional condition like this for now:

(datelangdoc older dateendoc) AND (datelangdoc<=2006) AND (dateendoc>2006)

This will catch all language docs from kde3 where the english doc is from 
kde4.

> > [: Burkhard Lück :]
> > Cause I know from my previous mails, that not all teams either read them
> > or don't care about them, I hereby request to let me clean up the
> > language docbooks after one week.
> 
> You mean to clean up in one week this once, or once every week? 

Once a week before docs.kde.org is updated (afair friday).
That should not be much work once the language docbooks are cleaned up. 
We have now docbook leftovers from several years back to the era of kde 3.0, 
some docbooks seem to be even pre kde3. 

> I'd like
> this personally, but it would also be nice to have the script which does it
> in the repository, so that anyone can run it.
> 
> Alternatively, you could make this script check for existence of a
> particular file, say LANG/auto-clean-docs, and act only if it exists. (This
> approach is already used to stop Scripty from merging with templates, by
> adding LANG/no-auto-merge file.)

-- 
Burkhard Lück

[prev in list] [next in list] [prev in thread] [next in thread]