[Doxygen-develop] Info on the status of the language translators (February 24, 2004)

[Petr P. <Pr...@sk...>]

Info on the status of the language translators (February 24, 2004)=20

Related to the Doxygen 1.3.6-20040222 in CVS. Posted to
doxygen-develop, copied to doxygen-users. The previous
report was dated December 16, 2003.

ATTENTION: Since the Doxygen 1.3.6-20040222, the=20
translator_report.txt is generated by the new translator.py
script that extracts also some information that was collected
manually in the past. The most general things are placed
at the beginning of the report. The full translator_report.txt=20
is stored at http://doxygen.sourceforge.net/dl/doxygen-1.3-cvs/=20
as tr2004MMDD.zip where MMDD is replaced by the month and day.

The following text is the head of the translator_report.txt.=20
My comments follow after:

=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
(1.3.6-20040222)

Doxygen supports the following 28 languages (sorted alphabetically):

Brazilian Portuguese, Catalan, Chinese, Chinese Traditional, Croatian,
Czech, Danish, Dutch, English, Finnish, French, German, Greek,
Hungarian, Italian, Japanese (+En), Korean (+En), Norwegian, Polish,
Portuguese, Romanian, Russian, Serbian, Slovak, Slovene, Spanish,
Swedish, and Ukrainian.

Of them, 15 translators are up-to-date, 13 translators are based on
some adapter class, and 2 are English based.

----------------------------------------------------------------------
The following translator classes are up-to-date (sorted
alphabetically). This means that they derive from the Translator class
and they implement all 194 of the required methods. Anyway, there
still may be some details listed even for them. Please, see the
details for them:

  TranslatorBrazilian
  TranslatorChinesetraditional
  TranslatorCroatian
  TranslatorCzech
  TranslatorDanish
  TranslatorDutch
  TranslatorEnglish
  TranslatorFrench
  TranslatorGerman
  TranslatorHungarian
  TranslatorItalian
  TranslatorKorean
  TranslatorRussian
  TranslatorSerbian
  TranslatorSpanish -- Change the base class to Translator.

----------------------------------------------------------------------
The following translator classes need some maintenance (the most
obsolete at the end). The other info shows the estimation of Doxygen
version when the class was last updated and number of methods that
must be implemented to become up-to-date:

  TranslatorSwedish               1.3.3 	 4 methods to implement
  TranslatorPortuguese            1.3.3 	 4 methods to implement
  TranslatorJapanese              1.3.3 	 4 methods to implement
  TranslatorPolish                1.3   	11 methods to implement
  TranslatorSlovak                1.2.18	13 methods to implement
  TranslatorCatalan               1.2.17	14 methods to implement
  TranslatorSlovene               1.2.16	15 methods to implement
  TranslatorRomanian              1.2.16	15 methods to implement
  TranslatorChinese               1.2.13	17 methods to implement
  TranslatorUkrainian             1.2.11	18 methods to implement
  TranslatorGreek                 1.2.11	18 methods to implement
  TranslatorNorwegian             1.2.2 	44 methods to implement
  TranslatorFinnish               obsolete	91 methods to implement

Note: The TranslatorAdapter_1_2_1 class is not used and can be removed.

----------------------------------------------------------------------
The following translator classes derive directly from the
TranslatorEnglish. The class identifier has the suffix 'En' that says
that this is intentional. Usually, there is also a non-English based
version of the translator for the language:

  TranslatorJapaneseEn	implements 5 methods
  TranslatorKoreanEn	implements 5 methods
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=


Now, my (human) comments:

The Hungarian translator did a big leap from very old to=20
up-to-date status since the December 2003. Thanks
go to the new maintainer, Akos Kiss. Great job.

Also, the Norwegian maintainer, Lars Erik Jordet,=20
was heard that the Norwegian translator will be updated
soon.

But...
  -----------------------------------------------
  We still have not found new Finnish maintainer. =20
  The translator became extremely obsolete, and=20
  it seems that the original maintainer is not
  in touch with doxygen anymore.
  -----------------------------------------------

For the Spanish maintainer, see the translator report.
The script detected that you did a good job and reached=20
the up-to-date status. The only thing you forgot to do
was to derive directly from the Translator class --
no need to use the TranslatorAdapter_x_y_z.

For the other maintainers, let's the goal is to update
your languages at least to the 1.3 status. The current
Doxygen version is 1.3.6.

Finally, my thanks to all active language maintainers.

 =20
With regards,
  Petr
=20
--=20
Petr Prikryl, (prikrylp at skil dot cz)