diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/language.doc | 77 | ||||
| -rw-r--r-- | doc/maintainers.txt | 5 | ||||
| -rw-r--r-- | doc/translator.py | 75 |
3 files changed, 90 insertions, 67 deletions
diff --git a/doc/language.doc b/doc/language.doc index dc2193f..456cf66 100644 --- a/doc/language.doc +++ b/doc/language.doc @@ -23,7 +23,7 @@ text fragments, generated by doxygen, can be produced in languages other than English (the default). The output language is chosen through the configuration file (with default name and known as Doxyfile). -Currently (version 1.3.8), 30 languages +Currently (version 1.3.7-20040719), 30 languages are supported (sorted alphabetically): Afrikaans, Brazilian Portuguese, Catalan, Chinese, Chinese Traditional, Croatian, Czech, Danish, Dutch, English, Finnish, French, @@ -45,7 +45,7 @@ when the translator was updated. <td ><b><font size=+1 color="#ffffff"> Language </font></b></td> <td ><b><font size=+1 color="#ffffff"> Maintainer </font></b></td> <td ><b><font size=+1 color="#ffffff"> Contact address </font> - <font size=-2 color="#ffffff">(remove the NOSPAM.)</font></b></td> + <font size=-2 color="#ffffff">(replace the at and dot)</font></b></td> <td ><b><font size=+1 color="#ffffff"> Status </font></b></td> </tr> <!-- table content begin --> @@ -53,104 +53,104 @@ when the translator was updated. <tr bgcolor="#ffffff"> <td>Afrikaans</td> <td>Johan Prinsloo</td> - <td>johan@NOSPAM.zippysnoek.com</td> + <td>johan at zippysnoek dot com</td> <td>up-to-date</td> </tr> <tr bgcolor="#ffffff"> <td>Brazilian Portuguese</td> <td>Fabio "FJTC" Jun Takada Chino</td> - <td>chino@NOSPAM.icmc.sc.usp.br</td> + <td>chino at icmc dot sc dot usp dot br</td> <td>up-to-date</td> </tr> <tr bgcolor="#ffffff"> <td>Catalan</td> <td>Albert Mora</td> - <td>amora@NOSPAM.iua.upf.es</td> + <td>amora at iua dot upf dot es</td> <td>1.2.17</td> </tr> <tr bgcolor="#ffffff"> <td>Chinese</td> <td>Li Daobing<br>Wei Liu</td> - <td>lidaobing@NOSPAM.gmail.com<br>liuwei@NOSPAM.asiainfo.com</td> + <td>lidaobing at gmail dot com<br>liuwei at asiainfo dot com</td> <td>1.3.08</td> </tr> <tr bgcolor="#ffffff"> <td>Chinese Traditional</td> <td>Daniel YC Lin<br>Gary Lee</td> - <td>daniel@NOSPAM.twpda.com<br>garylee@NOSPAM.ecosine.com.tw</td> + <td>daniel at twpda dot com<br>garylee at ecosine dot com dot tw</td> <td>1.3.8</td> </tr> <tr bgcolor="#ffffff"> <td>Croatian</td> <td>Boris Bralo</td> - <td>boris.bralo@NOSPAM.zg.tel.hr</td> + <td>boris.bralo at zg dot htnet dot hr</td> <td>up-to-date</td> </tr> <tr bgcolor="#ffffff"> <td>Czech</td> <td>Petr Přikryl</td> - <td>prikrylp@NOSPAM.skil.cz</td> + <td>prikrylp at skil dot cz</td> <td>up-to-date</td> </tr> <tr bgcolor="#ffffff"> <td>Danish</td> <td>Erik Søe Sørensen</td> - <td>erik@NOSPAM.mail.nu</td> + <td>erik at mail dot nu</td> <td>1.3.8</td> </tr> <tr bgcolor="#ffffff"> <td>Dutch</td> <td>Dimitri van Heesch</td> - <td>dimitri@NOSPAM.stack.nl</td> + <td>dimitri at stack dot nl</td> <td>up-to-date</td> </tr> <tr bgcolor="#ffffff"> <td>English</td> <td>Dimitri van Heesch</td> - <td>dimitri@NOSPAM.stack.nl</td> + <td>dimitri at stack dot nl</td> <td>up-to-date</td> </tr> <tr bgcolor="#ffffff"> <td>Finnish</td> <td>Olli Korhonen</td> - <td>Olli.Korhonen@NOSPAM.ccc.fi</td> + <td>Olli.Korhonen at ccc dot fi</td> <td>obsolete</td> </tr> <tr bgcolor="#ffffff"> <td>French</td> <td>Xavier Outhier</td> - <td>xouthier@NOSPAM.yahoo.fr</td> + <td>xouthier at yahoo dot fr</td> <td>1.3.8</td> </tr> <tr bgcolor="#ffffff"> <td>German</td> <td>Jens Seidel</td> - <td>jensseidel@NOSPAM.users.sf.net</td> + <td>jensseidel at users dot sf dot net</td> <td>1.3.8</td> </tr> <tr bgcolor="#ffffff"> <td>Greek</td> <td>Harry Kalogirou</td> - <td>harkal@NOSPAM.rainbow.cs.unipi.gr</td> + <td>harkal at rainbow dot cs dot unipi dot gr</td> <td>1.2.11</td> </tr> <tr bgcolor="#ffffff"> <td>Hungarian</td> <td>Földvári György<br>Ákos Kiss</td> - <td>foldvari@NOSPAM.diatronltd.com<br>akiss@NOSPAM.users.sourceforge.net</td> + <td>foldvari at diatronltd dot com<br>akiss at users dot sourceforge dot net</td> <td>1.3.8</td> </tr> <tr bgcolor="#ffffff"> <td>Italian</td> <td>Alessandro Falappa<br>Ahmed Aldo Faisal</td> - <td>alessandro@NOSPAM.falappa.net<br>aaf23@NOSPAM.cam.ac.uk</td> + <td>alessandro at falappa dot net<br>aaf23 at cam dot ac dot uk</td> <td>up-to-date</td> </tr> <tr bgcolor="#ffffff"> <td>Japanese</td> - <td>Ryunosuke Satoh<br>Kenji Nagamatsu</td> - <td>sun594@NOSPAM.hotmail.com<br>naga@NOSPAM.joyful.club.ne.jp</td> - <td>1.3.3</td> + <td>Ryunosuke Satoh<br>Kenji Nagamatsu<br>Iwasa Kazmi</td> + <td>sun594 at hotmail dot com<br>naga at joyful dot club dot ne dot jp<br>iwasa at cosmo-system dot jp</td> + <td>up-to-date</td> </tr> <tr bgcolor="#ffffff"> <td>JapaneseEn</td> @@ -161,7 +161,7 @@ when the translator was updated. <tr bgcolor="#ffffff"> <td>Korean</td> <td>Richard Kim</td> - <td>ryk@NOSPAM.dspwiz.com</td> + <td>ryk at dspwiz dot com</td> <td>1.3.8</td> </tr> <tr bgcolor="#ffffff"> @@ -173,73 +173,73 @@ when the translator was updated. <tr bgcolor="#ffffff"> <td>Lithuanian</td> <td>Tomas Simonaitis<br>Mindaugas Radzius<br>Aidas Berukstis</td> - <td>haden@NOSPAM.homelan.lt<br>mindaugasradzius@NOSPAM.takas.lt<br>aidasber@NOSPAM.takas.lt</td> + <td>haden at homelan dot lt<br>mindaugasradzius at takas dot lt<br>aidasber at takas dot lt</td> <td>1.3.8</td> </tr> <tr bgcolor="#ffffff"> <td>Norwegian</td> <td>Lars Erik Jordet</td> - <td>lej@NOSPAM.circuitry.no</td> - <td>1.2.2</td> + <td>lejordet at gmail dot com</td> + <td>up-to-date</td> </tr> <tr bgcolor="#ffffff"> <td>Polish</td> <td>Piotr Kaminski<br>Grzegorz Kowal</td> - <td>Piotr.Kaminski@NOSPAM.ctm.gdynia.pl<br>g_kowal@NOSPAM.poczta.onet.pl</td> + <td>Piotr.Kaminski at ctm dot gdynia dot pl<br>g_kowal at poczta dot onet dot pl</td> <td>1.3</td> </tr> <tr bgcolor="#ffffff"> <td>Portuguese</td> <td>Rui Godinho Lopes</td> - <td>ruiglopes@NOSPAM.yahoo.com</td> + <td>ruiglopes at yahoo dot com</td> <td>1.3.3</td> </tr> <tr bgcolor="#ffffff"> <td>Romanian</td> <td>Alexandru Iosup</td> - <td>aiosup@NOSPAM.yahoo.com</td> + <td>aiosup at yahoo dot com</td> <td>1.2.16</td> </tr> <tr bgcolor="#ffffff"> <td>Russian</td> <td>Alexandr Chelpanov</td> - <td>cav@NOSPAM.cryptopro.ru</td> + <td>cav at cryptopro dot ru</td> <td>up-to-date</td> </tr> <tr bgcolor="#ffffff"> <td>Serbian</td> <td>Dejan Milosavljevic</td> - <td>dmilos@NOSPAM.email.com</td> + <td>dmilos at email dot com</td> <td>1.3.8</td> </tr> <tr bgcolor="#ffffff"> <td>Slovak</td> <td>Stanislav Kudláč</td> - <td>skudlac@NOSPAM.pobox.sk</td> + <td>skudlac at pobox dot sk</td> <td>1.2.18</td> </tr> <tr bgcolor="#ffffff"> <td>Slovene</td> <td>Matjaz Ostroversnik</td> - <td>matjaz.ostroversnik@NOSPAM.zrs-tk.si</td> + <td>matjaz.ostroversnik at zrs-tk dot si</td> <td>1.2.16</td> </tr> <tr bgcolor="#ffffff"> <td>Spanish</td> <td>Francisco Oltra Thennet</td> - <td>foltra@NOSPAM.puc.cl</td> + <td>foltra at puc dot cl</td> <td>1.3.8</td> </tr> <tr bgcolor="#ffffff"> <td>Swedish</td> <td>Mikael Hallin</td> - <td>mikaelhallin@NOSPAM.yahoo.se</td> + <td>mikaelhallin at yahoo dot se</td> <td>1.3.3</td> </tr> <tr bgcolor="#ffffff"> <td>Ukrainian</td> <td>Olexij Tkatchenko</td> - <td>olexij.tkatchenko@NOSPAM.gmx.de</td> + <td>olexij.tkatchenko at gmx dot de</td> <td>1.2.11</td> </tr> <!-- table content end --> @@ -269,7 +269,7 @@ when the translator was updated. Chinese Traditional & Daniel YC Lin & {\tt\tiny daniel@twpda.com} & 1.3.8 \\ ~ & Gary Lee & {\tt\tiny garylee@ecosine.com.tw} & ~ \\ \hline - Croatian & Boris Bralo & {\tt\tiny boris.bralo@zg.tel.hr} & up-to-date \\ + Croatian & Boris Bralo & {\tt\tiny boris.bralo@zg.htnet.hr} & up-to-date \\ \hline Czech & Petr P\v{r}ikryl & {\tt\tiny prikrylp@skil.cz} & up-to-date \\ \hline @@ -293,8 +293,9 @@ when the translator was updated. Italian & Alessandro Falappa & {\tt\tiny alessandro@falappa.net} & up-to-date \\ ~ & Ahmed Aldo Faisal & {\tt\tiny aaf23@cam.ac.uk} & ~ \\ \hline - Japanese & Ryunosuke Satoh & {\tt\tiny sun594@hotmail.com} & 1.3.3 \\ + Japanese & Ryunosuke Satoh & {\tt\tiny sun594@hotmail.com} & up-to-date \\ ~ & Kenji Nagamatsu & {\tt\tiny naga@joyful.club.ne.jp} & ~ \\ + ~ & Iwasa Kazmi & {\tt\tiny iwasa@cosmo-system.jp} & ~ \\ \hline JapaneseEn & see the Japanese language & {\tt\tiny ~} & English based \\ \hline @@ -306,7 +307,7 @@ when the translator was updated. ~ & Mindaugas Radzius & {\tt\tiny mindaugasradzius@takas.lt} & ~ \\ ~ & Aidas Berukstis & {\tt\tiny aidasber@takas.lt} & ~ \\ \hline - Norwegian & Lars Erik Jordet & {\tt\tiny lej@circuitry.no} & 1.2.2 \\ + Norwegian & Lars Erik Jordet & {\tt\tiny lejordet@gmail.com} & up-to-date \\ \hline Polish & Piotr Kaminski & {\tt\tiny Piotr.Kaminski@ctm.gdynia.pl} & 1.3 \\ ~ & Grzegorz Kowal & {\tt\tiny g\_kowal@poczta.onet.pl} & ~ \\ diff --git a/doc/maintainers.txt b/doc/maintainers.txt index 2022a32..e627f5c 100644 --- a/doc/maintainers.txt +++ b/doc/maintainers.txt @@ -27,7 +27,7 @@ Daniel YC Lin: daniel@twpda.com Gary Lee: garylee@ecosine.com.tw TranslatorCroatian -Boris Bralo: boris.bralo@zg.tel.hr +Boris Bralo: boris.bralo@zg.htnet.hr TranslatorCzech Petr Přikryl: prikrylp@skil.cz @@ -64,6 +64,7 @@ Ahmed Aldo Faisal: aaf23@cam.ac.uk TranslatorJapanese Ryunosuke Satoh: sun594@hotmail.com Kenji Nagamatsu: naga@joyful.club.ne.jp +Iwasa Kazmi: iwasa@cosmo-system.jp TranslatorKorean Richard Kim: ryk@dspwiz.com @@ -74,7 +75,7 @@ Mindaugas Radzius: mindaugasradzius@takas.lt Aidas Berukstis: aidasber@takas.lt TranslatorNorwegian -Lars Erik Jordet: lej@circuitry.no +Lars Erik Jordet: lejordet@gmail.com TranslatorPolish Piotr Kaminski: Piotr.Kaminski@ctm.gdynia.pl diff --git a/doc/translator.py b/doc/translator.py index b2da2a6..c103b1b 100644 --- a/doc/translator.py +++ b/doc/translator.py @@ -22,27 +22,26 @@ History: -------- - 2002/05/21 - - This was the last Perl version. - 2003/05/16 - - If the script is given list of languages, only the translator report - is generated and only for those languages. - 2004/01/24 - - Total reimplementation just started: classes TrManager, and Transl. - 2004/02/05 - - First version that produces translator report. The documentation - in the language.doc is not generated yet. - 2004/02/10 - - First fully functional version that generates both the translator - report and the documentation. It is a bit slower than the Perl version, - but is much less tricky and much more flexible. It also solves some - problems that were not solved by the Perl version. The translator report - content should be more useful for developers. + 2002/05/21 - This was the last Perl version. + 2003/05/16 - List of language marks can be passed as arguments. + 2004/01/24 - Total reimplementation started: classes TrManager, and Transl. + 2004/02/05 - First version that produces translator report. No language.doc yet. + 2004/02/10 - First fully functional version that generates both the translator + report and the documentation. It is a bit slower than the + Perl version, but is much less tricky and much more flexible. + It also solves some problems that were not solved by the Perl + version. The translator report content should be more useful + for developers. 2004/02/11 - Some tuning-up to provide more useful information. 2004/04/16 - Added new tokens to the tokenizer (to remove some warnings). 2004/05/25 - Added from __future__ import generators not to force Python 2.3. 2004/06/03 - Removed dependency on textwrap module. 2004/07/07 - Fixed the bug in the fill() function. + 2004/07/21 - Better e-mail mangling for HTML part of language.doc. + - Plural not used for reporting a single missing method. + - Removal of not used translator adapters is suggested only + when the report is not restricted to selected languages + explicitly via script arguments """ from __future__ import generators @@ -1115,8 +1114,12 @@ class Transl: fout.write('\n\n\n') fout.write(self.classId + ' (' + self.baseClassId + ')') if self.missingMethods: - fout.write(' %d' % len(self.missingMethods)) - fout.write(' methods to implement') + num = len(self.missingMethods) + fout.write(' %d' % num) + fout.write(' method') + if num > 1: + fout.write('s') + fout.write(' to implement') fout.write('\n' + '-' * len(self.classId)) # Write the info about the implemented required methods. @@ -1420,7 +1423,10 @@ class TrManager: obj = self.__translDic[x] f.write(' %-30s' % obj.classId) f.write(' %-6s' % obj.readableStatus) - f.write('\t%2d methods to implement' % len(obj.missingMethods)) + numimpl = len(obj.missingMethods) + pluralS = '' + if numimpl > 1: pluralS = 's' + f.write('\t%2d method%s to implement' % (numimpl, pluralS)) if obj.note: f.write('\n\tNote: ' + obj.note + '\n') f.write('\n') @@ -1430,11 +1436,14 @@ class TrManager: adaptMinVersion = obj.status # Set the note if some old translator adapters are not needed - # any more. - for version, adaptClassId in self.adaptMethodsDic.values(): - if version < adaptMinVersion: - f.write('\nNote: The %s class ' % adaptClassId) - f.write('is not used and can be removed.\n') + # any more. Do it only when the script is called without arguments, + # i.e. all languages were checked against the needed translator + # adapters. + if not self.script_argLst: + for version, adaptClassId in self.adaptMethodsDic.values(): + if version < adaptMinVersion: + f.write('\nNote: The %s class ' % adaptClassId) + f.write('is not used and can be removed.\n') # Write the list of the English-based classes. if self.EnBasedIdLst: @@ -1583,7 +1592,7 @@ class TrManager: <td ><b><font size=+1 color="#ffffff"> Language </font></b></td> <td ><b><font size=+1 color="#ffffff"> Maintainer </font></b></td> <td ><b><font size=+1 color="#ffffff"> Contact address </font> - <font size=-2 color="#ffffff">(remove the NOSPAM.)</font></b></td> + <font size=-2 color="#ffffff">(replace the at and dot)</font></b></td> <td ><b><font size=+1 color="#ffffff"> Status </font></b></td> </tr> <!-- table content begin --> @@ -1628,11 +1637,21 @@ class TrManager: ee = '<br>'.join(le) # Mangle the e-mail and replace the entity references. - if ee: - ee = ee.replace('@', '@NOSPAM.') + if ee and ee != ' ': + # More than one maintainer address separated by <br> can be used. + emails = ee.split('<br>') + mangled_list = [] + for email in emails: + name, domain = email.split('@') + domain = domain.replace('.', ' dot ') + mangled_list.append(name + ' at ' + domain) + ee = '<br>'.join(mangled_list) + if mm: mm = mm.replace('č', 'č') mm = mm.replace('ř', 'ř') + mm = mm.replace('š', 'š') + mm = mm.replace('ž', 'ž') # Append the maintainer and e-mail elements. lst.append(htmlTdTpl % mm) @@ -1717,6 +1736,8 @@ class TrManager: latexTable = latexTable.replace('ø', '\\o{}') latexTable = latexTable.replace('č', '\\v{c}') latexTable = latexTable.replace('ř', '\\v{r}') + latexTable = latexTable.replace('š', '\\v{s}') + latexTable = latexTable.replace('ž', '\\v{z}') latexTable = latexTable.replace('_', '\\_') # Put the HTML and LaTeX parts together and define the dic item. |