[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[Manual] Revision tracking script [was: German translation of the Sarge Installation Manual]

Hash: SHA1

On Saturday 24 April 2004 23:53, Denis Barbier wrote:
> > > On Sun, Apr 18, 2004 at 11:15:39PM +0200, Frans Pop wrote:
> > > > Also, I have seen the revision number of the en docs change without
> > > > the content of documents changing (probably due to an reorganization
> > > > or something), so it would be nice to also have an option to
> > > > automagically update the revision numbers in translations if there
> > > > are no real changes.
> > >
> > > Absolutely, the smart_change.pl script I wrote for webwml may be
> > > adapted here.
> >
> > Where can I find this script or could you send it to me?
>   http://cvs.debian.org/webwml/smart_change.pl?cvsroot=webwml
> It uses modules found under
>   http://cvs.debian.org/webwml/Perl/?cvsroot=webwml
> But after looking at the code, it seems that making it support SVN
> instead of CVS is not trivial, writing a new tool from scratch is
> certainly easier.

Hello Denis,

I have updated the doc-check perl script to include this functionality 
(borrowing from the links you provided: thanks).

Would you be so kind as to review the script (attached) as this is my first 
effort ever in perl :-)
Comments on my changes or suggestions for improvement are welcome as well.

What happens is the following:
- - if a document in the directory for the requested language still contains
  <!-- $Id: <docname> <revnr> ... -->
  it is assumed the document is untranslated and this line is replaced by
  <!-- original version: <revnr> untranslated -->
- - if the -u option is used, revision numbers in translated documents are
  updated to the revision number in the original document (keeping the
  'untranslated' mark if present)

I think the first option using the 'untranslated' mark is very useful if the 
manual is partially translated as it allows translators to just copy the 
original files to their own directory and still
- - keep track of changes in these documents;
- - keep track which documents have been translated and which have not.
The translator should of course remove 'untranslated' from the remark when he 
starts translating it.

You can use 'nl' for testing as there are still plenty of untranslated docs. 
All translated docs are up to date at the time I'm writing this.


Version: GnuPG v1.2.1 (GNU/Linux)


Attachment: doc-check
Description: Perl program

Reply to: