[Doxygen-develop] Info on the status of the language translators (February 5th, 200 2)

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

Info on the status of the language translators (February 5th, 2002)

(Related to the Doxygen-1.2.13-20020203 in CVS; full
translator_report.txt included in the attached zip file.

Posted to doxygen-develop [for the language
maintainers], copy posted to doxygen-users [searching
for Finnish and Swedish language maintainers].)

Hi,

First of all, my special thanks to all language
maintainers. 

  -----------------------------------------------
  We are still searching for Finnish and Swedish
  maintainers because their translators became
  extremely obsolete.
  -----------------------------------------------
  
The attached traslator_report.txt shows the current
status of the Translator classes.  Here is an excerpt
that can help you to guess how much work it would
require to make your language translator up-to-date.
Notice, that the translator.pl script now shows also
what required methods are implemented by what
translators:

----------------------------------------------------------------------
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
  TranslatorRussian

----------------------------------------------------------------------
The following translator classes are obsolete (sorted alphabetically).
This means that they derive from some of the adapter classes.

  TranslatorChinese     (TranslatorAdapter_1_2_13)
  TranslatorDanish      (TranslatorAdapter_1_2_7)
  TranslatorGerman      (TranslatorAdapter_1_2_13)
  TranslatorGreek       (TranslatorAdapter_1_2_11)
  TranslatorHungarian   (TranslatorAdapter_1_2_1)
  TranslatorJapanese    (TranslatorAdapter_1_2_13)
  TranslatorKorean      (TranslatorAdapter_1_2_13)
  TranslatorNorwegian   (TranslatorAdapter_1_2_2)
  TranslatorPolish      (TranslatorAdapter_1_2_1)
  TranslatorPortuguese  (TranslatorAdapter_1_2_13)
  TranslatorRomanian    (TranslatorAdapter_1_2_1)
  TranslatorSlovak      (TranslatorAdapter_1_2_13)
  TranslatorSlovene     (TranslatorAdapter_1_2_13)
  TranslatorSpanish     (TranslatorAdapter_1_2_7)
  TranslatorUkrainian   (TranslatorAdapter_1_2_11)

----------------------------------------------------------------------
The following translator classes are implemented via deriving
from the English translator.  This should be done only in the case
when the language maintainer or the doxygen developers need to update
some really outdated translator.  Otherwise, deriving from
the translator adapter classes should be prefered for obsolete translators.
See details below in the report.

  TranslatorFinnish     (TranslatorEnglish)
  TranslatorSwedish     (TranslatorEnglish)

----------------------------------------------------------------------
The following translator adapter classes are implemented -- the older (with
lower number) are always derived from the newer. They implement the
listed required methods. Notice that some versions of doxygen did not
introduce any changes related to the language translators.  From here you
may
guess how much work should be done to update your translator:
      
  TranslatorAdapter_1_2_13      implements  2 required methods...
    QCString trImplementedFromList(int numEntries)
    QCString trImplementedInList(int numEntries)

  TranslatorAdapter_1_2_11      implements  1 required method...
    QCString trReferences()

  TranslatorAdapter_1_2_7       implements  1 required method...
    QCString trAuthor(bool first_capital, bool singular)

  TranslatorAdapter_1_2_6       implements 13 required methods...
    QCString trRTFansicp()
    QCString trRTFCharSet()
    QCString trRTFGeneralIndex()
    QCString trFile(bool first_capital, bool singular)
    QCString latexLanguageSupportCommand()
    QCString idLanguageCharset()
    QCString trClass(bool first_capital, bool singular)
    QCString trNamespace(bool first_capital, bool singular)
    QCString trGroup(bool first_capital, bool singular)
    QCString trPage(bool first_capital, bool singular)
    QCString trMember(bool first_capital, bool singular)
    QCString trField(bool first_capital, bool singular)
    QCString trGlobal(bool first_capital, bool singular)

  TranslatorAdapter_1_2_5       implements  2 required methods...
    QCString trBug()
    QCString trBugList()

  TranslatorAdapter_1_2_4       implements  8 required methods...
    QCString trInterfaces()
    QCString trClasses()
    QCString trPackage(const char *name)
    QCString trPackageList()
    QCString trPackageListDescription()
    QCString trPackages()
    QCString trPackageDocumentation()
    QCString trDefineValue()

  TranslatorAdapter_1_2_2       implements  2 required methods...
    QCString trProperties()
    QCString trPropertyDocumentation()

  TranslatorAdapter_1_2_1       implements  1 required method...
    QCString trDCOPMethods()

----------------------------------------------------------------------

Clearly, to pass the 1.2.4 and 1.2.6 translator
adapters requires more work.  Anyway, their methods
are not extremely difficult to implement.  

If you find some time, please do update your
translator.  The comming-soon work on the new
implementation of translators would otherwise be more
difficult for those who develop the core code. 

Thanks, 
  Petr
  

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