[PHP-DOC] Revision check, now working From: Hojtsy Gabor (gabor <email protected>)
Date: 08/30/01

Hi!

Some time ago, we tried to discuss our revision chechking
ideas here on the list, but the discussion was pointless
as there were no actual script and implementation to talk
about.

Now here is a working example of the Revision comment system,
we were talking about. The revision comment syntax, as we
discussed is:

  <!-- EN-Revision: 1.34 Maintainer: tom Status: ready -->

or for unknow revisions:

  <!-- EN-Revision: n/a Maintainer: tom Status: working -->

The EN-Revision is the corresponding revision from the
english tree, the Maintainer is the person, who actually
maintains (is reponsible for) the file, status can be
anything, it is not restricted.

The script walks through the en dir in phpdoc and tries
to find the corresponding files in the translations dir.

There are lists for untranslated files and files without
revision comments.

The best thing is the colored revision table, where you
can find all the information as in /~rasmus/status.php,
but many more:

 - the exact revisions, and number diffs
 - some size diffs (not exact, as the en and <tr> languages used)
 - date diffs (this is the only one that /~rasmus/status.php provides)

A real world example is attached (the actual hungarian files).

It was made with running the script:

 revcheck.php hu

You can get help about what parameters are needed, by running:

 revcheck.php

It needs a PHP CGI executable at /usr/bin/php

The file gerenated (revcheck.php) will be there at the
scripts dir, but don't be afraid of this. CVS will ignore
the file, and won't complain.

Hope this helps to start a discussion about the usefullness
of this revision comment syntax...

Goba