[Doxygen-develop] Info on the status of language translators (updated repost)

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

(This is a repost of the updated message.  The attached
translator_report.txt
reflects the status of 1.2.12-20011125.  Six maintainers updated their
language
since the previous post -- thanks.)

> 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_rep.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.

  TranslatorBrazilian
  TranslatorCroatian
  TranslatorCzech
  TranslatorDutch
  TranslatorEnglish
  TranslatorFrench
  TranslatorItalian
  TranslatorKorean
  TranslatorPortuguese  -- see details below in the report
  TranslatorRussian     -- see details below in the report
  TranslatorSlovene
----------------------------------------------------------------------
The following translator classes are obsolete (sorted alphabetically).
This means that they derive from some of the adapter classes.

  TranslatorChinese     (TranslatorAdapter_1_2_11)
  TranslatorDanish      (TranslatorAdapter_1_2_7)
  TranslatorFinnish     (TranslatorAdapter_1_0_0)
  TranslatorGerman      (TranslatorAdapter_1_2_11)
  TranslatorHungarian   (TranslatorAdapter_1_2_1)
  TranslatorJapanese    (TranslatorAdapter_1_2_5)
  TranslatorNorwegian   (TranslatorAdapter_1_2_2)
  TranslatorPolish      (TranslatorAdapter_1_2_1)
  TranslatorRomanian    (TranslatorAdapter_1_2_1)
  TranslatorSlovak      (TranslatorAdapter_1_2_11)
  TranslatorSpanish     (TranslatorAdapter_1_2_7)
  TranslatorSwedish     (TranslatorAdapter_1_0_0)
  TranslatorUkrainian   (TranslatorAdapter_1_2_11)
----------------------------------------------------------------------

> 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...)
>