summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorDimitri van Heesch <dimitri@stack.nl>2010-06-03 09:24:48 (GMT)
committerDimitri van Heesch <dimitri@stack.nl>2010-06-03 09:24:48 (GMT)
commita1528245b280f1068daad8cd850ea345a3f8b568 (patch)
tree060dc6ccdb347682a1d4b73ab3098d95599532f2 /doc
parenta3b06c4fd310fdeda48a4730139cee09b5302072 (diff)
downloadDoxygen-a1528245b280f1068daad8cd850ea345a3f8b568.zip
Doxygen-a1528245b280f1068daad8cd850ea345a3f8b568.tar.gz
Doxygen-a1528245b280f1068daad8cd850ea345a3f8b568.tar.bz2
Release-1.6.3-20100603
Diffstat (limited to 'doc')
-rw-r--r--doc/config.doc28
-rw-r--r--doc/install.doc20
-rw-r--r--doc/language.doc77
-rw-r--r--doc/maintainers.txt116
-rw-r--r--doc/translator.py68
-rw-r--r--doc/translator_report.txt103
6 files changed, 182 insertions, 230 deletions
diff --git a/doc/config.doc b/doc/config.doc
index 455ac61..e46725e 100644
--- a/doc/config.doc
+++ b/doc/config.doc
@@ -80,6 +80,8 @@ followed by the descriptions of the tags grouped by category.
\refitem cfg_distribute_group_doc DISTRIBUTE_GROUP_DOC
\refitem cfg_docset_bundle_id DOCSET_BUNDLE_ID
\refitem cfg_docset_feedname DOCSET_FEEDNAME
+\refitem cfg_docset_publisher_id DOCSET_PUBLISHER_ID
+\refitem cfg_docset_publisher_name DOCSET_PUBLISHER_NAME
\refitem cfg_dot_cleanup DOT_CLEANUP
\refitem cfg_dot_fontname DOT_FONTNAME
\refitem cfg_dot_fontpath DOT_FONTPATH
@@ -87,6 +89,7 @@ followed by the descriptions of the tags grouped by category.
\refitem cfg_dot_graph_max_nodes DOT_GRAPH_MAX_NODES
\refitem cfg_dot_image_format DOT_IMAGE_FORMAT
\refitem cfg_dot_multi_targets DOT_MULTI_TARGETS
+\refitem cfg_dot_num_threads DOT_NUM_THREADS
\refitem cfg_dot_path DOT_PATH
\refitem cfg_dot_transparent DOT_TRANSPARENT
\refitem cfg_dotfile_dirs DOTFILE_DIRS
@@ -103,6 +106,7 @@ followed by the descriptions of the tags grouped by category.
\refitem cfg_exclude_symlinks EXCLUDE_SYMLINKS
\refitem cfg_expand_as_defined EXPAND_AS_DEFINED
\refitem cfg_expand_only_predef EXPAND_ONLY_PREDEF
+\refitem cfg_ext_links_in_window EXT_LINKS_IN_WINDOW
\refitem cfg_extension_mapping EXTENSION_MAPPING
\refitem cfg_external_groups EXTERNAL_GROUPS
\refitem cfg_extra_packages EXTRA_PACKAGES
@@ -1350,6 +1354,15 @@ FILE_VERSION_INFO = "cleartool desc -fmt \%Vn"
reverse domain-name style string, e.g. <code>com.mycompany.MyDocSet</code>.
Doxygen will append <code>.docset</code> to the name.
+\anchor cfg_docset_publisher_id
+<dt>\c DOCSET_PUBLISHER_ID <dd>
+When GENERATE_PUBLISHER_ID tag specifies a string that should uniquely identify
+the documentation publisher. This should be a reverse domain-name style
+string, e.g. com.mycompany.MyDocSet.documentation.
+
+\anchor cfg_docset_publisher_name
+<dt>\c DOCSET_PUBLISHER_NAME <dd>
+The GENERATE_PUBLISHER_NAME tag identifies the documentation publisher.
\anchor cfg_generate_htmlhelp
<dt>\c GENERATE_HTMLHELP <dd>
@@ -1561,6 +1574,12 @@ and Class Hierarchy pages using a tree view instead of an ordered list.
used to set the initial width (in pixels) of the frame in which the tree
is shown.
+\anchor cfg_ext_links_in_window
+<dt>\c EXT_LINKS_IN_WINDOW <dd>
+ \addindex EXT_LINKS_IN_WINDOW
+ When the \c EXT_LINKS_IN_WINDOW option is set to \c YES doxygen will open
+ links to external symbols imported via tag files in a separate window.
+
\anchor cfg_formula_fontsize
<dt>\c FORMULA_FONTSIZE <dd>
\addindex FORMULA_FONTSIZE
@@ -2036,6 +2055,15 @@ TAGFILES = file1=loc1 "file2 = loc2" ... </pre>
visualization toolkit from AT\&T and Lucent Bell Labs. The other options in
this section have no effect if this option is set to \c NO (the default)
+\anchor cfg_dot_num_threads
+<dt>\c DOT_NUM_THREADS <dd>
+ \addindex DOT_NUM_THREADS
+ The \c DOT_NUM_THREADS specifies the number of dot invocations doxygen is
+ allowed to run in parallel. When set to 0 (the default) doxygen will
+ base this on the number of processors available in the system. You can set it
+ explicitly to a value larger than 0 to get control over the balance
+ between CPU load and processing speed.
+
\anchor cfg_dot_fontname
<dt>\c DOT_FONTNAME <dd>
\addindex DOT_FONTNAME
diff --git a/doc/install.doc b/doc/install.doc
index e1a6a29..b213555 100644
--- a/doc/install.doc
+++ b/doc/install.doc
@@ -56,8 +56,8 @@ tools should be installed.
<ul>
<li>Qt Software's GUI toolkit
- <A HREF="http://www.trolltech.com/products/qt.html">Qt</A>
- \latexonly(see {\tt http://www.trolltech.com/products/qt.html})\endlatexonly
+ <a href="http://qt.nokia.com/">Qt</A>
+ \latexonly(see {\tt http://qt.nokia.com/})\endlatexonly
\addindex Qt
version 4.3 or higher.
This is needed to build the GUI front-end doxywizard.
@@ -410,7 +410,7 @@ You can now build the Release or Debug flavor of Doxygen and Doxytag by right-cl
the project in the solutions explorer, and selecting Build.
Note that compiling Doxywizard currently requires Qt version 4
-(see http://www.trolltech.com/products/qt/qt3).
+(see http://qt.nokia.com/products/platform/qt-for-windows).
If you do not have a commercial license, you can build Doxywizard with the open
source version (see http://qtwin.sourceforge.net/qt3-win32/compile-msvc-2005.php),
but I have not tried this myself.
@@ -497,17 +497,11 @@ Here is what is required:
steps.
<li>From Doxygen-1.2.2-20001015 onwards, the distribution includes the part
- of Qt-2.x.y that is needed for to compile doxygen and doxytag,
+ of Qt that is needed for to compile doxygen and doxytag,
The Windows specific part were also created.
- As a result doxygen can be compiled on systems without X11 or the
- commerical version of Qt.
-
- For doxywizard, a complete Qt library is
- still a requirement however. A commercial license to build
- doxywizard with the latest Qt library was kindly donated to me
- by the nice people at <a href="http://www.trolltech.com">Qt Software</a>.
- See doxygen download page for a link.
-
+ As a result doxygen (without the wizard) can be compiled on systems
+ without X11 or the (commerical) version of Qt.
+
<li>If you used WinZip to extract the tar archive it will (apparently) not
create empty folders, so you have to add the folders
<code>objects</code> and <code>bin</code> manually in the root of the
diff --git a/doc/language.doc b/doc/language.doc
index a26d36f..b61b9f4 100644
--- a/doc/language.doc
+++ b/doc/language.doc
@@ -68,12 +68,12 @@ when the translator was updated.
<td>Brazilian Portuguese</td>
<td>Fabio "FJTC" Jun Takada Chino</td>
<td>jun-chino at uol dot com dot br</td>
- <td>1.6.3</td>
+ <td>up-to-date</td>
</tr>
<tr bgcolor="#ffffff">
<td>Catalan</td>
<td>Maximiliano Pin<br/>Albert Mora</td>
- <td>max.pin at bitroit dot com<br/>amora at iua dot upf dot es</td>
+ <td>max.pin at bitroit dot com<br/>[unreachable]</td>
<td>1.6.3</td>
</tr>
<tr bgcolor="#ffffff">
@@ -91,8 +91,8 @@ when the translator was updated.
<tr bgcolor="#ffffff">
<td>Croatian</td>
<td>Boris Bralo</td>
- <td>boris.bralo at zg dot htnet dot hr</td>
- <td>1.6.3</td>
+ <td>boris.bralo at gmail dot com</td>
+ <td>up-to-date</td>
</tr>
<tr bgcolor="#ffffff">
<td>Czech</td>
@@ -145,13 +145,13 @@ when the translator was updated.
<tr bgcolor="#ffffff">
<td>Greek</td>
<td>Paul Gessos</td>
- <td>nickreserved at yahoo dot com</td>
- <td>1.5.4</td>
+ <td>gessos.paul at yahoo dot gr</td>
+ <td>up-to-date</td>
</tr>
<tr bgcolor="#ffffff">
<td>Hungarian</td>
<td>&Aacute;kos Kiss<br/>F&ouml;ldv&aacute;ri Gy&ouml;rgy</td>
- <td>akiss at users dot sourceforge dot net<br/>foldvari lost at cyberspace</td>
+ <td>akiss at users dot sourceforge dot net<br/>[unreachable]</td>
<td>1.4.6</td>
</tr>
<tr bgcolor="#ffffff">
@@ -169,7 +169,7 @@ when the translator was updated.
<tr bgcolor="#ffffff">
<td>Japanese</td>
<td>Hiroki Iseri<br/>Ryunosuke Satoh<br/>Kenji Nagamatsu<br/>Iwasa Kazmi</td>
- <td>goyoki at gmail dot com<br/>sun594 at hotmail dot com<br/>naga at joyful dot club dot ne dot jp<br/>iwasa at cosmo-system dot jp</td>
+ <td>goyoki at gmail dot com<br/>sun594 at hotmail dot com<br/>naga at joyful dot club dot ne dot jp<br/>[unreachable]</td>
<td>1.6.0</td>
</tr>
<tr bgcolor="#ffffff">
@@ -181,7 +181,7 @@ when the translator was updated.
<tr bgcolor="#ffffff">
<td>Korean</td>
<td>Kim Taedong<br/>SooYoung Jung<br/>Richard Kim</td>
- <td>fly1004 at gmail dot com<br/>jung5000 at gmail dot com<br/>ryk at dspwiz dot com</td>
+ <td>fly1004 at gmail dot com<br/>jung5000 at gmail dot com<br/>[unreachable]</td>
<td>1.6.3</td>
</tr>
<tr bgcolor="#ffffff">
@@ -192,8 +192,8 @@ when the translator was updated.
</tr>
<tr bgcolor="#ffffff">
<td>Lithuanian</td>
- <td>Tomas Simonaitis<br/>Mindaugas Radzius<br/>Aidas Berukstis</td>
- <td>haden at homelan dot lt<br/>mindaugasradzius at takas dot lt<br/>aidasber at takas dot lt</td>
+ <td>Tomas Simonaitis<br/>Mindaugas Radzius<br/>Aidas Berukstis<br/>-- contact lost --</td>
+ <td>[unreachable]<br/>[unreachable]<br/>[unreachable]<br/></td>
<td>1.4.6</td>
</tr>
<tr bgcolor="#ffffff">
@@ -217,13 +217,13 @@ when the translator was updated.
<tr bgcolor="#ffffff">
<td>Polish</td>
<td>Piotr Kaminski<br/>Grzegorz Kowal<br/>Krzysztof Kral</td>
- <td>Piotr.Kaminski at ctm dot gdynia dot pl<br/>g_kowal at poczta dot onet dot pl<br/>krzysztof.kral at gmail dot com</td>
+ <td>[unreachable]<br/>[unreachable]<br/>krzysztof.kral at gmail dot com</td>
<td>1.6.3</td>
</tr>
<tr bgcolor="#ffffff">
<td>Portuguese</td>
<td>Rui Godinho Lopes</td>
- <td>ruiglopes at yahoo dot com</td>
+ <td>[unreachable]</td>
<td>1.3.3</td>
</tr>
<tr bgcolor="#ffffff">
@@ -241,7 +241,7 @@ when the translator was updated.
<tr bgcolor="#ffffff">
<td>Serbian</td>
<td>Dejan Milosavljevic</td>
- <td>dmilos at email dot com</td>
+ <td>[unreachable]</td>
<td>1.6.0</td>
</tr>
<tr bgcolor="#ffffff">
@@ -252,8 +252,8 @@ when the translator was updated.
</tr>
<tr bgcolor="#ffffff">
<td>Slovak</td>
- <td>Stanislav Kudl&aacute;&#x010d;</td>
- <td>skudlac at pobox dot sk</td>
+ <td>-- searching for the maintainer --</td>
+ <td></td>
<td>1.2.18</td>
</tr>
<tr bgcolor="#ffffff">
@@ -265,8 +265,8 @@ when the translator was updated.
<tr bgcolor="#ffffff">
<td>Spanish</td>
<td>Bartomeu<br/>Francisco Oltra Thennet<br/>David Vaquero</td>
- <td>bartomeu at loteria3cornella dot com<br/>foltra at puc dot cl<br/>david at grupoikusnet dot com</td>
- <td>1.6.3</td>
+ <td>bartomeu at loteria3cornella dot com<br/>[unreachable]<br/>david at grupoikusnet dot com</td>
+ <td>up-to-date</td>
</tr>
<tr bgcolor="#ffffff">
<td>Swedish</td>
@@ -282,8 +282,8 @@ when the translator was updated.
</tr>
<tr bgcolor="#ffffff">
<td>Ukrainian</td>
- <td>Olexij Tkatchenko</td>
- <td>olexij.tkatchenko at parcs dot de</td>
+ <td>-- searching for the maintainer --</td>
+ <td></td>
<td>1.4.1</td>
</tr>
<tr bgcolor="#ffffff">
@@ -311,10 +311,10 @@ when the translator was updated.
\hline
Arabic & Moaz Reyad & {\tt\tiny moazreyad@yahoo.com} & 1.4.6 \\
\hline
- Brazilian Portuguese & Fabio "FJTC" Jun Takada Chino & {\tt\tiny jun-chino@uol.com.br} & 1.6.3 \\
+ Brazilian Portuguese & Fabio "FJTC" Jun Takada Chino & {\tt\tiny jun-chino@uol.com.br} & up-to-date \\
\hline
Catalan & Maximiliano Pin & {\tt\tiny max.pin@bitroit.com} & 1.6.3 \\
- ~ & Albert Mora & {\tt\tiny amora@iua.upf.es} & ~ \\
+ ~ & Albert Mora & {\tt\tiny [unreachable] amora@iua.upf.es} & ~ \\
\hline
Chinese & Li Daobing & {\tt\tiny lidaobing@gmail.com} & 1.6.0 \\
~ & Wei Liu & {\tt\tiny liuwei@asiainfo.com} & ~ \\
@@ -322,7 +322,7 @@ when the translator was updated.
Chinese Traditional & Daniel YC Lin & {\tt\tiny dlin.tw@gmail.com} & 1.6.0 \\
~ & Gary Lee & {\tt\tiny garywlee@gmail.com} & ~ \\
\hline
- Croatian & Boris Bralo & {\tt\tiny boris.bralo@zg.htnet.hr} & 1.6.3 \\
+ Croatian & Boris Bralo & {\tt\tiny boris.bralo@gmail.com} & up-to-date \\
\hline
Czech & Petr P\v{r}ikryl & {\tt\tiny prikrylp@skil.cz} & 1.6.3 \\
\hline
@@ -340,10 +340,10 @@ when the translator was updated.
\hline
German & Jens Seidel & {\tt\tiny jensseidel@users.sf.net} & 1.6.3 \\
\hline
- Greek & Paul Gessos & {\tt\tiny nickreserved@yahoo.com} & 1.5.4 \\
+ Greek & Paul Gessos & {\tt\tiny gessos.paul@yahoo.gr} & up-to-date \\
\hline
Hungarian & \'{A}kos Kiss & {\tt\tiny akiss@users.sourceforge.net} & 1.4.6 \\
- ~ & F\"{o}ldv\'{a}ri Gy\"{o}rgy & {\tt\tiny foldvari lost@cyberspace} & ~ \\
+ ~ & F\"{o}ldv\'{a}ri Gy\"{o}rgy & {\tt\tiny [unreachable] foldvari lost@cyberspace} & ~ \\
\hline
Indonesian & Hendy Irawan & {\tt\tiny ceefour@gauldong.net} & 1.4.6 \\
\hline
@@ -353,19 +353,20 @@ when the translator was updated.
Japanese & Hiroki Iseri & {\tt\tiny goyoki@gmail.com} & 1.6.0 \\
~ & Ryunosuke Satoh & {\tt\tiny sun594@hotmail.com} & ~ \\
~ & Kenji Nagamatsu & {\tt\tiny naga@joyful.club.ne.jp} & ~ \\
- ~ & Iwasa Kazmi & {\tt\tiny iwasa@cosmo-system.jp} & ~ \\
+ ~ & Iwasa Kazmi & {\tt\tiny [unreachable] iwasa@cosmo-system.jp} & ~ \\
\hline
JapaneseEn & see the Japanese language & {\tt\tiny ~} & English based \\
\hline
Korean & Kim Taedong & {\tt\tiny fly1004@gmail.com} & 1.6.3 \\
~ & SooYoung Jung & {\tt\tiny jung5000@gmail.com} & ~ \\
- ~ & Richard Kim & {\tt\tiny ryk@dspwiz.com} & ~ \\
+ ~ & Richard Kim & {\tt\tiny [unreachable] ryk@dspwiz.com} & ~ \\
\hline
KoreanEn & see the Korean language & {\tt\tiny ~} & English based \\
\hline
- Lithuanian & Tomas Simonaitis & {\tt\tiny haden@homelan.lt} & 1.4.6 \\
- ~ & Mindaugas Radzius & {\tt\tiny mindaugasradzius@takas.lt} & ~ \\
- ~ & Aidas Berukstis & {\tt\tiny aidasber@takas.lt} & ~ \\
+ Lithuanian & Tomas Simonaitis & {\tt\tiny [unreachable] haden@homelan.lt} & 1.4.6 \\
+ ~ & Mindaugas Radzius & {\tt\tiny [unreachable] mindaugasradzius@takas.lt} & ~ \\
+ ~ & Aidas Berukstis & {\tt\tiny [unreachable] aidasber@takas.lt} & ~ \\
+ ~ & -- contact lost -- & {\tt\tiny } & ~ \\
\hline
Macedonian & Slave Jovanovski & {\tt\tiny slavejovanovski@yahoo.com} & 1.6.0 \\
\hline
@@ -373,34 +374,34 @@ when the translator was updated.
\hline
Persian & Ali Nadalizadeh & {\tt\tiny nadalizadeh@gmail.com} & 1.6.0 \\
\hline
- Polish & Piotr Kaminski & {\tt\tiny Piotr.Kaminski@ctm.gdynia.pl} & 1.6.3 \\
- ~ & Grzegorz Kowal & {\tt\tiny g\_kowal@poczta.onet.pl} & ~ \\
+ Polish & Piotr Kaminski & {\tt\tiny [unreachable] Piotr.Kaminski@ctm.gdynia.pl} & 1.6.3 \\
+ ~ & Grzegorz Kowal & {\tt\tiny [unreachable] g\_kowal@poczta.onet.pl} & ~ \\
~ & Krzysztof Kral & {\tt\tiny krzysztof.kral@gmail.com} & ~ \\
\hline
- Portuguese & Rui Godinho Lopes & {\tt\tiny ruiglopes@yahoo.com} & 1.3.3 \\
+ Portuguese & Rui Godinho Lopes & {\tt\tiny [unreachable] ruiglopes@yahoo.com} & 1.3.3 \\
\hline
Romanian & Ionut Dumitrascu & {\tt\tiny reddumy@yahoo.com} & 1.6.0 \\
~ & Alexandru Iosup & {\tt\tiny aiosup@yahoo.com} & ~ \\
\hline
Russian & Alexandr Chelpanov & {\tt\tiny cav@cryptopro.ru} & 1.6.0 \\
\hline
- Serbian & Dejan Milosavljevic & {\tt\tiny dmilos@email.com} & 1.6.0 \\
+ Serbian & Dejan Milosavljevic & {\tt\tiny [unreachable] dmilos@email.com} & 1.6.0 \\
\hline
SerbianCyrilic & Nedeljko Stefanovic & {\tt\tiny stenedjo@yahoo.com} & 1.6.0 \\
\hline
- Slovak & Stanislav Kudl\'{a}\v{c} & {\tt\tiny skudlac@pobox.sk} & 1.2.18 \\
+ Slovak & -- searching for the maintainer -- & {\tt\tiny } & 1.2.18 \\
\hline
Slovene & Matja\v{z} Ostrover\v{s}nik & {\tt\tiny matjaz.ostroversnik@ostri.org} & 1.4.6 \\
\hline
- Spanish & Bartomeu & {\tt\tiny bartomeu@loteria3cornella.com} & 1.6.3 \\
- ~ & Francisco Oltra Thennet & {\tt\tiny foltra@puc.cl} & ~ \\
+ Spanish & Bartomeu & {\tt\tiny bartomeu@loteria3cornella.com} & up-to-date \\
+ ~ & Francisco Oltra Thennet & {\tt\tiny [unreachable] foltra@puc.cl} & ~ \\
~ & David Vaquero & {\tt\tiny david@grupoikusnet.com} & ~ \\
\hline
Swedish & Mikael Hallin & {\tt\tiny mikaelhallin@yahoo.se} & 1.6.0 \\
\hline
Turkish & Emin Ilker Cetinbas & {\tt\tiny niw3@yahoo.com} & 1.6.0 \\
\hline
- Ukrainian & Olexij Tkatchenko & {\tt\tiny olexij.tkatchenko@parcs.de} & 1.4.1 \\
+ Ukrainian & -- searching for the maintainer -- & {\tt\tiny } & 1.4.1 \\
\hline
Vietnamese & Dang Minh Tuan & {\tt\tiny tuanvietkey@gmail.com} & 1.6.0 \\
\hline
diff --git a/doc/maintainers.txt b/doc/maintainers.txt
index 754cb1b..e7a1028 100644
--- a/doc/maintainers.txt
+++ b/doc/maintainers.txt
@@ -8,135 +8,141 @@
% The following one or more lines contain information about
% the maintainer(s) for the language (one line, one maintainer)
% in the form: <readable name><colon><e-mail>
+% If the <e-mail> is prefixed [unreachable] it is not displayed in the table
+% of maintainers in the Doxygen documentation, nor it is used when building
+% the mailto.txt by translator.py.
TranslatorAfrikaans
-Johan Prinsloo: johan@zippysnoek.com
+Johan Prinsloo: johan at zippysnoek dot com
TranslatorArabic
-Moaz Reyad: moazreyad@yahoo.com
+Moaz Reyad: moazreyad at yahoo dot com
TranslatorBrazilian
-Fabio "FJTC" Jun Takada Chino: jun-chino@uol.com.br
+Fabio "FJTC" Jun Takada Chino: jun-chino at uol dot com dot br
TranslatorCatalan
-Maximiliano Pin: max.pin@bitroit.com
-Albert Mora: amora@iua.upf.es
+Maximiliano Pin: max dot pin at bitroit dot com
+Albert Mora: [unreachable] amora at iua dot upf dot es
TranslatorChinese
-Li Daobing: lidaobing@gmail.com
-Wei Liu: liuwei@asiainfo.com
+Li Daobing: lidaobing at gmail dot com
+Wei Liu: liuwei at asiainfo dot com
TranslatorChinesetraditional
-Daniel YC Lin: dlin.tw@gmail.com
-Gary Lee: garywlee@gmail.com
+Daniel YC Lin: dlin dot tw at gmail dot com
+Gary Lee: garywlee at gmail dot com
TranslatorCroatian
-Boris Bralo: boris.bralo@zg.htnet.hr
+Boris Bralo: boris dot bralo at gmail dot com
TranslatorCzech
-Petr P&rcaron;ikryl: prikrylp@skil.cz
+Petr P&rcaron;ikryl: prikrylp at skil dot cz
TranslatorDanish
-Erik S&oslash;e S&oslash;rensen: eriksoe+doxygen@daimi.au.dk
+Erik S&oslash;e S&oslash;rensen: eriksoe+doxygen at daimi dot au dot dk
TranslatorDutch
-Dimitri van Heesch: dimitri@stack.nl
+Dimitri van Heesch: dimitri at stack dot nl
TranslatorEnglish
-Dimitri van Heesch: dimitri@stack.nl
+Dimitri van Heesch: dimitri at stack dot nl
TranslatorEsperanto
-Ander Martinez: dwarfnauko@gmail.com
+Ander Martinez: dwarfnauko at gmail dot com
TranslatorFinnish
-Antti Laine: antti.a.laine@tut.fi
+Antti Laine: antti dot a dot laine at tut dot fi
TranslatorFrench
-Xavier Outhier: xouthier@yahoo.fr
+Xavier Outhier: xouthier at yahoo dot fr
TranslatorGerman
-Jens Seidel: jensseidel@users.sf.net
+Jens Seidel: jensseidel at users dot sf dot net
TranslatorGreek
-Paul Gessos: nickreserved@yahoo.com
+Paul Gessos: gessos dot paul at yahoo dot gr
TranslatorHungarian
-&Aacute;kos Kiss: akiss@users.sourceforge.net
-F&ouml;ldv&aacute;ri Gy&ouml;rgy: foldvari lost@cyberspace
+&Aacute;kos Kiss: akiss at users dot sourceforge dot net
+F&ouml;ldv&aacute;ri Gy&ouml;rgy: [unreachable] foldvari lost at cyberspace
TranslatorIndonesian
-Hendy Irawan: ceefour@gauldong.net
+Hendy Irawan: ceefour at gauldong dot net
TranslatorItalian
-Alessandro Falappa: alessandro@falappa.net
-Ahmed Aldo Faisal: aaf23@cam.ac.uk
+Alessandro Falappa: alessandro at falappa dot net
+Ahmed Aldo Faisal: aaf23 at cam dot ac dot uk
TranslatorJapanese
-Hiroki Iseri: goyoki@gmail.com
-Ryunosuke Satoh: sun594@hotmail.com
-Kenji Nagamatsu: naga@joyful.club.ne.jp
-Iwasa Kazmi: iwasa@cosmo-system.jp
+Hiroki Iseri: goyoki at gmail dot com
+Ryunosuke Satoh: sun594 at hotmail dot com
+Kenji Nagamatsu: naga at joyful dot club dot ne dot jp
+Iwasa Kazmi: [unreachable] iwasa at cosmo-system dot jp
TranslatorKorean
-Kim Taedong: fly1004@gmail.com
-SooYoung Jung: jung5000@gmail.com
-Richard Kim: ryk@dspwiz.com
+Kim Taedong: fly1004 at gmail dot com
+SooYoung Jung: jung5000 at gmail dot com
+Richard Kim: [unreachable] ryk at dspwiz dot com
TranslatorLithuanian
-Tomas Simonaitis: haden@homelan.lt
-Mindaugas Radzius: mindaugasradzius@takas.lt
-Aidas Berukstis: aidasber@takas.lt
+Tomas Simonaitis: [unreachable] haden at homelan dot lt
+Mindaugas Radzius: [unreachable] mindaugasradzius at takas dot lt
+Aidas Berukstis: [unreachable] aidasber at takas dot lt
+-- contact lost --:
TranslatorNorwegian
-Lars Erik Jordet: lejordet@gmail.com
+Lars Erik Jordet: lejordet at gmail dot com
TranslatorMacedonian
-Slave Jovanovski: slavejovanovski@yahoo.com
+Slave Jovanovski: slavejovanovski at yahoo dot com
TranslatorPersian
-Ali Nadalizadeh: nadalizadeh@gmail.com
+Ali Nadalizadeh: nadalizadeh at gmail dot com
TranslatorPolish
-Piotr Kaminski: Piotr.Kaminski@ctm.gdynia.pl
-Grzegorz Kowal: g_kowal@poczta.onet.pl
-Krzysztof Kral: krzysztof.kral@gmail.com
+Piotr Kaminski: [unreachable] Piotr dot Kaminski at ctm dot gdynia dot pl
+Grzegorz Kowal: [unreachable] g_kowal at poczta dot onet dot pl
+Krzysztof Kral: krzysztof dot kral at gmail dot com
TranslatorPortuguese
-Rui Godinho Lopes: ruiglopes@yahoo.com
+Rui Godinho Lopes: [unreachable] ruiglopes at yahoo dot com
TranslatorRomanian
-Ionut Dumitrascu: reddumy@yahoo.com
-Alexandru Iosup: aiosup@yahoo.com
+Ionut Dumitrascu: reddumy at yahoo dot com
+Alexandru Iosup: aiosup at yahoo dot com
TranslatorRussian
-Alexandr Chelpanov: cav@cryptopro.ru
+Alexandr Chelpanov: cav at cryptopro dot ru
TranslatorSerbian
-Dejan Milosavljevic: dmilos@email.com
+Dejan Milosavljevic: [unreachable] dmilos at email dot com
TranslatorSerbianCyrilic
-Nedeljko Stefanovic: stenedjo@yahoo.com
+Nedeljko Stefanovic: stenedjo at yahoo dot com
TranslatorSlovak
-Stanislav Kudl&aacute;&ccaron;: skudlac@pobox.sk
+% Stanislav Kudl&aacute;&ccaron;: [unreachable] skudlac at pobox dot sk
+-- searching for the maintainer --:
TranslatorSlovene
-Matja&zcaron; Ostrover&scaron;nik: matjaz.ostroversnik@ostri.org
+Matja&zcaron; Ostrover&scaron;nik: matjaz dot ostroversnik at ostri dot org
TranslatorSpanish
-Bartomeu: bartomeu@loteria3cornella.com
-Francisco Oltra Thennet: foltra@puc.cl
-David Vaquero: david@grupoikusnet.com
+Bartomeu: bartomeu at loteria3cornella dot com
+Francisco Oltra Thennet: [unreachable] foltra at puc dot cl
+David Vaquero: david at grupoikusnet dot com
TranslatorSwedish
-Mikael Hallin: mikaelhallin@yahoo.se
+Mikael Hallin: mikaelhallin at yahoo dot se
TranslatorUkrainian
-Olexij Tkatchenko: olexij.tkatchenko@parcs.de
+% (resigned) Olexij Tkatchenko: olexij at tkatchenko dot com
+-- searching for the maintainer --:
TranslatorVietnamese
-Dang Minh Tuan: tuanvietkey@gmail.com
+Dang Minh Tuan: tuanvietkey at gmail dot com
TranslatorTurkish
-Emin Ilker Cetinbas: niw3@yahoo.com
+Emin Ilker Cetinbas: niw3 at yahoo dot com
diff --git a/doc/translator.py b/doc/translator.py
index 409b9ec..dd8fa00 100644
--- a/doc/translator.py
+++ b/doc/translator.py
@@ -52,6 +52,10 @@
2008/06/09 - Warning when the MAX_DOT_GRAPH_HEIGHT is still part of trLegendDocs().
2009/05/09 - Changed HTML output to fit it with XHTML DTD
2009/09/02 - Added percentage info to the report (implemented / to be implemented).
+ 2010/02/09 - Added checking/suggestion 'Reimplementation using UTF-8 suggested.
+ 2010/03/03 - Added [unreachable] prefix used in maintainers.txt.
+ 2010/05/28 - BOM skipped; minor code cleaning.
+ 2010/05/31 - e-mail mangled already in maintainers.txt
"""
from __future__ import generators
@@ -223,7 +227,7 @@ class Transl:
# Open the file for reading and extracting tokens until the eof.
# Initialize the finite automaton.
- f = file(self.fname)
+ f = open(self.fname)
lineNo = 0
line = '' # init -- see the pos initialization below
linelen = 0 # init
@@ -242,9 +246,11 @@ class Transl:
else:
lineNo += 1
line = f.readline()
+ if line.startswith('\xef\xbb\xbf'):
+ line = line[3:] # skip the BOM
linelen = len(line)
pos = 0
- if line == '': # eof
+ if line == '': # eof
status = 777
else:
c = line[pos]
@@ -1439,7 +1445,7 @@ class TrManager:
self.numLang -= 1 # the couple will be counted as one
# Extract the version of Doxygen.
- f = file(os.path.join(self.doxy_path, 'VERSION'))
+ f = open(os.path.join(self.doxy_path, 'VERSION'))
self.doxVersion = f.readline().strip()
f.close()
@@ -1487,7 +1493,7 @@ class TrManager:
# Read content of the file as one string.
assert os.path.isfile(fname)
- f = file(fname)
+ f = open(fname)
cont = f.read()
f.close()
@@ -1525,11 +1531,19 @@ class TrManager:
return trdic
-
+ def __emails(self, classId):
+ """Returns the list of maintainer emails.
- def __email(self, classId):
- """Returns the first maintainer for the translator class"""
- return self.__maintainersDic[classId][0][1]
+ The method returns the list of e-mail adresses for the translator
+ class, but only the addresses that were not marked as [unreachable]."""
+ lst = []
+ for m in self.__maintainersDic[classId]:
+ if not m[1].startswith('[unreachable]'):
+ email = m[1]
+ email = email.replace(' at ', '@') # Unmangle the mangled e-mail
+ email = email.replace(' dot ', '.')
+ lst.append(email)
+ return lst
def generateTranslatorReport(self):
@@ -1538,7 +1552,7 @@ class TrManager:
output = os.path.join(self.doc_path, self.translatorReportFileName)
# Open the textual report file for the output.
- f = file(output, 'w')
+ f = open(output, 'w')
# Output the information about the version.
f.write('(' + self.doxVersion + ')\n\n')
@@ -1566,7 +1580,7 @@ class TrManager:
# The e-mail addresses of the maintainers will be collected to
# the auxiliary file in the order of translator classes listed
# in the translator report.
- fmail = file('mailto.txt', 'w')
+ fmail = open('mailto.txt', 'w')
# Write the list of up-to-date translator classes.
if self.upToDateIdLst:
@@ -1586,7 +1600,7 @@ class TrManager:
if obj.note:
f.write(' -- ' + obj.note)
f.write('\n')
- mailtoLst.append(self.__email(obj.classId))
+ mailtoLst.extend(self.__emails(obj.classId))
fmail.write('up-to-date\n')
fmail.write('; '.join(mailtoLst))
@@ -1620,7 +1634,7 @@ class TrManager:
if obj.note:
f.write('\n\tNote: ' + obj.note + '\n')
f.write('\n')
- mailtoLst.append(self.__email(obj.classId)) # to maintainer
+ mailtoLst.extend(self.__emails(obj.classId)) # to maintainer
# Check the level of required adapter classes.
if obj.status != '0.0.00' and obj.status < adaptMinVersion:
@@ -1723,7 +1737,7 @@ class TrManager:
self.lastModificationTime = tim
# Process the content of the maintainers file.
- f = file(fname)
+ f = open(fname)
inside = False # inside the record for the language
lineReady = True
classId = None
@@ -1753,7 +1767,8 @@ class TrManager:
self.__maintainersDic[classId] = []
# Split the information about the maintainer and append
- # the tuple.
+ # the tuple. The address may be prefixed '[unreachable]'.
+ # This will be processed later.
lst = line.split(':', 1)
assert(len(lst) == 2)
t = (lst[0].strip(), lst[1].strip())
@@ -1786,7 +1801,7 @@ class TrManager:
#
# Read the template of the documentation, and remove the first
# attention lines.
- f = file(fTplName)
+ f = open(fTplName)
line = f.readline()
while line[0] != '/':
line = f.readline()
@@ -1862,20 +1877,17 @@ class TrManager:
if not mm and self.__maintainersDic.has_key(obj.classId):
lm = [ m[0] for m in self.__maintainersDic[obj.classId] ]
mm = '<br/>'.join(lm)
- le = [ m[1] for m in self.__maintainersDic[obj.classId] ]
+
+ # Unreachable adresses will not be displayed at all.
+ le = []
+ for m in self.__maintainersDic[obj.classId]:
+ address = m[1]
+ if address.startswith('[unreachable]'):
+ address = '[unreachable]'
+ le.append(address)
ee = '<br/>'.join(le)
- # Mangle the e-mail and replace the entity references.
- if ee and ee != '&nbsp;':
- # 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)
-
+ # Replace the entity references.
if mm:
mm = mm.replace('&ccaron;', '&#x010d;')
mm = mm.replace('&rcaron;', '&#x0159;')
@@ -1973,7 +1985,7 @@ class TrManager:
tplDic['informationTable'] = htmlTable + '\n' + latexTable
# Insert the symbols into the document template and write it down.
- f = file(fDocName, 'w')
+ f = open(fDocName, 'w')
f.write(doctpl % tplDic)
f.close()
diff --git a/doc/translator_report.txt b/doc/translator_report.txt
index e2d9cc8..9501c7d 100644
--- a/doc/translator_report.txt
+++ b/doc/translator_report.txt
@@ -10,7 +10,7 @@ Persian, Polish, Portuguese, Romanian, Russian, Serbian,
SerbianCyrilic, Slovak, Slovene, Spanish, Swedish, Turkish, Ukrainian,
and Vietnamese.
-Of them, 2 translators are up-to-date, 36 translators are based on
+Of them, 6 translators are up-to-date, 32 translators are based on
some adapter class, and 2 are English based.
----------------------------------------------------------------------
@@ -19,8 +19,12 @@ alphabetically). This means that they derive from the Translator class
and they implement all 225 of the required methods. Anyway, there
still may be some details listed even for them:
+ TranslatorBrazilian
+ TranslatorCroatian
TranslatorDutch
TranslatorEnglish
+ TranslatorGreek
+ TranslatorSpanish -- The MAX_DOT_GRAPH_HEIGHT found in trLegendDocs()
----------------------------------------------------------------------
The following translator classes need some maintenance (the most
@@ -28,7 +32,6 @@ 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:
- TranslatorSpanish 1.6.3 4 methods to implement (1 %)
TranslatorPolish 1.6.3 4 methods to implement (1 %)
TranslatorKorean 1.6.3 4 methods to implement (1 %)
Note: Reimplementation using UTF-8 suggested.
@@ -39,11 +42,7 @@ must be implemented to become up-to-date:
TranslatorEsperanto 1.6.3 4 methods to implement (1 %)
TranslatorCzech 1.6.3 4 methods to implement (1 %)
- TranslatorCroatian 1.6.3 4 methods to implement (1 %)
TranslatorCatalan 1.6.3 4 methods to implement (1 %)
- TranslatorBrazilian 1.6.3 4 methods to implement (1 %)
- Note: Reimplementation using UTF-8 suggested.
-
TranslatorVietnamese 1.6.0 9 methods to implement (4 %)
TranslatorTurkish 1.6.0 9 methods to implement (4 %)
TranslatorSwedish 1.6.0 9 methods to implement (4 %)
@@ -77,9 +76,6 @@ must be implemented to become up-to-date:
TranslatorAfrikaans 1.6.0 9 methods to implement (4 %)
Note: Reimplementation using UTF-8 suggested.
- TranslatorGreek 1.5.4 31 methods to implement (13 %)
- Note: Reimplementation using UTF-8 suggested.
-
TranslatorDanish 1.5.4 31 methods to implement (13 %)
Note: Reimplementation using UTF-8 suggested.
@@ -209,19 +205,6 @@ TranslatorArabic (TranslatorAdapter_1_4_6) 32 methods to implement (14 %)
virtual QCString trNoDescriptionAvailable()
-TranslatorBrazilian (TranslatorAdapter_1_6_3) 4 methods to implement (1 %)
--------------------
-
- Implements 221 of the required methods (98 %).
-
- Missing methods (should be implemented):
-
- virtual QCString trDateTime(int year, int month, int day, int dayOfWeek, int hour, int minutes, int seconds, bool includeTime)
- virtual QCString trFileIn(const char * name)
- virtual QCString trDirDependency(const char * name)
- virtual QCString trIncludesFileIn(const char * name)
-
-
TranslatorCatalan (TranslatorAdapter_1_6_3) 4 methods to implement (1 %)
-----------------
@@ -271,19 +254,6 @@ TranslatorChinesetraditional (TranslatorAdapter_1_6_0) 9 methods to implement
virtual QCString trIncludesFileIn(const char * name)
-TranslatorCroatian (TranslatorAdapter_1_6_3) 4 methods to implement (1 %)
-------------------
-
- Implements 221 of the required methods (98 %).
-
- Missing methods (should be implemented):
-
- virtual QCString trDateTime(int year, int month, int day, int dayOfWeek, int hour, int minutes, int seconds, bool includeTime)
- virtual QCString trFileIn(const char * name)
- virtual QCString trDirDependency(const char * name)
- virtual QCString trIncludesFileIn(const char * name)
-
-
TranslatorCzech (TranslatorAdapter_1_6_3) 4 methods to implement (1 %)
---------------
@@ -394,58 +364,6 @@ TranslatorGerman (TranslatorAdapter_1_6_3) 4 methods to implement (1 %)
virtual QCString trIncludesFileIn(const char * name)
-TranslatorGreek (TranslatorAdapter_1_5_4) 31 methods to implement (13 %)
----------------
-
- Implements 194 of the required methods (86 %).
-
- Missing methods (should be implemented):
-
- virtual QCString trCompoundMembersDescriptionFortran(bool extractAll)
- virtual QCString trSearching()
- virtual QCString trNoMatches()
- virtual QCString trGeneratedFromFilesFortran(ClassDef::CompoundType compType, bool single)
- virtual QCString trLoading()
- virtual QCString trSubprograms()
- virtual QCString trDateTime(int year, int month, int day, int dayOfWeek, int hour, int minutes, int seconds, bool includeTime)
- virtual QCString trModulesListDescription(bool extractAll)
- virtual QCString trModulesList()
- virtual QCString trTypeConstraints()
- virtual QCString trFileIn(const char * name)
- virtual QCString trGlobalNamespace()
- virtual QCString trMemberFunctionDocumentationFortran()
- virtual QCString trCompoundListDescriptionFortran()
- virtual QCString trTypeDocumentation()
- virtual QCString trModuleReference(const char * namespaceName)
- virtual QCString trModulesMemberDescription(bool extractAll)
- virtual QCString trModulesMembers()
- virtual QCString trModulesIndex()
- virtual QCString trDirRelation(const char * name)
- virtual QCString trCompoundListFortran()
- virtual QCString trDataTypes()
- virtual QCString trDirDependency(const char * name)
- virtual QCString trIncludesFileIn(const char * name)
- virtual QCString trCompoundIndexFortran()
- virtual QCString trSubprogram(bool first_capital, bool singular)
- virtual QCString trCompoundReferenceFortran(const char * clName, ClassDef::CompoundType compType, bool isTemplate)
- virtual QCString trType(bool first_capital, bool singular)
- virtual QCString trModule(bool first_capital, bool singular)
- virtual QCString trCompoundMembersFortran()
- virtual QCString trSubprogramDocumentation()
-
- Obsolete methods (should be removed, never used):
-
- virtual QCString trHeaderFilesDescription()
- virtual QCString trField(bool first_capital, bool singular)
- virtual QCString trPackageDocumentation()
- virtual QCString trSources()
- virtual QCString trReimplementedForInternalReasons()
- virtual QCString trInterfaces()
- virtual QCString trHeaderFiles()
- virtual QCString trBugsAndLimitations()
- virtual QCString trNoDescriptionAvailable()
-
-
TranslatorHungarian (TranslatorAdapter_1_4_6) 33 methods to implement (14 %)
-------------------
@@ -1039,17 +957,10 @@ TranslatorSlovene (TranslatorAdapter_1_4_6) 33 methods to implement (14 %)
virtual QCString trSubprogramDocumentation()
-TranslatorSpanish (TranslatorAdapter_1_6_3) 4 methods to implement (1 %)
+TranslatorSpanish (Translator)
-----------------
- Implements 221 of the required methods (98 %).
-
- Missing methods (should be implemented):
-
- virtual QCString trDateTime(int year, int month, int day, int dayOfWeek, int hour, int minutes, int seconds, bool includeTime)
- virtual QCString trFileIn(const char * name)
- virtual QCString trDirDependency(const char * name)
- virtual QCString trIncludesFileIn(const char * name)
+ Implements 225 of the required methods (100 %).
TranslatorSwedish (TranslatorAdapter_1_6_0) 9 methods to implement (4 %)