summaryrefslogtreecommitdiffstats
path: root/doc/language.tpl
diff options
context:
space:
mode:
authorDimitri van Heesch <dimitri@stack.nl>2001-12-29 18:30:48 (GMT)
committerDimitri van Heesch <dimitri@stack.nl>2001-12-29 18:30:48 (GMT)
commitad53b7bebd3042598e5a11b1f3ef29468815138b (patch)
tree048517043e4c90dcc686bc038b480825fe32886c /doc/language.tpl
parent7e4d434c3650bb9f7e5f460b1dbf6fed8be04a5f (diff)
downloadDoxygen-ad53b7bebd3042598e5a11b1f3ef29468815138b.zip
Doxygen-ad53b7bebd3042598e5a11b1f3ef29468815138b.tar.gz
Doxygen-ad53b7bebd3042598e5a11b1f3ef29468815138b.tar.bz2
Release-1.2.13
Diffstat (limited to 'doc/language.tpl')
-rw-r--r--doc/language.tpl17
1 files changed, 17 insertions, 0 deletions
diff --git a/doc/language.tpl b/doc/language.tpl
index 3982278..d000bb6 100644
--- a/doc/language.tpl
+++ b/doc/language.tpl
@@ -296,5 +296,22 @@ translator adapter base class. The reason is that the adapter
classes implement also obsolete methods. Another reason is that
some of the methods could become obsolete from some newer adapter on.
+<b>The really obsolete language translators</b> may lead to too much
+complicated adapters. Because of that, doxygen developers may decide
+to derive such translators from the \c TranslatorEnglish class, which
+is by definition always up-to-date.
+
+When doing so, all the missing methods will be replaced by the
+English translation. This means that not-implemented methods will
+always return the English result. Such translators are marked using
+word \c obsolete. You should read it <b>really obsolete</b>. No
+guess about the last update can be done.
+
+Often, it is possible to construct better result from the obsolete
+methods. Because of that, the translator adapter classes should be
+used if possible. On the other hand, implementation of adapters for
+really obsolete translators brings too much maintenance and
+run-time overhead.
+
*/