[Doxygen-develop] Info on the status of language translators, my thanks to the lang uage maintainers

[Prikryl,Petr <PRI...@sk...>]

Hallo to the language maintainers,

(zipped translator_report.txt attached)

I am sending this as a reminder of status of the
translator classes for the supported languages
(files translator_xx.h).  New method  was added 
to the Translator class since doxygen 1.2.11.
Because of this, many language translators 
are considered obsolete again.  

The doxygen/doc/translator.pl script can help you
what methods should be implemented and what 
methods should be removed in your TranslatorXxx
class. (One of the results, the translator report, is 
attached to this message.)

I would like to express my explicit thanks to those
who has the version of their translator class equal
to 1.2.7 or better.

I would like to encourage those with version between
1.2.0 to 1.2.7.  It seems that it is a good time to 
update your translator.

I would like to ask the language maintainers of the 
languages with the translator version below 1.2.0.
Please, try to update your translator.  Even though
there is a mechanism to replace the missing 
functionality, the really obsolete translators make
doxygen a bit more complicated than necessary.
It can also further complicate the near-future 
development of the language support.  You may 
be too busy to do that, no shame -- you gave your
time for free to other user.  If you know that you 
are not able to update your translator class, please,
try to find another maintainer for your language, or 
let us know that you cannot or do not want to continue
to maintain your part of code.  I am sure that you will
not be blamed for that, and your name will still be 
carved inside the sources ;-)

Now, many thanks to those who keep their translators
up-to-date, and also to those who will make it up-to-date
really soon ;-)  

You can find the zipped translator_report.txt
attached to this message.  The content basically says 
what methods are to be implemented and what methods
should be removed (never used).

 <<tr_report.zip>> 
Here is the snippet from inside that lists up-to-date
translators (CVS and plus some updates sent to this list).

----------------------------------------------------------------------
The following translator classes are up-to-date (sorted alphabetically).
This means that they derive from the Translator class.  Anyway, there still
may be some details listed even for the up-to-date translators.
Please, check the text below if the translator is marked so.

  TranslatorCroatian
  TranslatorCzech
  TranslatorEnglish
  TranslatorFrench      -- see details below in the report
  TranslatorPortuguese  -- see details below in the report
  TranslatorRussian     -- see details below in the report
----------------------------------------------------------------------

The "see details below in the report" generally means that there are 
probably some obsolete methods (should be removed).
Here the Russian is the exception, because it implements
some new, experimental methods, that were recognized as
obsolete (they are not found in the abstract Translator class
in translator.h).  Read doxygen/html/langhowto.html 
(the part of doxygen documentation) for details.

And finally, many thanks to those (of course), 
who work on other parts of doxygen, i.e. not the
language translation.  You know, who you are, and you 
know on what you work ;-)

See you, 
  Petr
-- 
Petr Prikryl, Skil, spol. s r.o., (pri...@sk...)