From owner-cvs-doc@FreeBSD.ORG Sun Jun 15 17:16:40 2008 Return-Path: Delivered-To: cvs-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 5DE3B1065688; Sun, 15 Jun 2008 17:16:40 +0000 (UTC) (envelope-from keramida@ceid.upatras.gr) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.freebsd.org (Postfix) with ESMTP id CB65A8FC24; Sun, 15 Jun 2008 17:16:39 +0000 (UTC) (envelope-from keramida@ceid.upatras.gr) Received: from kobe.laptop (adsl123-212.kln.forthnet.gr [77.49.242.212]) (authenticated bits=128) by igloo.linux.gr (8.14.3/8.14.3/Debian-4) with ESMTP id m5FH32kp009265 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sun, 15 Jun 2008 20:03:09 +0300 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.2/8.14.2) with ESMTP id m5FH30Lf017833; Sun, 15 Jun 2008 20:03:00 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Received: (from keramida@localhost) by kobe.laptop (8.14.2/8.14.2/Submit) id m5FH30N6017832; Sun, 15 Jun 2008 20:03:00 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) From: Giorgos Keramidas To: doc-committers@FreeBSD.org, pgj@FreeBSD.org References: <200806151636.m5FGatUe039259@repoman.freebsd.org> Date: Sun, 15 Jun 2008 20:02:59 +0300 In-Reply-To: <200806151636.m5FGatUe039259@repoman.freebsd.org> (Giorgos Keramidas's message of "Sun, 15 Jun 2008 16:36:55 +0000 (UTC)") Message-ID: <87r6ay1vi4.fsf@kobe.laptop> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-MailScanner-ID: m5FH32kp009265 X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-3.744, required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.66, BAYES_00 -2.60) X-Hellug-MailScanner-From: keramida@ceid.upatras.gr X-Spam-Status: No Cc: cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: doc/el_GR.ISO8859-7/share/tools/checkupdate checkupdate.1 checkupdate.py X-BeenThere: cvs-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the doc and www trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 15 Jun 2008 17:16:40 -0000 On Sun, 15 Jun 2008 16:36:55 +0000 (UTC), Giorgos Keramidas wrote: > keramida 2008-06-15 16:36:55 UTC > > FreeBSD doc repository > > Modified files: > el_GR.ISO8859-7/share/tools/checkupdate checkupdate.1 > checkupdate.py > Log: > checkupdate: Add a new -e option that reports 'everything'. > > When the -e option is enabled, report file revision information > for 'everything', including files that don't need a translation > update. > > Revision Changes Path > 1.2 +5 -1 doc/el_GR.ISO8859-7/share/tools/checkupdate/checkupdate.1 > 1.3 +11 -2 doc/el_GR.ISO8859-7/share/tools/checkupdate/checkupdate.py Many thanks to Gabor Pali (pgj) for kicking my ass into actually finishing this. It's been sitting in a "that would be nice" TODO entry for months, until he wrote a shell version, which I translated to this Python version of the same script to add a bit of debugging and make it a bit extensible :) The script isn't as well documented as I would like it to be, but it should be easy to use for other translations too, or to adapt it to use the 'Original version:' convention already present in some translations. A typical run for the doc/el_GR.ISO8859-7 tree is: (1) For a file collection that is 'up to date' with the English version: : : % find el_GR.ISO8859-7/articles/compiz-fusion | checkupdate : % : In this case, no output means the obvious: no updates needed. With the -e flag, the file revisions are reported anyway, even if they match: : : % find el_GR.ISO8859-7/articles/compiz-fusion | checkupdate -e : el_GR.ISO8859-7/articles/compiz-fusion/Makefile rev. 1.1 : 1.1 -> 1.1 en_US.ISO8859-1/articles/compiz-fusion/Makefile : : el_GR.ISO8859-7/articles/compiz-fusion/article.sgml rev. 1.2 : 1.6 -> 1.6 en_US.ISO8859-1/articles/compiz-fusion/article.sgml : : % (2) For a file collection that needs updates: : keramida@kobe:/hg/doc/el$ find el_GR.ISO8859-7/articles/formatting-media | checkupdate : el_GR.ISO8859-7/articles/formatting-media/Makefile rev. 1.3 : 1.1 -> 1.8 en_US.ISO8859-1/articles/formatting-media/Makefile : : el_GR.ISO8859-7/articles/formatting-media/article.sgml rev. 1.7 : 1.29 -> 1.31 en_US.ISO8859-1/articles/formatting-media/article.sgml : : keramida@kobe:/hg/doc/el$ Each file that needs a translation update is reported in 2 lines. The first line shows the translated file path and its current CVS or Subversion revision number. The second line shows: * The originally translated version, as it is recorded in the %SRCID% comment in the file. * The current CVS or Subversion revision of the English master source file. * The path of the master source file, as it is recorded in the %SOURCE% comment of the translated file. This usually matches the translated path, except for a few files in `share/'. If the %SOURCE% comment points to a file that doesn't really exist the script should print: 1.29 -> NONE en_US.ISO8859-1/blah (MISSING) It doesn't do this yet, but I'll add it soon-ish. Other things we want to add with pgj@ are: * The ability to preview the diff of OLDREV -> NEWREV, so that translators can run the script to get a feel of what needs translation. * Some rundimentary 'file checks' like: - The translated file is missing a $FreeBSD$ line. - The %SRCID% tag in the translated file links to an absurd revision (i.e. greater than the latest English revision) - etc.