Release-1.2.15-20020430

INSTALL

-DOXYGEN Version 1.2.15-20020421
+DOXYGEN Version 1.2.15-20020430
 
 Please read the installation section of the manual for instructions.
 
 --------
-Dimitri van Heesch (21 April 2002)
+Dimitri van Heesch (30 April 2002)

README

-DOXYGEN Version 1.2.15_20020421
+DOXYGEN Version 1.2.15_20020430
 
 Please read INSTALL for compilation instructions.
 
@@ -17,4 +17,4 @@ to subscribe to the lists or to visit the archives.
 
 Enjoy,
 
-Dimitri van Heesch (dimitri@stack.nl) (21 April 2002)
+Dimitri van Heesch (dimitri@stack.nl) (30 April 2002)

VERSION

-1.2.15-20020421
+1.2.15-20020430

addon/doxmlparser/include/doxmlintf.h

@@ -681,11 +681,11 @@ class IFile : public ICompound
   public:
     virtual IGraph *includeDependencyGraph() const = 0;
     virtual IGraph *includedByDependencyGraph() const = 0;
+    virtual IDocProgramListing *source() const = 0;
 
     // file:
     //  includes()
     //  includedBy()
-    //  IDocProgramListing *source()
     //  ICompound *innerNamespaces()
     //  ICompoundIterator *innerClasses()
 };

addon/doxmlparser/src/compoundhandler.cpp

@@ -190,7 +190,6 @@ CompoundHandler::CompoundHandler(const QString &xmlDir)
   addStartHandler("innerclass",this,&CompoundHandler::startInnerClass);
   addEndHandler("innerclass");
 
-
 }
 
 CompoundHandler::~CompoundHandler()
@@ -461,3 +460,8 @@ ICompoundIterator *CompoundHandler::nestedClasses() const
   return new CompoundIdIterator(m_mainHandler,m_innerClasses);
 }
 
+IDocProgramListing *CompoundHandler::source() const
+{
+  return m_programListing;
+}
+

addon/doxmlparser/src/compoundhandler.h

@@ -123,6 +123,7 @@ class CompoundHandler : public IClass,
     // IFile implementation
     IGraph *includeDependencyGraph() const; 
     IGraph *includedByDependencyGraph() const;
+    IDocProgramListing *source() const;
     
   private:
     QList<RelatedCompound>  m_superClasses;
@@ -147,6 +148,7 @@ class CompoundHandler : public IClass,
     GraphHandler           *m_includeDependencyGraph;
     GraphHandler           *m_includedByDependencyGraph;
     QList<QString>          m_innerClasses;
+    ProgramListingHandler  *m_source;
 
 };
 

addon/doxmlparser/src/dochandler.cpp

@@ -627,7 +627,7 @@ void RefHandler::startRef(const QXmlAttributes& attrib)
 {
   m_parent->setDelegate(this);
   m_refId = attrib.value("refid");
-  m_refId = attrib.value("external");
+  m_extId = attrib.value("external");
   ASSERT(attrib.value("kindref")=="compound" || 
          attrib.value("kindref")=="member");
   m_targetKind = attrib.value("kindref")=="compound" ?  Compound : Member;

addon/doxmlparser/src/doxmlintf.h

@@ -681,11 +681,11 @@ class IFile : public ICompound
   public:
     virtual IGraph *includeDependencyGraph() const = 0;
     virtual IGraph *includedByDependencyGraph() const = 0;
+    virtual IDocProgramListing *source() const = 0;
 
     // file:
     //  includes()
     //  includedBy()
-    //  IDocProgramListing *source()
     //  ICompound *innerNamespaces()
     //  ICompoundIterator *innerClasses()
 };

addon/doxmlparser/test/main.cpp

@@ -588,6 +588,9 @@ int main(int argc,char **argv)
 
       printf("==== included by dependency graph ==== \n");
       DumpGraph(file->includedByDependencyGraph());
+
+      printf("==== source ====\n");
+      DumpDoc(file->source(),0);
     }
     
     comp->release();

configure

@@ -27,7 +27,7 @@ f_prefix=/usr
 f_insttool=NO
 f_english=NO
 f_wizard=NO
-f_langs=nl,se,cz,fr,it,de,jp,es,fi,ru,hr,pl,pt,hu,kr,ro,si,cn,no,br,dk,sk,ua,gr
+f_langs=nl,se,cz,fr,it,de,jp,es,fi,ru,hr,pl,pt,hu,kr,ro,si,cn,no,br,dk,sk,ua,gr,tw
 
 while test -n "$1";  do
   case $1 in
@@ -412,11 +412,11 @@ EOF
   fi
 fi
 
-if test "$f_platform" = "win32-g++"; then
-  cat >> .tmakeconfig <<EOF
-    TMAKE_LFLAGS += -D_WIN32
-EOF
-fi
+#if test "$f_platform" = "win32-g++"; then
+#  cat >> .tmakeconfig <<EOF
+#    TMAKE_LFLAGS += -D_WIN32
+#EOF
+#fi
 
 if test "$f_english" = YES; then
   cat >> .tmakeconfig <<EOF
@@ -483,7 +483,7 @@ echo -n "  Generating src/lang_cfg.h..."
 echo $f_langs | $f_perl -e '@l=split(/,/,<STDIN>); 
         chomp @l; 
 	@allowed=(NL,SE,CZ,FR,IT,DE,JP,ES,FI,RU,HR,PL,PT,HU,KR,RO,SI,CN,NO,BR,
-		  DK,SK,UA,GR);
+		  DK,SK,UA,GR,TW);
 	foreach my $elem (@l){ 
 	     $elem =~ tr/a-z/A-Z/;
 	     $r=0;

doc/docblocks.doc

@@ -18,34 +18,154 @@
 
 \subsection specialblock Special documentation blocks
 
-The following types of special documentation blocks are supported by doxygen:
-<ul>
-<li>The Qt style, where special documentation blocks look like:
+A special documentation block is a C or C++ comment block with some 
+additional markings, so doxygen knows it is a piece of documentation that
+needs to end up in the generated documentation. 
+
+For each code item there are two types of descriptions, which together
+form the documentation: a \e brief description and \e detailed
+description, both are optional. 
+Having more than one brief or detailed description however, is 
+not allowed. 
+
+As the name suggest, a brief description is
+a short one-liner, whereas the detailed description provides longer, 
+more detailed documentation.
+
+There are several ways to mark a comment block as a detailed description:
+<ol>
+<li> You can use the JavaDoc style, which consist of a C-style comment
+block starting with two *'s, like this:
+
+\verbatim
+/**
+ * ... text ...
+ */
+\endverbatim
+
+<li> or you can use the Qt style and add an exclamation mark (!) 
+after the opening of a C-style comment block, as shown in this example:
+
 \verbatim
 /*!
-  ... text ...
+ * ... text ...
+ */
+\endverbatim
+
+In both cases the intermediate *'s are optional, so
+
+\verbatim
+/*!
+ ... text ...
 */
-\endverbatim and the one line version:
+\endverbatim
+
+is also valid.
+
+<li> A third alternative is to use a block of at least two C++ comment 
+lines, where the first starts with an additional slash or an 
+exclamation mark. Here are examples of the two cases:
+
+\verbatim
+///
+// ... text ...
+//
+\endverbatim
+
+or
+
 \verbatim
-//! ... one line of text ...
+//!
+// ... text ...
+//
 \endverbatim
-<li>The JavaDoc style, where special documentation blocks look like:
+
+<li>
+
+One could also repeat the special markers for each line as shown in
+the following examples:
+
 \verbatim
-/**
- * ... text ...
+/// 
+/// ... text ....
+///
+\endverbatim
+
+or 
+
+\verbatim
+//!
+//! ... text ...
+//!
+\endverbatim
+
+</ol>
+
+For the brief description there are also several posibilities:
+<ol>
+<li>One could use the \ref cmdbrief "\brief" command with one of the 
+above comment blocks. This command ends at the end of a paragraph, 
+so the detailed description follows after an empty line.
+
+Here is an example:
+
+\verbatim
+/*! \brief Brief description.
+ *         Brief description continued.
+ *
+ *  Detailed description starts here.
  */
-\endverbatim and the one line version:
+\endverbatim
+
+<li>If \ref cfg_javadoc_autobrief "JAVADOC_AUTOBRIEF" is set to YES in the configuration file, 
+    then using JavaDoc style comment
+    blocks will automatically start a brief description which ends at the
+    first dot. Here is an example:
+
 \verbatim
-/// ... one line of text ...
+/** Brief description which ends at this dot. Details follow
+ *  here.
+ */
 \endverbatim
-</ul>
 
-Doxygen only allows one brief and one detailed description. If there is
-one brief description before a declaration and one before a
-definition, only the one before the \e declaration will be used. If
-the same situation occurs for a detailed description,
-the one before the \e definition is preferred and the one before the
-declaration will be ignored.
+<li>A third option is to use a special C++ style comment which does not 
+    span more than one line. Here are two examples:
+\verbatim
+/// Brief description.
+/** Detailed description. */
+\endverbatim
+
+or
+
+\verbatim
+//! Brief descripion.
+
+//! Detailed description 
+//! starts here.
+\endverbatim
+
+Note the blank line in the last example, which is required to separate the 
+brief description from the block containing the detailed description.
+
+</ol>
+
+As you can see doxygen is quite flexible. The following however is
+not legal
+
+\verbatim
+//! Brief description, which is
+//! really a detailed description since it spans multiple lines.
+/*! Oops, another detailed description!
+ */
+\endverbatim
+
+because doxygen only allows one brief and one detailed description. 
+
+Furthermore, if there is one brief description before a declaration 
+and one before a definition of a code item, only the one before 
+the \e declaration will be used. If the same situation occurs for a 
+detailed description, the one before the \e definition is preferred 
+and the one before the declaration will be ignored.
 
 Here is an example of a documented piece of C++ code using the Qt style:
 \verbinclude qtstyle.cpp
@@ -54,10 +174,10 @@ Here is an example of a documented piece of C++ code using the Qt style:
  for the corresponding HTML documentation that is generated by doxygen.
  \endhtmlonly
 
-The one-line comments should contain a brief description, 
+The one-line comments contain a brief description, 
 whereas the multi-line comment blocks contain a more detailed description.
-Note that consecutive one-line comments are merged together in one brief 
-description. The brief descriptions are included in the member overview of a 
+
+The brief descriptions are included in the member overview of a 
 class, namespace or file and are printed using a small italic font 
 (this description can be hidden by setting 
 \ref cfg_brief_member_desc "BRIEF_MEMBER_DESC" to \c NO in 
@@ -95,25 +215,82 @@ implementer of the members more direct access to the documentation.
 As a compromise the brief description could be placed before the
 declaration and the detailed description before the member definition.
 
-\par Note:
-Each entity can only have \e one brief and \e one detailed description. If you
-specify more than one comment block of the same type, only one will be used,
-and all others are ignored!
+\subsection memberdoc Documenting members afterwards
+
+If you want to document the members of a file, struct, union, class, or enum,
+and you want to put the documentation for these members inside the compound,
+it is sometimes desired to place the documentation block after the member 
+instead of before. For this purpose you should put an additional \< marker
+in the comment block.
+
+Here are some examples:
+\verbatim
+int var; /*!< Detailed description after the member */
+\endverbatim
+This block can be used to put a Qt style detailed 
+documentation block \e after a member. Other ways to do the
+same are:
+\verbatim
+int var; /**< Detailed description after the member */
+\endverbatim
+or 
+\verbatim
+int var; //!< Detailed description after the member
+         //!< 
+\endverbatim
+or 
+\verbatim
+int var; ///< Detailed description after the member
+         ///< 
+\endverbatim
+
+Most often one only wants to put a brief description after a member.
+This is done as follows:
+\verbatim
+int var; //!< Brief description after the member
+\endverbatim
+or
+\verbatim
+int var; ///< Brief description after the member
+\endverbatim
+
+Note that these blocks have the same structure and meaning as the 
+special comment blocks in the previous section 
+only the \< indicates that the member is 
+located in front of the block instead of after the block.
+
+Here is an example of the use of these comment blocks:
+\verbinclude afterdoc.h
+ \htmlonly
+ Click <a href="$(DOXYGEN_DOCDIR)/examples/afterdoc/html/class_test.html">here</a>
+ for the corresponding HTML documentation that is generated by doxygen.
+ \endhtmlonly
+
+\warning These blocks can only be used to document \e members and \e parameters.
+         They cannot be used to document files, classes, unions, structs,
+         groups, namespaces and enums themselves. Furthermore, the structural 
+         commands mentioned in the next section 
+         (like <code>\\class</code>) are ignored inside these comment blocks.
 
-\subsection structuralcommands Structural commands
+\subsection structuralcommands Documentation at other places
 
 So far we have assumed that the documentation blocks are always located in 
 front of the declaration or definition of a file, class or namespace or in
-front of one of its members. 
-Although this is often comfortable, it may sometimes be better to put the 
-documentation somewhere else. For some types of documentation blocks (like file
-documentation) this is even required. Doxygen allows you to put your
-documentation blocks practically anywhere (the exception is inside the body 
-of a function or inside a normal C style comment block), as long as you put a 
-structural command inside the documentation block.
+front or after one of its members. 
+Although this is often comfortable, there may sometimes be reasons to put the 
+documentation somewhere else. For documenting a file this is even 
+required since there is no such thing as "in front of a file". 
+Doxygen allows you to put your documentation blocks practically 
+anywhere (the exception is inside the body of a function or inside a 
+normal C style comment block). 
+
+The price you pay for not putting the
+documentation block before (or after) an item is the need to put a  
+structural command inside the documentation block, which leads to some
+duplication of information.
 
 Structural commands (like all other commands) start with a backslash 
-(<tt>\\</tt>), or an at-sign (<tt>\@</tt>) in JavaDoc style, 
+(<tt>\\</tt>), or an at-sign (<tt>\@</tt>) if you prefer JavaDoc style, 
 followed by a command name and one or more parameters.
 For instance, if you want to document the class \c Test in the example
 above, you could have also put the following documentation block somewhere
@@ -138,16 +315,17 @@ Other structural commands are:
 <li>\c \def to document a \#define.
 <li>\c \file to document a file.
 <li>\c \namespace to document a namespace.
+<li>\c \package to document a Java package.
+<li>\c \interface to document an IDL interface.
 </ul>
-See section \ref commands for detailed information about these and other 
-commands. Note that the documentation block belonging to a file 
-should always contain a structural command.
+See section \ref commands for detailed information about these and many other 
+commands. 
 
 To document a member of a C++ class, you must also document the class 
-itself. The same holds for namespaces. To document a global C function, typedef, 
-enum or preprocessor definition you must first document the file that 
-contains it (usually this will be a header file, because that file contains 
-the information that is exported to other source files).
+itself. The same holds for namespaces. To document a global C function, 
+typedef, enum or preprocessor definition you must first document the file 
+that contains it (usually this will be a header file, because that file 
+contains the information that is exported to other source files).
 
 Let's repeat that, because it is often overlooked:
 to document global objects (functions, typedefs, enum, macros, etc), you
@@ -163,55 +341,15 @@ using structural commands:
  for the corresponding HTML documentation that is generated by doxygen.
  \endhtmlonly
 
-\par Note:
-  Because each comment block in the example above contains a structural command, all
-  the comment blocks could be moved to another location or input file 
-  (the source file for instance), without affecting the generated 
-  documentation. The disadvantage of this approach is that prototypes are
-  duplicated, so all changes have to be made twice!
-
-\subsection memberdoc Documenting compound members.
-
-If you want to document the members of a file, struct, union, class, or enum,
-and you want to put the documentation for these members inside the compound,
-it is sometimes desired to place the documentation block after the member 
-instead of before. For this purpose doxygen has the following 
-additional comment blocks:
-\verbatim
-/*!< ... */
-\endverbatim
-This block can be used to put a Qt style detailed 
-documentation block after a member.
-The one line brief description looks as follows:
-\verbatim
-//!< ...
-\endverbatim
-There are also JavaDoc versions for detailed documentation:
-\verbatim
-/**< ... */
-\endverbatim
-(where the first sentence is the brief description 
-if \c JAVADOC_AUTOBRIEF is set to \c YES)
-and there is a separate brief description as well:
-\verbatim
-///< ... 
-\endverbatim
-Note that these blocks have the same structure and meaning as the 
-special comment blocks above only the \< indicates that the member is 
-located in front of the block instead of after the block.
-
-Here is an example of the use of these comment blocks:
-\verbinclude afterdoc.h
- \htmlonly
- Click <a href="$(DOXYGEN_DOCDIR)/examples/afterdoc/html/class_test.html">here</a>
- for the corresponding HTML documentation that is generated by doxygen.
- \endhtmlonly
-
-\warning These blocks can only be used to document \e members and \e parameters.
-         They cannot be used to document files, classes, unions, structs,
-         groups, namespaces and enums themselves. Furthermore, the structural 
-         commands mentioned in the previous section 
-         (like <code>\\class</code>) are ignored inside these comment blocks.
+ Because each comment block in the example above contains a structural command, all
+ the comment blocks could be moved to another location or input file 
+ (the source file for instance), without affecting the generated 
+ documentation. The disadvantage of this approach is that prototypes are
+ duplicated, so all changes have to be made twice! Because of this you
+ should first consider if this is really needed, and avoid structural
+ commands if possible. I often receive examples that contain \\fn command
+ in comment blocks which are place in front of a function. This is clearly
+ a case where the \\fn command is redundant and will only lead to problems.
 
 \htmlonly
 Go to the <a href="lists.html">next</a> section or return to the

doc/language.doc

@@ -25,13 +25,14 @@ Doxygen has built-in support for multiple languages. This means
 that the text fragments that doxygen generates can be produced in
 languages other than English (the default) at configuration time.
 
-Currently (version 1.2.14-20020317), 25 languages 
+Currently (version 1.2.15-20020421), 26 languages 
 are supported (sorted alphabetically): 
-Brazilian Portuguese, Chinese, Croatian, Czech, Danish, 
-Dutch, English, Finnish, French, German, 
-Greek, Hungarian, Italian, Japanese, Korean, 
-Norwegian, Polish, Portuguese, Romanian, Russian, 
-Slovak, Slovene, Spanish, Swedish, and Ukrainian.
+Brazilian Portuguese, Chinese, Chinesetraditional, Croatian, Czech, 
+Danish, Dutch, English, Finnish, French, 
+German, Greek, Hungarian, Italian, Japanese, 
+Korean, Norwegian, Polish, Portuguese, Romanian, 
+Russian, Slovak, Slovene, Spanish, Swedish, 
+and Ukrainian.
 
 The table of information related to the supported languages follows.
 It is sorted by language alphabetically.  The <b>Status</b> column
@@ -62,6 +63,12 @@ when the translator was updated.
       <TD>liuwei@NOSPAM.asiainfo.com<br>wangweihan@NOSPAM.capinfo.com.cn</TD>
       <TD>1.2.13</TD>
   </TR>
+  <TR BGCOLOR="#ffffff">
+      <TD>Chinesetraditional</TD>  
+      <TD>Gary Lee</TD>
+      <TD>garylee@NOSPAM.ecosine.com.tw</TD>
+      <TD>up-to-date</TD>
+  </TR>
   <TR BGCOLOR="#ffffff">
       <TD>Croatian</TD>  
       <TD>Boris Bralo</TD>
@@ -180,7 +187,7 @@ when the translator was updated.
       <TD>Slovene</TD>  
       <TD>Matjaz Ostroversnik</TD>
       <TD>matjaz.ostroversnik@NOSPAM.zrs-tk.si</TD>
-      <TD>1.2.13</TD>
+      <TD>up-to-date</TD>
   </TR>
   <TR BGCOLOR="#ffffff">
       <TD>Spanish</TD>  
@@ -216,6 +223,8 @@ when the translator was updated.
   Chinese & Wei Liu & {\tt liuwei@asiainfo.com} & 1.2.13 \\
    & Wang Weihan & {\tt wangweihan@capinfo.com.cn} &  \\
   \hline
+  Chinesetraditional & Gary Lee & {\tt garylee@ecosine.com.tw} & up-to-date \\
+  \hline
   Croatian & Boris Bralo & {\tt boris.bralo@zg.tel.hr} & up-to-date \\
   \hline
   Czech & Petr P\v{r}ikryl & {\tt prikrylp@skil.cz} & up-to-date \\
@@ -257,7 +266,7 @@ when the translator was updated.
   \hline
   Slovak & Stanislav Kudl\'{a}\v{c} & {\tt skudlac@pobox.sk} & 1.2.13 \\
   \hline
-  Slovene & Matjaz Ostroversnik & {\tt matjaz.ostroversnik@zrs-tk.si} & 1.2.13 \\
+  Slovene & Matjaz Ostroversnik & {\tt matjaz.ostroversnik@zrs-tk.si} & up-to-date \\
   \hline
   Spanish & Francisco Oltra Thennet & {\tt foltra@puc.cl} & 1.2.7 \\
   \hline

doc/maintainers.txt

@@ -8,6 +8,9 @@ Chinese
 Wei Liu: liuwei@asiainfo.com
 Wang Weihan: wangweihan@capinfo.com.cn
 
+ChineseTraditional
+Gary Lee: garylee@ecosine.com.tw
+
 Croatian
 Boris Bralo: boris.bralo@zg.tel.hr
 

libpng/libpng.pro.in

@@ -46,6 +46,7 @@ SOURCES		= adler32.c \
 		  uncompr.c \
 		  zutil.c
 win32:INCLUDEPATH          += .
+win32-g++:TMAKE_CFLAGS     += -D__CYGWIN__ -DALL_STATIC
 DESTDIR                    =  ../lib
 TARGET                     =  png
 OBJECTS_DIR                =  ../objects

packages/rpm/doxygen.spec

 Summary: A documentation system for C/C++.
 Name: doxygen
-Version: 1.2.15_20020421
+Version: 1.2.15_20020430
 Release: 1
 Epoch: 1
 Source0: ftp://ftp.stack.nl/pub/users/dimitri/%{name}-%{version}.src.tar.gz

qtools/qtools.pro.in

@@ -74,5 +74,6 @@ win32:SOURCES +=  qfile_win32.cpp \
 INCLUDEPATH = .
 TMAKE_CXXFLAGS += -DQT_NO_CODECS -DQT_LITE_UNICODE
 win32:TMAKE_CXXFLAGS += -DQT_NODLL
+win32-g++:TMAKE_CXXFLAGS += -D_WIN32 -D__CYGWIN__ -DALL_STATIC
 OBJECTS_DIR = ../objects
 DESTDIR = ../lib

src/bufstr.h

@@ -33,7 +33,7 @@ class BufStr : public QCString
       {
         QCString::resize(size()+spareRoom);
       }
-      data()[offset++]=c;
+      QCString::data()[offset++]=c;
     }
     void addArray(const char *a,int len)
     {
@@ -41,7 +41,7 @@ class BufStr : public QCString
       {
         QCString::resize(size()+len+spareRoom);
       }
-      memcpy(data()+offset,a,len);
+      memcpy(QCString::data()+offset,a,len);
       offset+=len;
     }
     uint curPos() { return offset; }

src/code.l

@@ -24,6 +24,7 @@
 #include <assert.h>
 #include <ctype.h>
 #include <qregexp.h>
+#include <qdir.h>
 
 #include "qtbc.h"
 #include "scanner.h"
@@ -1044,10 +1045,36 @@ TYPEKW  ("bool"|"char"|"double"|"float"|"int"|"long"|"short"|"signed"|"unsigned"
 <ReadInclude>[^\n\"\>]+/(">"|"\"")  	{
 					  //FileInfo *f;
 					  bool ambig;
-                                          FileDef *fd;
+					  bool found=FALSE;
+                                          FileDef *fd=0;
 					  if ((fd=findFileDef(Doxygen::inputNameDict,yytext,ambig)) &&
 					      fd->isLinkable())
 					  {
+					    if (ambig) // multiple input files match the name
+					    {
+					      //printf("===== yes %s is ambigious\n",yytext);
+					      QCString name = convertToQCString(QDir::cleanDirPath(yytext));
+					      if (!name.isEmpty() && g_sourceFileDef)
+					      {
+					        FileName *fn = Doxygen::inputNameDict->find(name);
+						FileNameIterator fni(*fn);
+						// for each include name
+						for (fni.toFirst();!found && (fd=fni.current());++fni)
+						{
+						  // see if this source file actually includes the file
+						  found = g_sourceFileDef->isIncluded(fd->absFilePath());
+						  //printf("      include file %s found=%d\n",fd->absFilePath().data(),found);
+						}
+					      }
+					    }
+					    else // not ambiguous
+					    {
+					      found = TRUE;
+					    }
+					  }
+					  if (found)
+					  {
+					    //printf("      include file %s found=%d\n",fd->absFilePath().data(),found);
 					    g_code->writeCodeLink(fd->getReference(),fd->getOutputFileBase(),0,yytext);
 					  }
 					  else

src/commentcnv.h

+/*****************************************************************************
+ *
+ * 
+ *
+ * Copyright (C) 1997-2002 by Dimitri van Heesch.
+ *
+ * Permission to use, copy, modify, and distribute this software and its
+ * documentation under the terms of the GNU General Public License is hereby 
+ * granted. No representations are made about the suitability of this software 
+ * for any purpose. It is provided "as is" without express or implied warranty.
+ * See the GNU General Public License for more details.
+ *
+ * Documents produced by Doxygen are derivative works derived from the
+ * input used in their production; they are not affected by this license.
+ *
+ */
+
+#ifndef _COMMENTCNV_H
+#define _COMMNETCNV_H
+
+class BufStr;
+
+extern void convertCppComments(BufStr *inBuf,BufStr *outBuf);
+
+#endif
+

src/commentcnv.l

+/*****************************************************************************
+ *
+ * 
+ *
+ * Copyright (C) 1997-2002 by Dimitri van Heesch.
+ *
+ * Permission to use, copy, modify, and distribute this software and its
+ * documentation under the terms of the GNU General Public License is hereby 
+ * granted. No representations are made about the suitability of this software 
+ * for any purpose. It is provided "as is" without express or implied warranty.
+ * See the GNU General Public License for more details.
+ *
+ * Documents produced by Doxygen are derivative works derived from the
+ * input used in their production; they are not affected by this license.
+ *
+ */
+
+%{
+
+#define YY_NEVER_INTERACTIVE 1
+  
+#include <stdio.h>
+#include <stdlib.h>
+
+#include "bufstr.h"
+
+static BufStr *g_inBuf;
+static BufStr *g_outBuf;
+static int     g_inBufPos;
+
+static void replaceCommentMarker(const char *s,int len)
+{
+  const char *p=s;
+  char c;
+  // copy blanks
+  while ((c=*p) && (c==' ' || c=='\t' || c=='\n')) 
+  {
+    g_outBuf->addChar(c);
+    p++;
+  }
+  // replace start of comment marker by spaces
+  while ((c=*p) && (c=='/' || c=='!')) 
+  {
+    g_outBuf->addChar(' ');
+    p++;
+    if (*p=='<') // comment-after-item marker 
+    { 
+      g_outBuf->addChar(' '); 
+      p++; 
+    }
+    if (c=='!') // end after first !
+    {
+      break;
+    }
+  }
+  // copy comment line to output
+  g_outBuf->addArray(p,len-(p-s));
+}
+
+static inline void copyToOutput(const char *s,int len)
+{
+  g_outBuf->addArray(s,len);
+}
+
+#undef  YY_INPUT
+#define YY_INPUT(buf,result,max_size) result=yyread(buf,max_size);
+
+static int yyread(char *buf,int max_size)
+{
+  int bytesInBuf = g_inBuf->curPos()-g_inBufPos;
+  int bytesToCopy = QMIN(max_size,bytesInBuf);
+  memcpy(buf,g_inBuf->data()+g_inBufPos,bytesToCopy);
+  g_inBufPos+=bytesToCopy;
+  return bytesToCopy;
+}
+
+%}
+
+%option noyywrap
+%option nounput
+
+%x Scan
+%x SkipString
+%x SComment
+%x CComment
+%x Verbatim
+
+%%
+
+<Scan>[^\"\/\n\\]*                 { /* eat anything that is not " / or \n */ 
+                                     copyToOutput(yytext,yyleng); 
+				   }
+<Scan>"\""                         { /* start of a string */ 
+                                     copyToOutput(yytext,yyleng); 
+				     BEGIN(SkipString); 
+                                   }
+<Scan>\n                           { /* new line */ 
+                                     copyToOutput(yytext,yyleng); 
+                                   }
+<Scan>("//!"|"///").*\n/[ \t]*"//" { /* start C++ style special comment block */
+                                     copyToOutput("/*!",3); 
+				     copyToOutput(yytext+3,yyleng-3); 
+				     BEGIN(SComment); 
+                                   }
+<Scan>"//".*\n			   { /* one line C++ comment */ 
+  				     copyToOutput(yytext,yyleng); 
+				   }
+<Scan>"/*"			   { /* start of a C comment */
+                                     copyToOutput(yytext,yyleng); 
+				     BEGIN(CComment); 
+                                   }
+<Scan>"\\verbatim"		   { /* start of a verbatim block */
+                                     copyToOutput(yytext,yyleng); 
+                                     BEGIN(Verbatim);
+                                   }
+<Scan>.                            { /* any other character */
+                                     copyToOutput(yytext,yyleng); 
+                                   }
+<Verbatim>"\\endverbatim"          { /* end of verbatim block */
+                                     copyToOutput(yytext,yyleng);
+				     BEGIN(Scan);
+                                   }
+<Verbatim>[^\\\n]*		   { /* any character not a backslash or new line */
+                                     copyToOutput(yytext,yyleng); 
+                                   }
+<Verbatim>\n			   { /* new line in verbatim block */
+                                     copyToOutput(yytext,yyleng); 
+                                   }
+<Verbatim>.			   { /* any other character */
+                                     copyToOutput(yytext,yyleng); 
+                                   }
+<SkipString>\\.                    { /* escaped character in string */
+                                     copyToOutput(yytext,yyleng); 
+                                   }
+<SkipString>"\""       	           { /* end of string */ 
+                                     copyToOutput(yytext,yyleng); 
+				     BEGIN(Scan); 
+                                   }
+<SkipString>.                      { /* any other string character */ 
+                                     copyToOutput(yytext,yyleng); 
+                                   }
+<SkipString>\n                     { /* new line inside string (illegal for some compilers) */ 
+                                     copyToOutput(yytext,yyleng); 
+                                   }
+<CComment>[^*\n]*	           { /* anything that is not a '*' */ 
+                                     copyToOutput(yytext,yyleng); 
+                                   }
+<CComment>"*"+[^*/\n]*             { /* stars without slashes */
+                                     copyToOutput(yytext,yyleng); 
+                                   }
+<CComment>\n                       { /* new line in comment */
+                                     copyToOutput(yytext,yyleng); 
+                                   }
+<CComment>"*"+"/"                  { /* end of C comment */
+                                     copyToOutput(yytext,yyleng); 
+				     BEGIN(Scan); 
+                                   }
+<SComment>^[ \t]*"//".*/\n	   { /* second line of special comment */
+                                     replaceCommentMarker(yytext,yyleng); 
+                                   }
+<SComment>\n[ \t]*"//".*/\n	   { /* other line of special comment */
+                                     replaceCommentMarker(yytext,yyleng); 
+                                   }
+<SComment>\n			   { /* end of special comment */
+                                     copyToOutput(" */",3); 
+				     copyToOutput(yytext,yyleng); 
+				     BEGIN(Scan); 
+                                   }
+
+%%
+
+void convertCppComments(BufStr *inBuf,BufStr *outBuf)
+{
+  g_inBuf    = inBuf;
+  g_outBuf   = outBuf;
+  g_inBufPos = 0;
+  BEGIN(Scan);
+  yylex();
+}
+
+//----------------------------------------------------------------------------
+extern "C" { // some bogus code to keep the compiler happy
+    void commentcnvYYdummy() { yy_flex_realloc(0,0); } 
+}
+

src/config.l

@@ -1247,9 +1247,10 @@ void Config::create()
                     "documentation generated by doxygen is written. Doxygen will use this \n"
                     "information to generate all constant output in the proper language. \n"
                     "The default language is English, other supported languages are: \n"
-		    "Brazilian, Chinese, Croatian, Czech, Danish, Dutch, Finnish, French, \n"
-		    "German, Greek, Hungarian, Italian, Japanese, Korean, Norwegian, Polish, \n"
-		    "Portuguese, Romanian, Russian, Slovak, Slovene, Spanish and Swedish.\n",
+		    "Brazilian, Chinese, Chinese-Traditional, Croatian, Czech, Danish, Dutch, \n"
+		    "Finnish, French, German, Greek, Hungarian, Italian, Japanese, Korean, \n"
+		    "Norwegian, Polish, Portuguese, Romanian, Russian, Slovak, Slovene, \n"
+		    "Spanish, Swedish and Ukrainian.\n",
 		    "English"
                    );
 #ifdef LANG_BR
@@ -1258,6 +1259,9 @@ void Config::create()
 #ifdef LANG_CN
   ce->addValue("Chinese");
 #endif
+#ifdef LANG_TW
+  ce->addValue("Chinese-Traditional");
+#endif
 #ifdef LANG_HR
   ce->addValue("Croatian");
 #endif

src/defargs.l

@@ -261,16 +261,37 @@ ID	[a-z_A-Z][a-z_A-Z0-9]*
 					    //printf("g_curArgTypeName=`%s' i=%d\n",g_curArgTypeName.data(),i);
 					    Argument *a = new Argument; 
 					    a->attrib = g_curArgAttrib.copy();
-					    if (i>=0 && g_curArgTypeName.at(i)!=':')
+					    //printf("a->type=%s a->name=%s i=%d l=%d\n",
+					    //	a->type.data(),a->name.data(),i,l);
+					    a->array.resize(0);
+					    if (i==l-1 && g_curArgTypeName.at(i)==')') // function argument
+					    {
+					      int bi=g_curArgTypeName.find('(');
+					      int fi=bi-1;
+					      //printf("func arg fi=%d\n",fi);
+					      while (fi>=0 && isId(g_curArgTypeName.at(fi))) fi--;
+					      if (fi>=0)
+					      {
+					        a->type  = g_curArgTypeName.left(fi+1);
+					        a->name  = g_curArgTypeName.mid(fi+1,bi-fi-1);
+						a->array = g_curArgTypeName.right(l-bi);
+					      }
+					      else
+					      {
+						a->type = g_curArgTypeName;
+					      }
+					    }
+					    else if (i>=0 && g_curArgTypeName.at(i)!=':')
 					    { // type contains a name
 					      a->type = removeRedundantWhiteSpace(g_curArgTypeName.left(i+1));
-					      a->name = g_curArgTypeName.right(g_curArgTypeName.length()-i-1);
+					      a->name = g_curArgTypeName.right(l-i-1);
 					    }
 					    else // assume only the type was specified, try to determine name later 
 					    {
 					      a->type = removeRedundantWhiteSpace(g_curArgTypeName);  
 					    }
-					    a->array  = removeRedundantWhiteSpace(g_curArgArray);
+					    //printf("a->type=%s a->name=%s a->array=%s\n",a->type.data(),a->name.data());
+					    a->array  += removeRedundantWhiteSpace(g_curArgArray);
 					    a->defval = g_curArgDefValue.copy();
 					    a->docs   = g_curArgDocs.stripWhiteSpace();
 					    //printf("Argument `%s' `%s' adding docs=`%s'\n",a->type.data(),a->name.data(),a->docs.data());

src/dot.cpp

@@ -1470,7 +1470,7 @@ void DotInclDepGraph::buildGraph(DotNode *n,FileDef *fd,int distance)
     if (bfd)
     {
       in  = bfd->absFilePath();  
-      doc = bfd->isLinkableInProject();
+      doc = bfd->isLinkable();
       src = bfd->generateSourceFile();
     }
     if (doc || src)

src/doxygen.cpp

@@ -60,6 +60,7 @@
 #include "page.h"
 #include "packagedef.h"
 #include "bufstr.h"
+#include "commentcnv.h"
 
 #if defined(_MSC_VER) || defined(__BORLANDC__)
 #define popen _popen
@@ -1073,6 +1074,13 @@ static void findUsingDeclarations(Entry *root)
       } while (scopeOffset>=0 && usingCd==0);
 
       //printf("%s -> %p\n",root->name.data(),usingCd);
+      if (usingCd==0) // definition not in the input => add an artificial class
+      {
+        usingCd = new ClassDef(
+                     "<generated>",1,
+                     root->name,ClassDef::Class);
+        Doxygen::hiddenClasses.append(root->name,usingCd);
+      }
 
       // add the namespace the correct scope
       if (usingCd)
@@ -1758,8 +1766,6 @@ void addMethodToClass(Entry *root,ClassDef *cd,
   {
     mn = new MemberName(name);
     mn->append(md);
-    //Doxygen::memberNameDict.insert(name,mn);
-    //Doxygen::memberNameList.append(mn);
     Doxygen::memberNameSDict.append(name,mn);
   }
 
@@ -1873,9 +1879,11 @@ static void buildFunctionList(Entry *root)
             QCString nsName,rnsName;
             if (nd)  nsName  = nd->name().copy();
             if (rnd) rnsName = rnd->name().copy();
+            NamespaceList *unl = fd ? fd->getUsedNamespaces() : 0;
+            ClassList     *ucl = fd ? fd->getUsedClasses() : 0;
             //printf("matching arguments for %s\n",md->name().data());
             if ( 
-                matchArguments(md->argumentList(),root->argList,0,nsName)
+                matchArguments(md->argumentList(),root->argList,0,nsName,FALSE,unl,ucl)
                )
             {
               //printf("match!\n");
@@ -2043,8 +2051,6 @@ static void buildFunctionList(Entry *root)
           {
             mn = new MemberName(name);
             mn->append(md);
-            //Doxygen::functionNameDict.insert(name,mn);
-            //Doxygen::functionNameList.append(mn);
             Doxygen::functionNameSDict.append(name,mn);
           }
           addMemberToGroups(root,md);
@@ -3139,7 +3145,9 @@ static void computeClassRelations()
     if ((cd==0 || (!cd->hasDocumentation() && !cd->isReference())) && 
         bName.right(2)!="::")
     {
-      if (!root->name.isEmpty() && root->name[0]!='@')
+      if (!root->name.isEmpty() && root->name[0]!='@' &&
+          (guessSection(root->fileName)==Entry::HEADER_SEC || Config_getBool("EXTRACT_LOCAL_CLASSES"))
+         )
         warn_undoc(
                    root->fileName,root->startLine,
                    "Warning: Compound %s is not documented.",
@@ -3572,6 +3580,7 @@ static bool findGlobalMember(Entry *root,
       FileDef *fd=findFileDef(Doxygen::inputNameDict,root->fileName,ambig);
       //printf("File %s\n",fd ? fd->name().data() : "<none>");
       NamespaceList *nl = fd ? fd->getUsedNamespaces() : 0;
+      ClassList *cl     = fd ? fd->getUsedClasses()    : 0;
       //printf("NamespaceList %p\n",nl);
 
       // search in the list of namespaces that are imported via a 
@@ -3589,7 +3598,7 @@ static bool findGlobalMember(Entry *root,
         bool matching=
           (md->argumentList()==0 && root->argList->count()==0) ||
           md->isVariable() || md->isTypedef() || /* in case of function pointers */
-          matchArguments(md->argumentList(),root->argList,0,nsName);
+          matchArguments(md->argumentList(),root->argList,0,nsName,FALSE,nl,cl);
 
         // for static members we also check if the comment block was found in 
         // the same file. This is needed because static members with the same
@@ -6280,26 +6289,31 @@ static void readFiles(BufStr &output)
 
     int fileNameSize=fileName.length();
 
+    BufStr tempBuf(10000);
+
     // add begin filename marker
-    output.addChar(0x06);
+    tempBuf.addChar(0x06);
     // copy filename
-    output.addArray(fileName.data(),fileNameSize);
+    tempBuf.addArray(fileName.data(),fileNameSize);
     
     // add end filename marker
-    output.addChar(0x06);
-    output.addChar('\n');
+    tempBuf.addChar(0x06);
+    tempBuf.addChar('\n');
     if (Config_getBool("ENABLE_PREPROCESSING"))
     {
       msg("Preprocessing %s...\n",s->data());
-      preprocessFile(fileName,output);
+      preprocessFile(fileName,tempBuf);
     }
     else
     {
       msg("Reading %s...\n",s->data());
-      copyAndFilterFile(fileName,output);
+      copyAndFilterFile(fileName,tempBuf);
     }
 
-    output.addChar('\n'); /* to prevent problems under Windows ? */
+    tempBuf.addChar('\n'); /* to prevent problems under Windows ? */
+
+    convertCppComments(&tempBuf,&output);
+    //output.addArray(tempBuf.data(),tempBuf.curPos());
 
     s=inputFiles.next();
     //printf("-------> adding new line\n");
@@ -6989,6 +7003,10 @@ void parseInput()
     s=excludeList.next();
   }
 
+  /**************************************************************************
+   *             Determine Input Files                                      *
+   **************************************************************************/
+
   msg("Reading input files...\n");
   QDict<void> *killDict = new QDict<void>(10007);
   int inputSize=0;
@@ -7079,6 +7097,25 @@ void parseInput()
     }
     s=aliasList.next();
   }
+
+  /**************************************************************************
+   *             Handle Tag Files                                           *
+   **************************************************************************/
+
+  Entry *root=new Entry;
+  msg("Reading tag files\n");
+  
+  QStrList &tagFileList = Config_getList("TAGFILES");
+  s=tagFileList.first();
+  while (s)
+  {
+    readTagFile(root,s);
+    s=tagFileList.next();
+  }
+  
+  /**************************************************************************
+   *             Read Input Files                                           *
+   **************************************************************************/
   
   BufStr input(inputSize+1); // Add one byte extra for \0 termination
 
@@ -7201,25 +7238,8 @@ void parseInput()
     readFormulaRepository();
   }
   
-  Entry *root=new Entry;
   root->program=input;
 
-
-  /**************************************************************************
-   *             Handle Tag Files                                           *
-   **************************************************************************/
-
-  msg("Reading tag files\n");
-  
-  QStrList &tagFileList = Config_getList("TAGFILES");
-  s=tagFileList.first();
-  while (s)
-  {
-    readTagFile(root,s);
-    s=tagFileList.next();
-  }
-  
-  
   /**************************************************************************
    *             Gather information                                         * 
    **************************************************************************/

src/doxygen.pro.in

@@ -26,6 +26,7 @@ win32-msvc:TMAKE_LFLAGS    += /LIBPATH:..\lib
 win32-borland:LIBS         += qtools.lib png.lib doxygen.lib doxycfg.lib shell32.lib 
 win32-borland:TMAKE_LFLAGS += -L..\lib -L$(BCB)\lib\psdk
 win32:TMAKE_CXXFLAGS       += -DQT_NODLL
+win32-g++:TMAKE_CXXFLAGS   += -D_WIN32 -D__CYGWIN__ -DALL_STATIC
 INCLUDEPATH                += ../qtools ../libpng .
 DESTDIR                    =  ../bin
 TARGET                     =  doxygen

src/doxytag.pro.in

@@ -27,6 +27,7 @@ win32-msvc:TMAKE_LFLAGS    += /LIBPATH:..\lib
 win32-borland:LIBS         += qtools.lib shell32.lib
 win32-borland:TMAKE_LFLAGS += -L..\lib -L$(BCB)\lib\psdk
 win32:TMAKE_CXXFLAGS       += -DQT_NODLL
+win32-g++:TMAKE_CXXFLAGS   += -D_WIN32
 INCLUDEPATH                += ../qtools
 OBJECTS_DIR                =  ../objects
 TARGET                     =  ../bin/doxytag

src/filedef.cpp

@@ -126,7 +126,9 @@ void FileDef::writeDocumentation(OutputList &ol)
     Doxygen::tagFile << "  <compound kind=\"file\">" << endl;
     Doxygen::tagFile << "    <name>" << convertToXML(name()) << "</name>" << endl;
     Doxygen::tagFile << "    <path>" << convertToXML(getPath()) << "</path>" << endl;
-    Doxygen::tagFile << "    <filename>" << convertToXML(getOutputFileBase()) << htmlFileExtension << "</filename>" << endl;
+    Doxygen::tagFile << "    <filename>" 
+                     << convertToXML(getOutputFileBase()) 
+                     << "</filename>" << endl;
   }
   
   ol.startTextBlock();
@@ -186,9 +188,21 @@ void FileDef::writeDocumentation(OutputList &ol)
       // Here we use the include file name as it appears in the file.
       // we could also we the name as it is used within doxygen,
       // then we should have used fd->docName() instead of ii->includeName
-      if (fd && fd->isLinkable() && fd->generateSourceFile())
+      if (fd && fd->isLinkable())
       {
-        ol.writeObjectLink(fd->getReference(),fd->includeName(),0,ii->includeName);
+        ol.writeObjectLink(fd->getReference(),
+            fd->generateSourceFile() ? fd->includeName() : fd->getOutputFileBase(),
+            0,ii->includeName);
+        if (!Config_getString("GENERATE_TAGFILE").isEmpty() && !fd->isReference()) 
+        {
+          const char *locStr = (ii->local || isIDLorJava) ? "yes" : "no";
+          Doxygen::tagFile << "    <includes id=\"" 
+                           << convertToXML(fd->getOutputFileBase()) 
+                           << "\" local=\"" << locStr << "\">" 
+                           << convertToXML(ii->includeName)
+                           << "</includes>" 
+                           << endl;
+        }
       }
       else
       {
@@ -623,6 +637,12 @@ void FileDef::addIncludedByDependency(FileDef *fd,const char *incName,bool local
   }
 }
 
+bool FileDef::isIncluded(const QCString &name) const
+{
+  if (name.isEmpty()) return FALSE;
+  return includeDict->find(name)!=0;
+}
+
 bool FileDef::generateSourceFile() const 
 { 
   QCString extension = name().right(4);

src/filedef.h

@@ -117,6 +117,7 @@ class FileDef : public Definition
     {
       return isLinkableInProject() || isReference();
     }
+    bool isIncluded(const QCString &name) const;
 
     void writeDocumentation(OutputList &ol);
     void writeSource(OutputList &ol);

src/htmlhelp.cpp

@@ -26,6 +26,7 @@
 #include "htmlhelp.h"
 #include "config.h"
 #include "message.h"
+#include "doxygen.h"
 
 //----------------------------------------------------------------------------
 
@@ -176,7 +177,7 @@ void HtmlHelpIndex::writeFields(QTextStream &t)
       if (level2.isEmpty())
       {
         t << "  <LI><OBJECT type=\"text/sitemap\">";
-        t << "<param name=\"Local\" value=\"" << f->url << ".html";
+        t << "<param name=\"Local\" value=\"" << f->url << htmlFileExtension;
         if (!f->anchor.isEmpty()) t << "#" << f->anchor;  
         t << "\">";
         t << "<param name=\"Name\" value=\"" << level1 << "\">"
@@ -187,7 +188,7 @@ void HtmlHelpIndex::writeFields(QTextStream &t)
         if (f->link)
         {
           t << "  <LI><OBJECT type=\"text/sitemap\">";
-          t << "<param name=\"Local\" value=\"" << f->url << ".html\">";
+          t << "<param name=\"Local\" value=\"" << f->url << htmlFileExtension << "\">";
           t << "<param name=\"Name\" value=\"" << level1 << "\">"
                "</OBJECT>\n";
         }
@@ -213,7 +214,7 @@ void HtmlHelpIndex::writeFields(QTextStream &t)
     if (level2Started)
     {
       t << "    <LI><OBJECT type=\"text/sitemap\">";
-      t << "<param name=\"Local\" value=\"" << f->url << ".html";
+      t << "<param name=\"Local\" value=\"" << f->url << htmlFileExtension;
       if (!f->anchor.isEmpty()) t << "#" << f->anchor;  
       t << "\">";
       t << "<param name=\"Name\" value=\"" << level2 << "\">"
@@ -307,8 +308,8 @@ void HtmlHelp::createProjectFile()
     t.setEncoding(QTextStream::Latin1);
 #endif
 
-    QCString indexName="index.html";
-    if (Config_getBool("GENERATE_TREEVIEW")) indexName="main.html";
+    QCString indexName="index"+htmlFileExtension;
+    if (Config_getBool("GENERATE_TREEVIEW")) indexName="main"+htmlFileExtension;
     t << "[OPTIONS]\n"
          "Compatibility=1.1\n"
          "Full-text search=Yes\n"
@@ -417,7 +418,7 @@ void HtmlHelp::addContentsItem(bool isDir,
   cts << "<param name=\"Name\" value=\"" << name << "\">";
   if (ref)      // made ref optional param - KPW
   {
-    cts << "<param name=\"Local\" value=\"" << ref << ".html";
+    cts << "<param name=\"Local\" value=\"" << ref << htmlFileExtension;
     if (anchor) cts << "#" << anchor;  
     cts << "\">";
   }

src/instdox.cpp

@@ -117,7 +117,7 @@ void writeInstallScript()
     t << "if ( ! @files ) {\n";
     t << "  if (opendir(D,\".\")) {\n";
     t << "    foreach $file ( readdir(D) ) {\n";
-    t << "      $match = \".html\";\n";
+    t << "      $match = \"" << Config_getString("HTML_FILE_EXTENSION") << "\";\n";
     t << "      next if ( $file =~ /^\\.\\.?$/ );\n";
     t << "      ($file =~ /$match/) && (push @files, $file);\n";
     t << "      ($file =~ \"tree.js\") && (push @files, $file);\n";

src/lang_cfg.h

@@ -22,3 +22,4 @@
 #define LANG_SK
 #define LANG_UA
 #define LANG_GR
+#define LANG_TW

src/language.cpp

@@ -76,6 +76,9 @@
 #ifdef LANG_CN
 #include "translator_cn.h"
 #endif
+#ifdef LANG_TW
+#include "translator_tw.h"
+#endif
 #ifdef LANG_NO
 #include "translator_no.h"
 #endif
@@ -218,6 +221,12 @@ bool setTranslator(const char *langName)
     theTranslator=new TranslatorChinese;
   }
 #endif
+#ifdef LANG_TW
+  else if (L_EQUAL("chinese-traditional"))
+  {
+    theTranslator=new TranslatorChinesetraditional;
+  }
+#endif
 #ifdef LANG_NO
   else if (L_EQUAL("norwegian"))
   {

src/latexgen.cpp

@@ -1393,7 +1393,8 @@ void LatexGenerator::docify(const char *str)
   static bool isKorean        = theTranslator->idLanguage()=="korean";
   static bool isRussian       = theTranslator->idLanguage()=="russian";
   static bool isUkrainian     = theTranslator->idLanguage()=="ukrainian";
-  static bool isChinese       = theTranslator->idLanguage()=="chinese";
+  static bool isChinese       = theTranslator->idLanguage()=="chinese" || 
+                                theTranslator->idLanguage()=="chinese-traditional";
   static bool isLatin2        = theTranslator->idLanguageCharset()=="iso-8859-2";
   static bool isGreek         = theTranslator->idLanguage()=="greek";
   if (str)

src/libdoxycfg.pro.in

@@ -19,6 +19,7 @@ CONFIG       =	console warn_on staticlib $extraopts
 HEADERS      =  config.h	
 SOURCES      =	config.cpp 
 win32:TMAKE_CXXFLAGS       += -DQT_NODLL
+win32-g++:TMAKE_CXXFLAGS   += -D_WIN32 -D__CYGWIN__ -DALL_STATIC
 INCLUDEPATH                += ../qtools
 win32:INCLUDEPATH          += .
 DESTDIR                    =  ../lib

src/libdoxygen.pro.in

@@ -20,6 +20,7 @@ HEADERS      =	bufstr.h \
                 classdef.h \
                 classlist.h \
                 code.h \
+		commentcnv.h \
 		constexp.h \
 		cppvalue.h \
 		debug.h \
@@ -100,6 +101,7 @@ SOURCES      =	ce_lex.cpp \
 		classdef.cpp \
 		classlist.cpp \
 		code.cpp \
+		commentcnv.cpp \
 		cppvalue.cpp \
 		debug.cpp \
                 defgen.cpp \
@@ -150,6 +152,7 @@ SOURCES      =	ce_lex.cpp \
 
 win32:TMAKE_CXXFLAGS       += -DQT_NODLL 
 win32-msvc:TMAKE_CXXFLAGS  += -Zm200
+win32-g++:TMAKE_CXXFLAGS   += -D_WIN32 -D__CYGWIN__ -DALL_STATIC
 INCLUDEPATH                += ../qtools
 INCLUDEPATH                += ../libpng
 win32:INCLUDEPATH          += .

src/libdoxygen.t

@@ -62,6 +62,9 @@ sub GenerateDep {
 #$ GenerateDep("doc.cpp","doc.l");
 	$(LEX) -PdocYY -t doc.l >doc.cpp
 
+#$ GenerateDep("commentcnv.cpp","commentcnv.l");
+	$(LEX) -PcommentcnvYY -t commentcnv.l >commentcnv.cpp
+
 #$ GenerateDep("ce_lex.cpp","constexp.l","ce_parse.h");
 	$(LEX) -PcppExpYY -t constexp.l >ce_lex.cpp 
 

src/rtfgen.cpp

@@ -37,6 +37,9 @@
 //#define DBG_RTF(x) x;
 #define DBG_RTF(x)
 
+// used for table column width calculation
+#define PAGEWIDTH 8748
+
 const int indentLevels = 10;
 
 struct ListItemInfo
@@ -121,6 +124,7 @@ void RTFGenerator::append(const OutputGenerator *g)
   //insideTabbing=insideTabbing || ((RTFGenerator *)g)->insideTabbing;
   m_listLevel=((RTFGenerator *)g)->m_listLevel;
   m_omitParagraph=((RTFGenerator *)g)->m_omitParagraph;
+  m_columnNumbers=((RTFGenerator *)g)->m_columnNumbers;
   //printf("RTFGenerator::append(%s) insideTabbing=%s\n", g->getContents().data(),
   //    insideTabbing ? "TRUE" : "FALSE" );
 }
@@ -1641,6 +1645,59 @@ void RTFGenerator::endSubsubsection()
 //  t << "}";
 //}
 
+void RTFGenerator::startTable(bool,int colNumbers) 
+{
+  m_columnNumbers=colNumbers;
+  t<<"\\par\n";
+}
+
+void RTFGenerator::endTable(bool hasCaption) 
+{ 
+  if (!hasCaption) 
+    t << "\n\\pard \\widctlpar\\intbl\\adjustright\n{\\row }\n"; 
+  t << "\\pard\n" << endl; 
+}
+
+void  RTFGenerator::startCaption() 
+{
+  endTableRow();
+  t<<"\\trowd \\trgaph108\\trleft-108\\trbrdrt\\brdrs\\brdrw10 \\trbrdrl\\brdrs\\brdrw10 \\trbrdrb\\brdrs\\brdrw10 \\trbrdrr\\brdrs\\brdrw10 \\trbrdrh\\brdrs\\brdrw10 \\trbrdrv\\brdrs\\brdrw10"<<endl;
+  t<<"\\clvertalt\\clbrdrt\\brdrs\\brdrw10 \\clbrdrl\\brdrs\\brdrw10 \\clbrdrb\\brdrs\\brdrw10 \\clbrdrr \\brdrs\\brdrw10 \\cltxlrtb \\cellx"<<PAGEWIDTH<<"\\pard \\qc\\nowidctlpar\\widctlpar\\intbl\\adjustright "<<endl;
+  nextTableColumn();
+}
+
+void  RTFGenerator::endCaption() 
+{
+  endTableColumn();
+  endTableRow();
+}
+
+void RTFGenerator::nextTableRow() 
+{  
+  unsigned long columnWidth=PAGEWIDTH/m_columnNumbers;
+  t<<"\\trowd \\trgaph108\\trleft-108\\trbrdrt\\brdrs\\brdrw10 \\trbrdrl\\brdrs\\brdrw10 \\trbrdrb\\brdrs\\brdrw10 \\trbrdrr\\brdrs\\brdrw10 \\trbrdrh\\brdrs\\brdrw10 \\trbrdrv\\brdrs\\brdrw10 "<<endl;
+  for (int i=1;i<=m_columnNumbers;i++) 
+  {
+    t<<"\\clvertalt\\clbrdrt\\brdrs\\brdrw10 \\clbrdrl\\brdrs\\brdrw10 \\clbrdrb\\brdrs\\brdrw10 \\clbrdrr \\brdrs\\brdrw10 \\cltxlrtb \\cellx"<<i*columnWidth<<endl;
+  }
+  t<<"\\pard \\widctlpar\\intbl\\adjustright\n{";
+}
+ 
+void RTFGenerator::endTableRow() 
+{ 
+  t<<"\n\\pard \\widctlpar\\intbl\\adjustright\n{\\row }\n";
+}
+ 
+void RTFGenerator::nextTableColumn() 
+{
+  t<<"{ ";
+}
+
+void RTFGenerator::endTableColumn() 
+{ 
+  t<<" \\cell }";
+}
+
 void RTFGenerator::startTextLink(const char *f,const char *anchor)
 {
   if (Config_getBool("RTF_HYPERLINKS"))

src/rtfgen.h

@@ -154,14 +154,14 @@ class RTFGenerator : public OutputGenerator
     void endSubscript()     { t << "}"; }
     void startSuperscript() { t << "{\\super " << endl;}
     void endSuperscript()   { t << "}"; }
-    void startTable(bool,int)   { /* not implemented */ }
-    void endTable(bool)         { /* not implemented */ }
-    void startCaption()     { /* not implemented */ }
-    void endCaption()       { /* not implemented */ }
-    void nextTableRow()     { /* not implemented */ }
-    void endTableRow()      { /* not implemented */ }
-    void nextTableColumn()  { /* not implemented */ }
-    void endTableColumn()   { /* not implemented */ }
+    void startTable(bool,int);
+    void endTable(bool);
+    void startCaption();
+    void endCaption();
+    void nextTableRow();
+    void endTableRow();
+    void nextTableColumn();
+    void endTableColumn();
     void writeCopyright()    { t << "\251"; }
     void writeQuote()        { t << "\""; }
     void writeUmlaut(char c);
@@ -268,6 +268,7 @@ class RTFGenerator : public OutputGenerator
     bool m_bstartedBody;  // has startbody been called yet?
     int  m_listLevel; // // RTF does not really have a addative indent...manually set list level.
     bool m_omitParagraph; // should a the next paragraph command be ignored?
+    int  m_columnNumbers; // number of columns in a table
 
     void beginRTFDocument();
     void beginRTFChapter();

src/scanner.l

@@ -3770,10 +3770,12 @@ CHARLIT   (("'"\\[0-7]{1,3}"'")|("'"\\."'")|("'"[^'\\\n]{1,4}"'"))
   					}
 <SkipSection>"//"|"*/"			  					
 <ClassDoc,Doc,JavaDoc,AfterDoc,PageDoc,ExampleDoc>{CMD}"elseif"/[^a-z_A-Z0-9] {
-                                          // previous section enabled => absorb else
+                                          // previous section enabled => skip now
+  					  depthIf=1;
+  					  BEGIN(SkipSection);
   					}
 <ClassDoc,Doc,JavaDoc,AfterDoc,PageDoc,ExampleDoc>{CMD}"else"/[^a-z_A-Z0-9] {
-                                          // section was enable => skip now
+                                          // section was enabled => skip now
   					  depthIf=1;
   					  BEGIN(SkipSection);
   					}

src/tagreader.cpp

@@ -91,11 +91,19 @@ class TagPackageInfo
     QStringList classList;
 };
 
+class TagIncludeInfo
+{
+  public:
+    QString id;
+    QString name;
+    bool isLocal;
+};
+
 /*! Container for file specific info that can be read from a tagfile */
 class TagFileInfo
 {
   public:
-    TagFileInfo() { members.setAutoDelete(TRUE); }
+    TagFileInfo() { members.setAutoDelete(TRUE); includes.setAutoDelete(TRUE); }
     QString name;
     QString path;
     QString filename;
@@ -103,6 +111,7 @@ class TagFileInfo
     QList<TagMemberInfo> members;
     QStringList classList;
     QStringList namespaceList;
+    QList<TagIncludeInfo> includes;
 };
 
 /*! Container for group specific info that can be read from a tagfile */
@@ -431,6 +440,25 @@ class TagFileParser : public QXmlDefaultHandler
         err("Error: Unexpected tag `base' found\n");
       }
     }
+    void startIncludes(const QXmlAttributes& attrib )
+    {
+      if (m_state==InFile && m_curFile)
+      {
+        m_curIncludes = new TagIncludeInfo;
+        m_curIncludes->id = attrib.value("id");
+        m_curIncludes->isLocal = attrib.value("local")=="yes" ? TRUE : FALSE;
+        m_curFile->includes.append(m_curIncludes);
+      }
+      else
+      {
+        err("Error: Unexpected tag `includes' found\n");
+      }
+      m_curString="";
+    }
+    void endIncludes()
+    {
+      m_curIncludes->name = m_curString;
+    }
     void endTemplateArg()
     {
       if (m_state==InClass && m_curClass)
@@ -541,6 +569,7 @@ class TagFileParser : public QXmlDefaultHandler
       m_startElementHandlers.insert("name",        new StartElementHandler(this,&TagFileParser::startStringValue));
       m_startElementHandlers.insert("base",        new StartElementHandler(this,&TagFileParser::startBase));
       m_startElementHandlers.insert("filename",    new StartElementHandler(this,&TagFileParser::startStringValue));
+      m_startElementHandlers.insert("includes",    new StartElementHandler(this,&TagFileParser::startIncludes));
       m_startElementHandlers.insert("path",        new StartElementHandler(this,&TagFileParser::startStringValue));
       m_startElementHandlers.insert("anchor",      new StartElementHandler(this,&TagFileParser::startStringValue));
       m_startElementHandlers.insert("arglist",     new StartElementHandler(this,&TagFileParser::startStringValue));
@@ -560,6 +589,7 @@ class TagFileParser : public QXmlDefaultHandler
       m_endElementHandlers.insert("name",        new EndElementHandler(this,&TagFileParser::endName));
       m_endElementHandlers.insert("base",        new EndElementHandler(this,&TagFileParser::endBase));
       m_endElementHandlers.insert("filename",    new EndElementHandler(this,&TagFileParser::endFilename));
+      m_endElementHandlers.insert("includes",    new EndElementHandler(this,&TagFileParser::endIncludes));
       m_endElementHandlers.insert("path",        new EndElementHandler(this,&TagFileParser::endPath));
       m_endElementHandlers.insert("anchor",      new EndElementHandler(this,&TagFileParser::endAnchor));
       m_endElementHandlers.insert("arglist",     new EndElementHandler(this,&TagFileParser::endArglist));
@@ -612,6 +642,7 @@ class TagFileParser : public QXmlDefaultHandler
     }
     void dump();
     void buildLists(Entry *root);
+    void addIncludes();
     
   private:
     void buildMemberList(Entry *ce,QList<TagMemberInfo> &members);
@@ -631,6 +662,7 @@ class TagFileParser : public QXmlDefaultHandler
     TagGroupInfo              *m_curGroup;
     TagPageInfo               *m_curPage;
     TagMemberInfo             *m_curMember;
+    TagIncludeInfo            *m_curIncludes;
     QCString                   m_curString;
     QString                    m_tagName;
     State                      m_state;
@@ -752,6 +784,13 @@ void TagFileParser::dump()
       msg("    anchor: `%s'\n",md->anchor.data());
       msg("    arglist: `%s'\n",md->arglist.data());
     }
+
+    QListIterator<TagIncludeInfo> mii(fd->includes);
+    TagIncludeInfo *ii;
+    for (;(ii=mii.current());++mii)
+    {
+      msg("  includes id: %s name: %s\n",ii->id.data(),ii->name.data());
+    }
   }
 
   //============== GROUPS
@@ -1113,6 +1152,44 @@ void TagFileParser::buildLists(Entry *root)
   }
 }
 
+void TagFileParser::addIncludes()
+{
+  TagFileInfo *tfi = m_tagFileFiles.first();
+  while (tfi)
+  {
+    FileName *fn = Doxygen::inputNameDict->find(tfi->name);
+    if (fn)
+    {
+      FileNameIterator fni(*fn);
+      FileDef *fd;
+      for (;(fd=fni.current());++fni)
+      {
+        if (fd->getPath()==QCString(m_tagName+":"+tfi->path))
+        {
+          QListIterator<TagIncludeInfo> mii(tfi->includes);
+          TagIncludeInfo *ii;
+          for (;(ii=mii.current());++mii)
+          {
+            FileName *ifn = Doxygen::inputNameDict->find(ii->name);
+            FileNameIterator ifni(*ifn);
+            FileDef *ifd;
+            for (;(ifd=ifni.current());++ifni)
+            {
+              printf("ifd->getOutputFileBase()=%s ii->id=%s\n",
+                      ifd->getOutputFileBase().data(),ii->id.data());
+              if (ifd->getOutputFileBase()==QCString(ii->id))
+              {
+                fd->addIncludeDependency(ifd,ii->name,ii->isLocal);
+              }
+            }
+          }
+        }
+      } 
+    }
+    tfi = m_tagFileFiles.next();
+  }
+}
+
 void parseTagFile(Entry *root,const char *fullName,const char *tagName)
 {
   QFileInfo fi(fullName);
@@ -1126,5 +1203,6 @@ void parseTagFile(Entry *root,const char *fullName,const char *tagName)
   reader.setErrorHandler( &errorHandler );
   reader.parse( source );
   handler.buildLists(root);
+  handler.addIncludes();
 }
 

src/translator_jp.h

 /******************************************************************************
-*
-*
-*
-* Copyright (C) 1997-2000 by Dimitri van Heesch.
-*
-* Permission to use, copy, modify, and distribute this software and its
-* documentation under the terms of the GNU General Public License is hereby
-* granted. No representations are made about the suitability of this 
-software
-* for any purpose. It is provided "as is" without express or implied 
-warranty.
-* See the GNU General Public License for more details.
-*
-* Documents produced by Doxygen are derivative works derived from the
-* input used in their production; they are not affected by this license.
-*
-*/
+ *
+ *
+ *
+ * Copyright (C) 1997-2000 by Dimitri van Heesch.
+ *
+ * Permission to use, copy, modify, and distribute this software and its
+ * documentation under the terms of the GNU General Public License is hereby
+ * granted. No representations are made about the suitability of this software
+ * for any purpose. It is provided "as is" without express or implied warranty.
+ * See the GNU General Public License for more details.
+ *
+ * Documents produced by Doxygen are derivative works derived from the
+ * input used in their production; they are not affected by this license.
+ *
+ */
 
 /*
-* translator_jp.h
-*
-* 1.2.5)
-* First Translation
-*      by Kenji Nagamatsu
-* 1.2.12)
-* Update and Shift-Jis(_WIN32)
-*      by Ryunosuke Sato (30-Dec-2001)
-*/
+ * translator_jp.h
+ *
+ * 1.2.5)
+ * First Translation
+ *      by Kenji Nagamatsu
+ * 1.2.12)
+ * Update and Shift-Jis(_WIN32)
+ *      by Ryunosuke Sato (30-Dec-2001)
+ */
 
 #ifndef TRANSLATOR_JP_H
 #define TRANSLATOR_JP_H
 
 class TranslatorJapanese : public Translator
 {
-private:
+ private:
   /*! The decode() can change euc into sjis */
   inline QCString decode(const QCString & sInput)
     {
@@ -48,7 +46,7 @@ private:
     { return "japanese"; }
     virtual QCString latexLanguageSupportCommand()
       {
-    return "";
+	return "";
       }
     /*! returns the name of the package that is included by LaTeX */
     virtual QCString idLanguageCharset()
@@ -60,8 +58,7 @@ private:
 #endif
     }
 
-    /*! used in the compound documentation before a list of related 
-functions. */
+    /*! used in the compound documentation before a list of related functions. */
     virtual QCString trRelatedFunctions()
     { return decode("関連する関数"); }
 
@@ -69,18 +66,17 @@ functions. */
     virtual QCString trRelatedSubscript()
     { return decode("（これらはメンバ関数でないことに注意）"); }
 
-    /*! header that is put before the detailed description of files, classes 
-and namespaces. */
+    /*! header that is put before the detailed description of files, classes and namespaces. */
     virtual QCString trDetailedDescription()
     { return decode("解説"); }
 
     /*! header that is put before the list of typedefs. */
     virtual QCString trMemberTypedefDocumentation()
-      { return decode("Typedefメンバの解説"); }
+    { return decode("Typedef メンバの解説"); }
 
     /*! header that is put before the list of enumerations. */
     virtual QCString trMemberEnumerationDocumentation()
-    { return decode("Enumメンバの解説"); }
+    { return decode("Enum メンバの解説"); }
 
     /*! header that is put before the list of member functions. */
     virtual QCString trMemberFunctionDocumentation()
@@ -90,13 +86,13 @@ and namespaces. */
     virtual QCString trMemberDataDocumentation()
     {
       if( Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
-    {
-      return decode("構造体の解説");
-    }
+	{
+	  return decode("構造体の解説");
+	}
       else
-    {
-      return decode("メンバの解説");
-    }
+	{
+	  return decode("メンバの解説");
+	}
     }
 
     /*! this is the text of a link put after brief descriptions. */
@@ -105,20 +101,19 @@ and namespaces. */
 
     /*! put in the class documentation */
     virtual QCString trListOfAllMembers()
-    { return decode("メンバ一覧"); }
+    { return decode("すべてのメンバ一覧"); }
 
     /*! used as the title of the "list of all members" page of a class */
     virtual QCString trMemberList()
     { return decode("メンバ一覧"); }
 
-    /*! this is the first part of a sentence that is followed by a class 
-name */
+    /*! this is the first part of a sentence that is followed by a class name */
     virtual QCString trThisIsTheListOfAllMembers()
-    { return decode("これはメンバの一覧です。"); }
+    { return decode("これは全メンバの一覧です。"); }
 
     /*! this is the remainder of the sentence after the class name */
     virtual QCString trIncludingInheritedMembers()
-    { return decode("継承メンバもすべて含んでいます。"); }
+    { return decode("継承メンバも含んでいます。"); }
 
     /*! this is put at the author sections at the bottom of man pages.
      *  parameter s is name of the project name.
@@ -126,7 +121,7 @@ name */
     virtual QCString trGeneratedAutomatically(const char *s)
     { QCString result;
       if (s) result=(QCString)s+decode("の");
-      result+=decode("ソースから Doxygen が生成しました。");
+      result+=decode("ソースから Doxygen により生成しました。");
       return result;
     }
 
@@ -136,7 +131,7 @@ name */
 
     /*! put after an enum value in the list of all members */
     virtual QCString trEnumValue()
-    { return decode("Enum値"); }
+    { return decode("Enum 値"); }
 
     /*! put after an undocumented member in the list of all members */
     virtual QCString trDefinedIn()
@@ -154,55 +149,51 @@ name */
     virtual QCString trClassHierarchy()
     { return decode("クラス階層"); }
 
-    /*! This is put above each page as a link to the list of annotated 
-classes */
+    /*! This is put above each page as a link to the list of annotated classes */
     virtual QCString trCompoundList()
     {
       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
-    {
-      return decode("データ構造");
-    }
+	{
+	  return decode("データ構造");
+	}
       else
-    {
-      return decode("構成");
-    }
+	{
+	  return decode("構成");
+	}
     }
 
-    /*! This is put above each page as a link to the list of documented 
-files */
+    /*! This is put above each page as a link to the list of documented files */
     virtual QCString trFileList()
     { return decode("ファイル一覧"); }
 
-    /*! This is put above each page as a link to the list of all verbatim 
-headers */
+    /*! This is put above each page as a link to the list of all verbatim headers */
     virtual QCString trHeaderFiles()
     { return decode("ヘッダファイル"); }
 
-    /*! This is put above each page as a link to all members of compounds. 
-*/
+    /*! This is put above each page as a link to all members of compounds. */
     virtual QCString trCompoundMembers()
     {
       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
-    {
-      return decode("データフィールド");
-    }
+	{
+	  return decode("データフィールド");
+	}
       else
-    {
-      return decode("構成メンバ");
-    }
+	{
+	  return decode("構成メンバ");
+	}
     }
 
     /*! This is put above each page as a link to all members of files. */
     virtual QCString trFileMembers()
     {
       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
-    {
-      return decode("グローバル");
-    }
+	{
+	  return decode("グローバル");
+	}
       else
-    {
-      return decode("ファイルメンバ");
-    }
+	{
+	  return decode("ファイルメンバ");
+	}
     }
     /*! This is put above each page as a link to all related pages. */
     virtual QCString trRelatedPages()
@@ -234,13 +225,13 @@ headers */
     virtual QCString trCompoundListDescription()
     {
       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
-    {
-      return decode("データ構造の解説です。");
-    }
+	{
+	  return decode("データ構造の解説です。");
+	}
       else
-    {
-      return decode("クラス、構造体、共用体、インタフェースの解説です。");
-    }
+	{
+	  return decode("クラス、構造体、共用体、インタフェースの解説です。");
+	}
     }
 
     /*! This is an introduction to the page with all class members. */
@@ -248,15 +239,15 @@ headers */
     {
       QCString result=decode("これは");
       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
-    {
-      result+=decode("フィールドの一覧でそれぞれ");
-      if (extractAll) result+=decode("が属している構造体/共用体");
-    }
+	{
+	  result+=decode("フィールドの一覧でそれぞれ");
+	  if (extractAll) result+=decode("が属している構造体/共用体");
+	}
       else
-    {
-      result+=decode("クラスメンバの一覧で、それぞれ");
-      if (extractAll) result+=decode("が属しているクラス");
-    }
+	{
+	  result+=decode("クラスメンバの一覧で、それぞれ");
+	  if (extractAll) result+=decode("が属しているクラス");
+	}
       result+=decode("の解説へリンクしています。");
       return result;
     }
@@ -266,20 +257,18 @@ headers */
     {
       QCString result=decode("これは");
       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
-    {
-      result+=decode("関数、変数、マクロ、Typedef定義、Enum定義の");
-    }
+	{
+	  result+=decode("関数、変数、マクロ、列挙型、型定義の");
+	}
       else
-    {
-      result+=decode("ファイルメンバの");
-    }
-      
-result+=decode("一覧です。それぞれが属しているファイルの解説へリンクしています。");
+	{
+	  result+=decode("ファイルメンバの");
+	}
+      result+=decode("一覧です。それぞれが属しているファイルの解説へリンクしています。");
       return result;
     }
 
-    /*! This is an introduction to the page with the list of all header 
-files. */
+    /*! This is an introduction to the page with the list of all header files. */
     virtual QCString trHeaderFilesDescription()
     { return decode("APIを構成するヘッダファイルです。"); }
 
@@ -287,13 +276,11 @@ files. */
     virtual QCString trExamplesDescription()
     { return decode("すべての例の一覧です。"); }
 
-    /*! This is an introduction to the page with the list of related pages 
-*/
+    /*! This is an introduction to the page with the list of related pages */
     virtual QCString trRelatedPagesDescription()
     { return decode("関連ページの一覧です。"); }
 
-    /*! This is an introduction to the page with the list of class/file 
-groups */
+    /*! This is an introduction to the page with the list of class/file groups */
     virtual QCString trModulesDescription()
     { return decode("すべてのモジュールの一覧です。"); }
 
@@ -328,13 +315,13 @@ groups */
     virtual QCString trCompoundIndex()
     {
       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
-    {
-      return decode("データ構造索引");
-    }
+	{
+	  return decode("データ構造索引");
+	}
       else
-    {
-      return decode("構成索引");
-    }
+	{
+	  return decode("構成索引");
+	}
     }
 
     /*! This is used in LaTeX as the title of the chapter with the
@@ -355,13 +342,13 @@ groups */
     virtual QCString trClassDocumentation()
     {
       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
-    {
-      return decode("データ構造の解説");
-    }
+	{
+	  return decode("データ構造の解説");
+	}
       else
-    {
-      return decode("クラスの解説");
-    }
+	{
+	  return decode("クラスの解説");
+	}
     }
 
     /*! This is used in LaTeX as the title of the chapter containing
@@ -402,13 +389,13 @@ groups */
      *  list of typedefs
      */
     virtual QCString trTypedefs()
-    { return decode("Typedef定義"); }
+    { return decode("型定義"); }
 
     /*! This is used in the documentation of a file as a header before the
      *  list of enumerations
      */
     virtual QCString trEnumerations()
-    { return decode("Enum定義"); }
+    { return decode("列挙型"); }
 
     /*! This is used in the documentation of a file as a header before the
      *  list of (global) functions
@@ -426,50 +413,44 @@ groups */
      *  list of (global) variables
      */
     virtual QCString trEnumerationValues()
-      { return decode("Enum値"); }
+      { return decode("列挙値"); }
     /*! This is used in the documentation of a file before the list of
      *  documentation blocks for defines
      */
     virtual QCString trDefineDocumentation()
     { return decode("マクロ定義の解説"); }
 
-    /*! This is used in the documentation of a file/namespace before the 
-list
+    /*! This is used in the documentation of a file/namespace before the list
      *  of documentation blocks for function prototypes
      */
     virtual QCString trFunctionPrototypeDocumentation()
     { return decode("関数プロトタイプの解説"); }
 
-    /*! This is used in the documentation of a file/namespace before the 
-list
+    /*! This is used in the documentation of a file/namespace before the list
      *  of documentation blocks for typedefs
      */
     virtual QCString trTypedefDocumentation()
-    { return decode("Typedef定義の解説"); }
+    { return decode("型定義の解説"); }
 
-    /*! This is used in the documentation of a file/namespace before the 
-list
+    /*! This is used in the documentation of a file/namespace before the list
      *  of documentation blocks for enumeration types
      */
     virtual QCString trEnumerationTypeDocumentation()
-    { return decode("Enum定義の解説"); }
+    { return decode("列挙型の解説"); }
 
-    /*! This is used in the documentation of a file/namespace before the 
-list
+    /*! This is used in the documentation of a file/namespace before the list
      *  of documentation blocks for enumeration values
      */
     virtual QCString trEnumerationValueDocumentation()
-    { return decode("Enum値の解説"); }
+    { return decode("列挙値の解説"); }
 
-    /*! This is used in the documentation of a file/namespace before the 
-list
+    /*! This is used in the documentation of a file/namespace before the list
      *  of documentation blocks for functions
      */
     virtual QCString trFunctionDocumentation()
     { return decode("関数の解説"); }
 
-    /*! This is used in the documentation of a file/namespace before the 
-list
+    /*! This is used in the documentation of a file/namespace before the list
      *  of documentation blocks for variables
      */
     virtual QCString trVariableDocumentation()
@@ -481,13 +462,13 @@ list
     virtual QCString trCompounds()
     {
       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
-    {
-      return decode("データ構造");
-    }
+	{
+	  return decode("データ構造");
+	}
       else
-    {
-      return decode("構成");
-    }
+	{
+	  return decode("構成");
+	}
     }
     /*! This is used in the standard footer of each page and indicates when
      *  the page was generated
@@ -499,8 +480,7 @@ list
       result+=(QCString)date+decode("に生成されました。");
       return result;
     }
-    /*! This is part of the sentence used in the standard footer of each 
-page.
+    /*! This is part of the sentence used in the standard footer of each page.
      */
     virtual QCString trWrittenBy()
     {
@@ -510,7 +490,7 @@ page.
     /*! this text is put before a class diagram */
     virtual QCString trClassDiagram(const char *clName)
     {
-      return (QCString)clName+decode("の継承グラフ");
+      return (QCString)clName+decode("に対する継承グラフ");
     }
 
     /*! this text is generated when the \\internal command is used. */
@@ -519,8 +499,7 @@ page.
 
     /*! this text is generated when the \\reimp command is used. */
     virtual QCString trReimplementedForInternalReasons()
-    { return 
-decode("内部的な理由により再実装されましたが、APIには影響しません。");
+    { return decode("内部的な理由により再実装されましたが、APIには影響しません。");
     }
 
     /*! this text is generated when the \\warning command is used. */
@@ -539,10 +518,6 @@ decode("
     virtual QCString trDate()
     { return decode("日付"); }
 
-    /*! this text is generated when the \\author command is used. */
-    virtual QCString trAuthors()
-    { return decode("作者"); }
-
     /*! this text is generated when the \\return command is used. */
     virtual QCString trReturns()
     { return decode("戻り値"); }
@@ -561,14 +536,13 @@ decode("
 
     /*! this text is used in the title page of a LaTeX document. */
     virtual QCString trGeneratedBy()
-    { return decode(""); }
+    { return decode("作成："); }
 
 //////////////////////////////////////////////////////////////////////////
 // new since 0.49-990307
 //////////////////////////////////////////////////////////////////////////
 
-    /*! used as the title of page containing all the index of all 
-namespaces. */
+    /*! used as the title of page containing all the index of all namespaces. */
     virtual QCString trNamespaceList()
     { return decode("名前空間一覧"); }
 
@@ -584,7 +558,7 @@ namespaces. */
      *  friends of a class
      */
     virtual QCString trFriends()
-    { return decode("Friend関数"); }
+    { return decode("フレンド"); }
 
 //////////////////////////////////////////////////////////////////////////
 // new since 0.49-990405
@@ -594,7 +568,7 @@ namespaces. */
      * related classes
      */
     virtual QCString trRelatedFunctionDocumentation()
-    { return decode("関連する関数の解説"); }
+    { return decode("フレンドと関連する関数の解説"); }
 
 //////////////////////////////////////////////////////////////////////////
 // new since 0.49-990425
@@ -612,8 +586,7 @@ namespaces. */
         case ClassDef::Struct:     result+=decode("構造体 "); break;
         case ClassDef::Union:      result+=decode("共用体 "); break;
         case ClassDef::Interface:  result+=decode("インタフェース"); break;
-        case ClassDef::Exception:  result+=decode("例外"); break; 
-//TODO:fixme
+        case ClassDef::Exception:  result+=decode("例外"); break; //TODO:fixme
       }
       if (isTemplate) result+=decode(" テンプレート");
       result+=(QCString)clName+decode(" の解説");
@@ -630,32 +603,31 @@ namespaces. */
     /*! used as the title of the HTML page of a namespace */
     virtual QCString trNamespaceReference(const char *namespaceName)
     {
-      QCString result=decode("名前空間 ")+(QCString)namespaceName+decode(" 
-の解説");
+      QCString result=decode("名前空間 ")+(QCString)namespaceName+decode(" の解説");
       return result;
     }
 
     /* these are for the member sections of a class, struct or union */
     virtual QCString trPublicMembers()
-    { return decode("Public メソッド"); }
+    { return decode("Public メンバ"); }
     virtual QCString trPublicSlots()
     { return decode("Public スロット"); }
     virtual QCString trSignals()
     { return decode("シグナル"); }
     virtual QCString trStaticPublicMembers()
-    { return decode("Static Public メソッド"); }
+    { return decode("Static Public メンバ"); }
     virtual QCString trProtectedMembers()
-    { return decode("Protected メソッド"); }
+    { return decode("Protected メンバ"); }
     virtual QCString trProtectedSlots()
     { return decode("Protected スロット"); }
     virtual QCString trStaticProtectedMembers()
-    { return decode("Static Protected メソッド"); }
+    { return decode("Static Protected メンバ"); }
     virtual QCString trPrivateMembers()
-    { return decode("Private メソッド"); }
+    { return decode("Private メンバ"); }
     virtual QCString trPrivateSlots()
     { return decode("Private スロット"); }
     virtual QCString trStaticPrivateMembers()
-    { return decode("Static Private メソッド"); }
+    { return decode("Static Private メンバ"); }
 
     /*! this function is used to produce a comma-separated list of items.
      *  use generateMarker(i) to indicate where item i should be put.
@@ -714,20 +686,19 @@ namespaces. */
       return trWriteList(numEntries)+decode("で再定義されています。");
     }
 
-    /*! This is put above each page as a link to all members of namespaces. 
-*/
+    /*! This is put above each page as a link to all members of namespaces. */
     virtual QCString trNamespaceMembers()
     { return decode("名前空間メンバ"); }
 
     /*! This is an introduction to the page with all namespace members */
     virtual QCString trNamespaceMemberDescription(bool extractAll)
     {
-    QCString result=decode("これは");
+	QCString result=decode("これは");
       result+=decode("名前空間の一覧です。それぞれ");
       if (extractAll)
-      result+=decode("の名前空間の解説");
+	  result+=decode("の名前空間の解説");
       else
-      result+=decode("が属している名前空間");
+	  result+=decode("が属している名前空間");
       result+=decode("へリンクしています。");
       return result;
     }
@@ -771,8 +742,7 @@ namespaces. */
         case ClassDef::Struct:     result+=decode("構造体"); break;
         case ClassDef::Union:      result+=decode("共用体"); break;
         case ClassDef::Interface:  result+=decode("インタフェース"); break;
-        case ClassDef::Exception:  result+=decode("例外"); break; 
-//TODO:fixme
+        case ClassDef::Exception:  result+=decode("例外"); break; //TODO:fixme
       }
       result+=decode("の解説は次のファイルから生成されました:");
       return result;
@@ -782,7 +752,7 @@ namespaces. */
      * list.
      */
     virtual QCString trAlphabeticalList()
-    { return decode("一覧  [アルファベット順]"); }
+    { return decode("アルファベット順一覧"); }
 
 //////////////////////////////////////////////////////////////////////////
 // new since 0.49-990901
@@ -841,21 +811,19 @@ namespaces. */
     /*! this text is put before an include dependency graph */
     virtual QCString trInclDepGraph(const char *fName)
     {
-    return (QCString)fName+decode("のインクルード依存関係図");
+	return (QCString)fName+decode("のインクルード依存関係図");
     }
     /*! header that is put before the list of constructor/destructors. */
     virtual QCString trConstructorDocumentation()
     {
       return decode("コンストラクタとデストラクタの解説");
     }
-    /*! Used in the file documentation to point to the corresponding 
-sources. */
+    /*! Used in the file documentation to point to the corresponding sources. */
     virtual QCString trGotoSourceCode()
     {
       return decode("ソースコードを見る。");
     }
-    /*! Used in the file sources to point to the corresponding 
-documentation. */
+    /*! Used in the file sources to point to the corresponding documentation. */
     virtual QCString trGotoDocumentation()
     {
       return decode("解説を見る。");
@@ -883,7 +851,7 @@ documentation. */
     /*! Text used the source code in the file index */
     virtual QCString trCode()
     {
-      return decode("ソースコード");
+      return decode("コード");
     }
     virtual QCString trGraphicalHierarchy()
     {
@@ -912,18 +880,18 @@ documentation. */
     }
     virtual QCString trPublicTypes()
     {
-      return decode("Public 型");
+      return decode("公開型");
     }
     virtual QCString trPublicAttribs()
     {
       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
-    {
-      return decode("データフィールド");
-    }
+	{
+	  return decode("データフィールド");
+	}
       else
-    {
-      return decode("Public 属性");
-    }
+	{
+	  return decode("Public 属性");
+	}
     }
     virtual QCString trStaticPublicAttribs()
     {
@@ -961,12 +929,12 @@ documentation. */
     /*! Used as a marker that is put before a todo item */
     virtual QCString trTodo()
     {
-      return decode("Todo");
+      return decode("TODO");
     }
     /*! Used as the header of the todo list */
     virtual QCString trTodoList()
     {
-      return decode("Todo一覧");
+      return decode("TODO一覧");
     }
 
 //////////////////////////////////////////////////////////////////////////
@@ -987,7 +955,7 @@ documentation. */
     }
     virtual QCString trInclByDepGraph()
     {
-    return decode("このグラフは、どのファイルから直接/間接的に"
+	return decode("このグラフは、どのファイルから直接、間接的に"
              "インクルードされているかを示しています。");
     }
     virtual QCString trSince()
@@ -1008,8 +976,7 @@ documentation. */
     virtual QCString trLegendDocs()
     {
       return
-        decode("このページでは、doxygen 
-で生成されたグラフをどのようにみたらよいかを"
+        decode("このページでは、doxygen で生成されたグラフをどのようにみたらよいかを"
         "説明します。<p>\n"
         "次の例を考えてみます。\n"
         "\\code\n"
@@ -1037,23 +1004,19 @@ documentation. */
         "    Used *m_usedClass;\n"
         "};\n"
         "\\endcode\n"
-        "設定ファイル中で、タグ \\c MAX_DOT_GRAPH_HEIGHT が 200 
-にセットされた"
+        "設定ファイル中で、タグ \\c MAX_DOT_GRAPH_HEIGHT が 200 にセットされた"
         "場合、次のようなグラフとなります。"
-        "<p><center><img 
-src=\"graph_legend."+Config_getEnum("DOT_IMAGE_FORMAT")+"\"></center>\n"
+        "<p><center><img src=\"graph_legend."+Config_getEnum("DOT_IMAGE_FORMAT")+"\"></center>\n"
         "<p>\n"
         "上のグラフ内のボックスには次のような意味があります。\n"
         "<ul>\n"
-        
-"<li>黒く塗りつぶされたボックスは、このグラフに対応する構造体やクラスを"
+        "<li>黒く塗りつぶされたボックスは、このグラフに対応する構造体やクラスを"
         "表します。\n"
         "<li>黒枠のボックスはドキュメントがある構造体やクラスを表します。\n"
-        
-"<li>灰色の枠のボックスはドキュメントがない構造体やクラスを表します。\n"
+        "<li>灰色の枠のボックスはドキュメントがない構造体やクラスを表します。\n"
         "<li>赤枠のボックスはドキュメントがある構造体やクラスを表しますが、"
-      "指定されたサイズに収まらないために継承・包含関係をすべて図示する"
-      "ことができなかったことを示します。"
+	  "指定されたサイズに収まらないために継承・包含関係をすべて図示する"
+	  "ことができなかったことを示します。"
         "</ul>\n"
         "矢印には次のような意味があります。\n"
         "<ul>\n"
@@ -1061,8 +1024,8 @@ src=\"graph_legend."+Config_getEnum("DOT_IMAGE_FORMAT")+"\"></center>\n"
         "<li>緑の矢印は protected 継承関係を示します。\n"
         "<li>赤の矢印は private 継承関係を示します。\n"
         "<li>紫の破線矢印は、そのクラスが他のクラスに含まれていたり、"
-      "利用されていることを示します。また、矢印が指しているクラスや構造体を"
-      "どの変数でアクセスできるかを矢印のラベルとして示しています。\n"
+	  "利用されていることを示します。また、矢印が指しているクラスや構造体を"
+	  "どの変数でアクセスできるかを矢印のラベルとして示しています。\n"
         "</ul>\n");
     }
     /*! text for the link to the legend page */
@@ -1093,7 +1056,7 @@ src=\"graph_legend."+Config_getEnum("DOT_IMAGE_FORMAT")+"\"></center>\n"
     /*! Used as a section header for KDE-2 IDL methods */
     virtual QCString trDCOPMethods()
     {
-      return decode("DCOP メソッド");
+      return decode("DCOPメソッド");
     }
 
 //////////////////////////////////////////////////////////////////////////
@@ -1119,19 +1082,19 @@ src=\"graph_legend."+Config_getEnum("DOT_IMAGE_FORMAT")+"\"></center>\n"
     /*! Used for Java interfaces in the summary section of Java packages */
     virtual QCString trInterfaces()
     {
-      return decode("インタフェース");
+      return decode("インターフェース");
     }
     /*! Used for Java classes in the summary section of Java packages */
     virtual QCString trClasses()
     {
       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
-    {
-      return decode("データ構造");
-    }
+	{
+	  return decode("データ構造");
+	}
       else
-    {
-      return decode("クラス");
-    }
+	{
+	  return decode("クラス");
+	}
     }
     /*! Used as the title of a Java package */
     virtual QCString trPackage(const char *name)
@@ -1186,8 +1149,7 @@ src=\"graph_legend."+Config_getEnum("DOT_IMAGE_FORMAT")+"\"></center>\n"
 
     /*! Used as ansicpg for RTF file
      *
-     * The following table shows the correlation of Charset name, Charset 
-Value and
+     * The following table shows the correlation of Charset name, Charset Value and
      * <pre>
      * Codepage number:
      * Charset Name       Charset Value(hex)  Codepage number
@@ -1360,7 +1322,7 @@ Value and
      */
     virtual QCString trImplementedFromList(int numEntries)
     {
-      return trWriteList(numEntries)+decode("を実装しています")+".";
+      return trWriteList(numEntries)+decode("に実装されています")+".";
     }
 
     /*! used in member documentation blocks to produce a list of
@@ -1368,9 +1330,8 @@ Value and
      */
     virtual QCString trImplementedInList(int numEntries)
     {
-      return trWriteList(numEntries)+decode("で実装されています")+".";
+      return trWriteList(numEntries)+decode("を実装しています")+".";
     }
 
 };
 #endif
-

src/translator_tw.h

+/******************************************************************************
+ *
+ * 
+ *
+ * Copyright (C) 1997-2002 by Dimitri van Heesch.
+ *
+ * Permission to use, copy, modify, and distribute this software and its
+ * documentation under the terms of the GNU General Public License is hereby 
+ * granted. No representations are made about the suitability of this software 
+ * for any purpose. It is provided "as is" without express or implied warranty.
+ * See the GNU General Public License for more details.
+ *
+ * Documents produced by Doxygen are derivative works derived from the
+ * input used in their production; they are not affected by this license.
+ *
+ */
+
+#ifndef TRANSLATOR_TW_H
+#define TRANSLATOR_TW_H
+
+// When defining a translator class for the new language, follow
+// the description in the documentation.  One of the steps says
+// that you should copy the translator_en.h (this) file to your
+// translator_xx.h new file.  Your new language should use the
+// Translator class as the base class.  This means that you need to
+// implement exactly the same (pure virtual) methods as the
+// TranslatorEnglish does.  Because of this, it is a good idea to
+// start with the copy of TranslatorEnglish and replace the strings
+// one by one.
+//
+// It is not necessary to include "translator.h" or
+// "translator_adapter.h" here.  The files are included in the
+// language.cpp correctly.  Not including any of the mentioned
+// files frees the maintainer from thinking about whether the
+// first, the second, or both files should be included or not, and
+// why.  This holds namely for localized translators because their
+// base class is changed occasionaly to adapter classes when the
+// Translator class changes the interface, or back to the
+// Translator class (by the local maintainer) when the localized
+// translator is made up-to-date again.
+
+class TranslatorChinesetraditional : public Translator
+{
+  public:
+
+    // --- Language control methods -------------------
+    
+    /*! Used for identification of the language. The identification 
+     * should not be translated. It should be replaced by the name 
+     * of the language in English using lower-case characters only
+     * (e.g. "czech", "japanese", "russian", etc.). It should be equal to 
+     * the identification used in language.cpp.
+     */
+    virtual QCString idLanguage()
+    { return "chinese-traditional"; }
+    
+    /*! Used to get the LaTeX command(s) for the language support. 
+     *  This method should return string with commands that switch
+     *  LaTeX to the desired language.  For example 
+     *  <pre>"\\usepackage[german]{babel}\n"
+     *  </pre>
+     *  or
+     *  <pre>"\\usepackage{polski}\n"
+     *  "\\usepackage[latin2]{inputenc}\n"
+     *  "\\usepackage[T1]{fontenc}\n"
+     *  </pre>
+     * 
+     * The English LaTeX does not use such commands.  Because of this
+     * the empty string is returned in this implementation.
+     */
+    virtual QCString latexLanguageSupportCommand()
+    {
+      return "";
+    }
+
+    /*! return the language charset. This will be used for the HTML output */
+    virtual QCString idLanguageCharset()
+    {
+      return "big5";
+    }
+
+    // --- Language translation methods -------------------
+
+    /*! used in the compound documentation before a list of related functions. */
+    virtual QCString trRelatedFunctions()
+    { return "相關函式"; }
+
+    /*! subscript for the related functions. */
+    virtual QCString trRelatedSubscript()
+    { return "(註：這些不是成員函式)"; }
+
+    /*! header that is put before the detailed description of files, classes and namespaces. */
+    virtual QCString trDetailedDescription()
+    { return "詳細描述"; }
+
+    /*! header that is put before the list of typedefs. */
+    virtual QCString trMemberTypedefDocumentation()
+    { return "型態定義成員說明文件"; }
+    
+    /*! header that is put before the list of enumerations. */
+    virtual QCString trMemberEnumerationDocumentation()
+    { return "列舉型態成員說明文件"; }
+    
+    /*! header that is put before the list of member functions. */
+    virtual QCString trMemberFunctionDocumentation()
+    { return "函式成員說明文件"; }
+    
+    /*! header that is put before the list of member attributes. */
+    virtual QCString trMemberDataDocumentation()
+    { 
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        return "欄位說明文件"; 
+      }
+      else
+      {
+        return "資料成員說明文件"; 
+      }
+    }
+
+    /*! this is the text of a link put after brief descriptions. */
+    virtual QCString trMore() 
+    { return "更多..."; }
+
+    /*! put in the class documentation */
+    virtual QCString trListOfAllMembers()
+    { return "全部成員列表"; }
+
+    /*! used as the title of the "list of all members" page of a class */
+    virtual QCString trMemberList()
+    { return "成員列表"; }
+
+    /*! this is the first part of a sentence that is followed by a class name */
+    virtual QCString trThisIsTheListOfAllMembers()
+    { return "完整成員列表，類別為"; }
+
+    /*! this is the remainder of the sentence after the class name */
+    virtual QCString trIncludingInheritedMembers()
+    { return ", 包含所有繼承的成員"; }
+    
+    /*! this is put at the author sections at the bottom of man pages.
+     *  parameter s is name of the project name.
+     */
+    virtual QCString trGeneratedAutomatically(const char *s)
+    { QCString result="本文件由Doxygen";
+      if (s) result+=(QCString)" 自 "+s;
+      result+=" 的原始碼中自動產生."; 
+      return result;
+    }
+
+    /*! put after an enum name in the list of all members */
+    virtual QCString trEnumName()
+    { return "列舉型態名稱"; }
+    
+    /*! put after an enum value in the list of all members */
+    virtual QCString trEnumValue()
+    { return "列舉值"; }
+    
+    /*! put after an undocumented member in the list of all members */
+    virtual QCString trDefinedIn()
+    { return "被定義於"; }
+
+    // quick reference sections
+
+    /*! This is put above each page as a link to the list of all groups of 
+     *  compounds or files (see the \\group command).
+     */
+    virtual QCString trModules()
+    { return "模組"; }
+    
+    /*! This is put above each page as a link to the class hierarchy */
+    virtual QCString trClassHierarchy()
+    { return "類別階層"; }
+    
+    /*! This is put above each page as a link to the list of annotated classes */
+    virtual QCString trCompoundList()
+    { 
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        return "資料結構";
+      }
+      else
+      {
+        return "複合列表"; 
+      }
+    }
+    
+    /*! This is put above each page as a link to the list of documented files */
+    virtual QCString trFileList()
+    { return "檔案列表"; }
+
+    /*! This is put above each page as a link to the list of all verbatim headers */
+    virtual QCString trHeaderFiles()
+    { return "標頭檔案"; }
+
+    /*! This is put above each page as a link to all members of compounds. */
+    virtual QCString trCompoundMembers()
+    { 
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        return "資料欄位"; 
+      }
+      else
+      {
+        return "複合成員"; 
+      }
+    }
+
+    /*! This is put above each page as a link to all members of files. */
+    virtual QCString trFileMembers()
+    { 
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        return "全域資料"; 
+      }
+      else
+      {
+        return "檔案成員"; 
+      }
+    }
+
+    /*! This is put above each page as a link to all related pages. */
+    virtual QCString trRelatedPages()
+    { return "相關頁面"; }
+
+    /*! This is put above each page as a link to all examples. */
+    virtual QCString trExamples()
+    { return "範例"; }
+
+    /*! This is put above each page as a link to the search engine. */
+    virtual QCString trSearch()
+    { return "搜尋"; }
+
+    /*! This is an introduction to the class hierarchy. */
+    virtual QCString trClassHierarchyDescription()
+    { return "這個繼承列表經過簡略的字母排序: ";
+    }
+
+    /*! This is an introduction to the list with all files. */
+    virtual QCString trFileListDescription(bool extractAll)
+    {
+      QCString result="這是附帶簡略說明";
+      if (!extractAll) result+="且經過文件化";
+      result+="的檔案列表:";
+      return result;
+    }
+
+    /*! This is an introduction to the annotated compound list. */
+    virtual QCString trCompoundListDescription()
+    { 
+      
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        return "這是附帶簡略說明的資料結構:"; 
+      }
+      else
+      {
+        return "這是附帶簡略說明的類別，結構，"
+               "聯合型態(unions)及介面(interfaces):"; 
+      }
+    }
+
+    /*! This is an introduction to the page with all class members. */
+    virtual QCString trCompoundMembersDescription(bool extractAll)
+    {
+      QCString result="這是全部";
+      if (!extractAll)
+      {
+        result+="文件化過";
+      }
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        result+="結構及聯合型態欄位";
+      }
+      else
+      {
+        result+="類別成員";
+      }
+      result+=", 並且帶有連結至";
+      if (extractAll) 
+      {
+        if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+        {
+          result+="每個欄位的結構/聯合型態說明文件:";
+        }
+        else
+        {
+          result+="每個成員的類別說明文件:";
+        }
+      }
+      else 
+      {
+        if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+        {
+          result+="這些結構/聯合型態是屬於:";
+        }
+        else
+        {
+          result+="這些類別是屬於:";
+        }
+      }
+      return result;
+    }
+
+    /*! This is an introduction to the page with all file members. */
+    virtual QCString trFileMembersDescription(bool extractAll)
+    {
+      QCString result="這是全部";
+      if (!extractAll) result+="文件化的";
+      
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        result+="函式，變數，定義，列舉，及型態定義";
+      }
+      else
+      {
+        result+="檔案成員";
+      }
+      result+="，並且帶有連結至";
+      if (extractAll) 
+        result+="這些檔案所屬:";
+      else 
+        result+="說明文件:";
+      return result;
+    }
+
+    /*! This is an introduction to the page with the list of all header files. */
+    virtual QCString trHeaderFilesDescription()
+    { return "組成API的標頭檔:"; }
+
+    /*! This is an introduction to the page with the list of all examples */
+    virtual QCString trExamplesDescription()
+    { return "所有範例列表:"; }
+
+    /*! This is an introduction to the page with the list of related pages */
+    virtual QCString trRelatedPagesDescription()
+    { return "所有相關文件頁面列表:"; }
+
+    /*! This is an introduction to the page with the list of class/file groups */
+    virtual QCString trModulesDescription()
+    { return "所有模組列表:"; }
+
+    /*! This sentences is used in the annotated class/file lists if no brief
+     * description is given. 
+     */
+    virtual QCString trNoDescriptionAvailable()
+    { return "沒有可用的說明描述"; }
+    
+    // index titles (the project name is prepended for these) 
+
+
+    /*! This is used in HTML as the title of index.html. */
+    virtual QCString trDocumentation()
+    { return "說明文件"; }
+
+    /*! This is used in LaTeX as the title of the chapter with the 
+     * index of all groups.
+     */
+    virtual QCString trModuleIndex()
+    { return "模組索引"; }
+
+    /*! This is used in LaTeX as the title of the chapter with the 
+     * class hierarchy.
+     */
+    virtual QCString trHierarchicalIndex()
+    { return "階層索引"; }
+
+    /*! This is used in LaTeX as the title of the chapter with the 
+     * annotated compound index.
+     */
+    virtual QCString trCompoundIndex()
+    {
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      { 
+        return "資料結構索引";
+      }
+      else
+      {
+        return "複合索引"; 
+      }
+    }
+
+    /*! This is used in LaTeX as the title of the chapter with the
+     * list of all files.
+     */
+    virtual QCString trFileIndex() 
+    { return "檔案索引"; }
+
+    /*! This is used in LaTeX as the title of the chapter containing
+     *  the documentation of all groups.
+     */
+    virtual QCString trModuleDocumentation()
+    { return "模組說明文件"; }
+
+    /*! This is used in LaTeX as the title of the chapter containing
+     *  the documentation of all classes, structs and unions.
+     */
+    virtual QCString trClassDocumentation()
+    { 
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        return "資料結構說明文件"; 
+      }
+      else
+      {
+        return "類別說明文件"; 
+      }
+    }
+
+    /*! This is used in LaTeX as the title of the chapter containing
+     *  the documentation of all files.
+     */
+    virtual QCString trFileDocumentation()
+    { return "檔案說明文件"; }
+
+    /*! This is used in LaTeX as the title of the chapter containing
+     *  the documentation of all examples.
+     */
+    virtual QCString trExampleDocumentation()
+    { return "範例說明文件"; }
+
+    /*! This is used in LaTeX as the title of the chapter containing
+     *  the documentation of all related pages.
+     */
+    virtual QCString trPageDocumentation()
+    { return "頁面說明文件"; }
+
+    /*! This is used in LaTeX as the title of the document */
+    virtual QCString trReferenceManual()
+    { return "參考手冊"; }
+    
+    /*! This is used in the documentation of a file as a header before the 
+     *  list of defines
+     */
+    virtual QCString trDefines()
+    { return "定義"; }
+
+    /*! This is used in the documentation of a file as a header before the 
+     *  list of function prototypes
+     */
+    virtual QCString trFuncProtos()
+    { return "函式原型"; }
+
+    /*! This is used in the documentation of a file as a header before the 
+     *  list of typedefs
+     */
+    virtual QCString trTypedefs()
+    { return "型態定義"; }
+
+    /*! This is used in the documentation of a file as a header before the 
+     *  list of enumerations
+     */
+    virtual QCString trEnumerations()
+    { return "列舉型態"; }
+
+    /*! This is used in the documentation of a file as a header before the 
+     *  list of (global) functions
+     */
+    virtual QCString trFunctions()
+    { return "函式"; }
+
+    /*! This is used in the documentation of a file as a header before the 
+     *  list of (global) variables
+     */
+    virtual QCString trVariables()
+    { return "變數"; }
+
+    /*! This is used in the documentation of a file as a header before the 
+     *  list of (global) variables
+     */
+    virtual QCString trEnumerationValues()
+    { return "列舉值"; }
+    
+    /*! This is used in the documentation of a file before the list of
+     *  documentation blocks for defines
+     */
+    virtual QCString trDefineDocumentation()
+    { return "定義巨集說明文件"; }
+
+    /*! This is used in the documentation of a file/namespace before the list 
+     *  of documentation blocks for function prototypes
+     */
+    virtual QCString trFunctionPrototypeDocumentation()
+    { return "函式原型說明文件"; }
+
+    /*! This is used in the documentation of a file/namespace before the list 
+     *  of documentation blocks for typedefs
+     */
+    virtual QCString trTypedefDocumentation()
+    { return "型態定義說明文件"; }
+
+    /*! This is used in the documentation of a file/namespace before the list 
+     *  of documentation blocks for enumeration types
+     */
+    virtual QCString trEnumerationTypeDocumentation()
+    { return "列舉型態說明文件"; }
+
+    /*! This is used in the documentation of a file/namespace before the list 
+     *  of documentation blocks for enumeration values
+     */
+    virtual QCString trEnumerationValueDocumentation()
+    { return "列舉值說明文件"; }
+
+    /*! This is used in the documentation of a file/namespace before the list 
+     *  of documentation blocks for functions
+     */
+    virtual QCString trFunctionDocumentation()
+    { return "函式說明文件"; }
+
+    /*! This is used in the documentation of a file/namespace before the list 
+     *  of documentation blocks for variables
+     */
+    virtual QCString trVariableDocumentation()
+    { return "變數說明文件"; }
+
+    /*! This is used in the documentation of a file/namespace/group before 
+     *  the list of links to documented compounds
+     */
+    virtual QCString trCompounds()
+    { 
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        return "資料結構"; 
+      }
+      else
+      {
+        return "複合項目"; 
+      }
+    }
+
+    /*! This is used in the standard footer of each page and indicates when 
+     *  the page was generated 
+     */
+    virtual QCString trGeneratedAt(const char *date,const char *projName)
+    { 
+      QCString result=(QCString)"產生日期:"+date;
+      if (projName) result+=(QCString)", 專案:"+projName;
+      result+=(QCString)", 產生器:";
+      return result;
+    }
+    /*! This is part of the sentence used in the standard footer of each page.
+     */
+    virtual QCString trWrittenBy()
+    {
+      return "撰寫人:";
+    }
+
+    /*! this text is put before a class diagram */
+    virtual QCString trClassDiagram(const char *clName)
+    {
+      return (QCString)"類別"+clName+"的繼承圖:";
+    }
+    
+    /*! this text is generated when the \\internal command is used. */
+    virtual QCString trForInternalUseOnly()
+    { return "僅供內部使用."; }
+
+    /*! this text is generated when the \\reimp command is used. */
+    virtual QCString trReimplementedForInternalReasons()
+    { return "因內部原因重新實作; 不影響API."; }
+
+    /*! this text is generated when the \\warning command is used. */
+    virtual QCString trWarning()
+    { return "警告"; }
+
+    /*! this text is generated when the \\bug command is used. */
+    virtual QCString trBugsAndLimitations()
+    { return "臭蟲及限制"; }
+
+    /*! this text is generated when the \\version command is used. */
+    virtual QCString trVersion()
+    { return "版本"; }
+
+    /*! this text is generated when the \\date command is used. */
+    virtual QCString trDate()
+    { return "日期"; }
+
+    /*! this text is generated when the \\return command is used. */
+    virtual QCString trReturns()
+    { return "傳回值"; }
+
+    /*! this text is generated when the \\sa command is used. */
+    virtual QCString trSeeAlso()
+    { return "參閱\"; }
+
+    /*! this text is generated when the \\param command is used. */
+    virtual QCString trParameters()
+    { return "參數"; }
+
+    /*! this text is generated when the \\exception command is used. */
+    virtual QCString trExceptions()
+    { return "例外"; }
+    
+    /*! this text is used in the title page of a LaTeX document. */
+    virtual QCString trGeneratedBy()
+    { return "產生者:"; }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 0.49-990307
+//////////////////////////////////////////////////////////////////////////
+    
+    /*! used as the title of page containing all the index of all namespaces. */
+    virtual QCString trNamespaceList()
+    { return "命名空間(name space)列表"; }
+
+    /*! used as an introduction to the namespace list */
+    virtual QCString trNamespaceListDescription(bool extractAll)
+    {
+      QCString result="這是所有附帶簡略說明的";
+      if (!extractAll) result+="文件化的";
+      result+="命名空間(namespaces):";
+      return result;
+    }
+
+    /*! used in the class documentation as a header before the list of all
+     *  friends of a class
+     */
+    virtual QCString trFriends()
+    { return "類別朋友(Friends)"; }
+    
+//////////////////////////////////////////////////////////////////////////
+// new since 0.49-990405
+//////////////////////////////////////////////////////////////////////////
+    
+    /*! used in the class documentation as a header before the list of all
+     * related classes 
+     */
+    virtual QCString trRelatedFunctionDocumentation()
+    { return "類別朋友及相關函式說明文件"; }
+    
+//////////////////////////////////////////////////////////////////////////
+// new since 0.49-990425
+//////////////////////////////////////////////////////////////////////////
+
+    /*! used as the title of the HTML page of a class/struct/union */
+    virtual QCString trCompoundReference(const char *clName,
+                                    ClassDef::CompoundType compType,
+                                    bool isTemplate)
+    {
+      QCString result=(QCString)clName+" ";
+      switch(compType)
+      {
+        case ClassDef::Class:      result+=" 類別"; break;
+        case ClassDef::Struct:     result+=" 結構"; break;
+        case ClassDef::Union:      result+=" 聯合"; break;
+        case ClassDef::Interface:  result+=" 介面"; break;
+        case ClassDef::Exception:  result+=" 例外"; break;
+      }
+      if (isTemplate) result+=" 樣版";
+      result+=" 參考";
+      return result;
+    }
+
+    /*! used as the title of the HTML page of a file */
+    virtual QCString trFileReference(const char *fileName)
+    {
+      QCString result=fileName;
+      result+=" 檔案參考文件"; 
+      return result;
+    }
+
+    /*! used as the title of the HTML page of a namespace */
+    virtual QCString trNamespaceReference(const char *namespaceName)
+    {
+      QCString result=namespaceName;
+      result+=" 命名空間(Namespace)參考文件";
+      return result;
+    }
+    
+    virtual QCString trPublicMembers()
+    { return "公開方法(Public Methods)"; }
+    virtual QCString trPublicSlots()
+    { return "公開插槽(Public Slots)"; }
+    virtual QCString trSignals()
+    { return "訊號(Signals)"; }
+    virtual QCString trStaticPublicMembers()
+    { return "靜態公開方法(Static Public Methods)"; }
+    virtual QCString trProtectedMembers()
+    { return "保護方法(Protected Methods)"; }
+    virtual QCString trProtectedSlots()
+    { return "保護插槽(Protected Slots)"; }
+    virtual QCString trStaticProtectedMembers()
+    { return "靜態保護方法(Static Protected Methods)"; }
+    virtual QCString trPrivateMembers()
+    { return "私有方法(Private Methods)"; }
+    virtual QCString trPrivateSlots()
+    { return "私有插槽(Private Slots)"; }
+    virtual QCString trStaticPrivateMembers()
+    { return "靜態私有方法(Static Private Methods)"; }
+    
+    /*! this function is used to produce a comma-separated list of items.
+     *  use generateMarker(i) to indicate where item i should be put.
+     */
+    virtual QCString trWriteList(int numEntries)
+    {
+      QCString result;
+      int i;
+      // the inherits list contain `numEntries' classes
+      for (i=0;i<numEntries;i++) 
+      {
+        // use generateMarker to generate placeholders for the class links!
+        result+=generateMarker(i); // generate marker for entry i in the list 
+                                   // (order is left to right)
+        
+        if (i!=numEntries-1)  // not the last entry, so we need a separator
+        {
+          if (i<numEntries-2) // not the fore last entry 
+            result+=", ";
+          else                // the fore last entry
+            result+=", 及 ";
+        }
+      }
+      return result; 
+    }
+    
+    /*! used in class documentation to produce a list of base classes,
+     *  if class diagrams are disabled.
+     */
+    virtual QCString trInheritsList(int numEntries)
+    {
+      return "繼承自 "+trWriteList(numEntries)+".";
+    }
+
+    /*! used in class documentation to produce a list of super classes,
+     *  if class diagrams are disabled.
+     */
+    virtual QCString trInheritedByList(int numEntries)
+    {
+      return "被 "+trWriteList(numEntries)+"繼承.";
+    }
+
+    /*! used in member documentation blocks to produce a list of 
+     *  members that are hidden by this one.
+     */
+    virtual QCString trReimplementedFromList(int numEntries)
+    {
+      return "依據"+trWriteList(numEntries)+"重新實作.";
+    }
+
+    /*! used in member documentation blocks to produce a list of
+     *  all member that overwrite the implementation of this member.
+     */
+    virtual QCString trReimplementedInList(int numEntries)
+    {
+      return "在"+trWriteList(numEntries)+"重新實作.";
+    }
+
+    /*! This is put above each page as a link to all members of namespaces. */
+    virtual QCString trNamespaceMembers()
+    { return "命名空間(Namespace)成員"; }
+
+    /*! This is an introduction to the page with all namespace members */
+    virtual QCString trNamespaceMemberDescription(bool extractAll)
+    { 
+      QCString result="此處列表為所有 ";
+      if (!extractAll) result+="文件化的 ";
+      result+="命名空間(namespace)成員，並且附帶連結至 ";
+      if (extractAll) 
+        result+="每個成員的說明文件:";
+      else 
+        result+="該命名空間所屬之處:";
+      return result;
+    }
+    /*! This is used in LaTeX as the title of the chapter with the 
+     *  index of all namespaces.
+     */
+    virtual QCString trNamespaceIndex()
+    { return "命名空間(Namespace)索引"; }
+
+    /*! This is used in LaTeX as the title of the chapter containing
+     *  the documentation of all namespaces.
+     */
+    virtual QCString trNamespaceDocumentation()
+    { return "命名空間(Namespace)說明文件"; }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 0.49-990522
+//////////////////////////////////////////////////////////////////////////
+
+    /*! This is used in the documentation before the list of all
+     *  namespaces in a file.
+     */
+    virtual QCString trNamespaces()
+    { return "命名空間(Namespaces)"; }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 0.49-990728
+//////////////////////////////////////////////////////////////////////////
+
+    /*! This is put at the bottom of a class documentation page and is
+     *  followed by a list of files that were used to generate the page.
+     */
+    virtual QCString trGeneratedFromFiles(ClassDef::CompoundType compType,
+        bool single)
+    { // here s is one of " Class", " Struct" or " Union"
+      // single is true implies a single file
+      QCString result=(QCString)"此";
+      switch(compType)
+      {
+        case ClassDef::Class:      result+="類別(class)"; break;
+        case ClassDef::Struct:     result+="結構(structure)"; break;
+        case ClassDef::Union:      result+="聯合(union)"; break;
+        case ClassDef::Interface:  result+="介面(interface)"; break;
+        case ClassDef::Exception:  result+="例外(exception)"; break;
+      }
+      result+=" 文件是由下列檔案中產生";
+      if (single) result+=":"; else result+=":";
+      return result;
+    }
+
+    /*! This is in the (quick) index as a link to the alphabetical compound
+     * list.
+     */
+    virtual QCString trAlphabeticalList()
+    { return "字母順序列表"; }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 0.49-990901
+//////////////////////////////////////////////////////////////////////////
+
+    /*! This is used as the heading text for the retval command. */
+    virtual QCString trReturnValues()
+    { return "傳回值"; }
+
+    /*! This is in the (quick) index as a link to the main page (index.html)
+     */
+    virtual QCString trMainPage()
+    { return "主頁面"; }
+
+    /*! This is used in references to page that are put in the LaTeX 
+     *  documentation. It should be an abbreviation of the word page.
+     */
+    virtual QCString trPageAbbreviation()
+    { return "p."; }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 0.49-991003
+//////////////////////////////////////////////////////////////////////////
+
+    virtual QCString trSources()
+    {
+      return "原始碼";
+    }
+    virtual QCString trDefinedAtLineInSourceFile()
+    {
+      return "定義在 @1 檔案之第 @0 行.";
+    }
+    virtual QCString trDefinedInSourceFile()
+    {
+      return "定義在 @0 檔.";
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 0.49-991205
+//////////////////////////////////////////////////////////////////////////
+
+    virtual QCString trDeprecated()
+    {
+      return "過時";
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.0.0
+//////////////////////////////////////////////////////////////////////////
+
+    /*! this text is put before a collaboration diagram */
+    virtual QCString trCollaborationDiagram(const char *clName)
+    {
+      return (QCString)""+clName+"的合作圖:";
+    }
+    /*! this text is put before an include dependency graph */
+    virtual QCString trInclDepGraph(const char *fName)
+    {
+      return (QCString)""+fName+"的包含相依圖:";
+    }
+    /*! header that is put before the list of constructor/destructors. */
+    virtual QCString trConstructorDocumentation()
+    {
+      return "建構子與解構子說明文件"; 
+    }
+    /*! Used in the file documentation to point to the corresponding sources. */
+    virtual QCString trGotoSourceCode()
+    {
+      return "查看本檔案的原始碼.";
+    }
+    /*! Used in the file sources to point to the corresponding documentation. */
+    virtual QCString trGotoDocumentation()
+    {
+      return "查看本檔案說明文件.";
+    }
+    /*! Text for the \\pre command */
+    virtual QCString trPrecondition()
+    {
+      return "前置條件";
+    }
+    /*! Text for the \\post command */
+    virtual QCString trPostcondition()
+    {
+      return "後置條件";
+    }
+    /*! Text for the \\invariant command */
+    virtual QCString trInvariant()
+    {
+      return "常數";
+    }
+    /*! Text shown before a multi-line variable/enum initialization */
+    virtual QCString trInitialValue()
+    {
+      return "初值:";
+    }
+    /*! Text used the source code in the file index */
+    virtual QCString trCode()
+    {
+      return "程式碼";
+    }
+    virtual QCString trGraphicalHierarchy()
+    {
+      return "圖形化之類別階層";
+    }
+    virtual QCString trGotoGraphicalHierarchy()
+    {
+      return "查看圖形化之類別階層";
+    }
+    virtual QCString trGotoTextualHierarchy()
+    {
+      return "查看文字化之類別階層";
+    }
+    virtual QCString trPageIndex()
+    {
+      return "頁面索引";
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.1.0
+//////////////////////////////////////////////////////////////////////////
+    
+    virtual QCString trNote()
+    {
+      return "註";
+    }
+    virtual QCString trPublicTypes()
+    {
+      return "公開型態";
+    }
+    virtual QCString trPublicAttribs()
+    {
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        return "資料欄位";
+      }
+      else
+      {
+        return "公開屬性";
+      }
+    }
+    virtual QCString trStaticPublicAttribs()
+    {
+      return "靜態公開屬性";
+    }
+    virtual QCString trProtectedTypes()
+    {
+      return "保護型態";
+    }
+    virtual QCString trProtectedAttribs()
+    {
+      return "保護屬性";
+    }
+    virtual QCString trStaticProtectedAttribs()
+    {
+      return "靜態保護屬性";
+    }
+    virtual QCString trPrivateTypes()
+    {
+      return "私有型態";
+    }
+    virtual QCString trPrivateAttribs()
+    {
+      return "私有屬性";
+    }
+    virtual QCString trStaticPrivateAttribs()
+    {
+      return "靜態私有屬性";
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.1.3
+//////////////////////////////////////////////////////////////////////////
+
+    /*! Used as a marker that is put before a \\todo item */
+    virtual QCString trTodo()
+    {
+      return "待辦事項";
+    }
+    /*! Used as the header of the todo list */
+    virtual QCString trTodoList()
+    {
+      return "待辦事項列表";
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.1.4
+//////////////////////////////////////////////////////////////////////////
+
+    virtual QCString trReferencedBy()
+    {
+      return "被參考於";
+    }
+    virtual QCString trRemarks()
+    {
+      return "備註";
+    }
+    virtual QCString trAttention()
+    {
+      return "注意";
+    }
+    virtual QCString trInclByDepGraph()
+    {
+      return "本圖顯示出哪些檔案直接或間接include本檔 "
+             ":";
+    }
+    virtual QCString trSince()
+    {
+      return "自";
+    }
+    
+//////////////////////////////////////////////////////////////////////////
+// new since 1.1.5
+//////////////////////////////////////////////////////////////////////////
+
+    /*! title of the graph legend page */
+    virtual QCString trLegendTitle()
+    {
+      return "圖示";
+    }
+    /*! page explaining how the dot graph's should be interpreted 
+     *  The %A in the text below are to prevent link to classes called "A".
+     */
+    virtual QCString trLegendDocs()
+    {
+      return 
+        "本頁解釋如何解譯這些由doxygen所產生的圖示 "
+        ".<p>\n"
+        "請看下面範例:\n"
+        "\\code\n"
+        "/*! 因為截斷的不可見類別 */\n"
+        "class Invisible { };\n\n"
+        "/*! 截斷的類別, 繼承關係被隱藏 */\n"
+        "class Truncated : public Invisible { };\n\n"
+        "/* 未經過doxygen註解處理過的類別 */\n"
+        "class Undocumented { };\n\n"
+        "/*! 經過公開(Public)繼承的類別 */\n"
+        "class PublicBase : public Truncated { };\n\n"
+        "/*! 一個樣版類別 */\n"
+        "template<class T> class Templ { };\n\n"
+        "/*! 使用保護(Protected)繼承的類別 */\n"
+        "class ProtectedBase { };\n\n"
+        "/*! 使用私有(Private)繼承的類別 */\n"
+        "class PrivateBase { };\n\n"
+        "/*! 由被繼承類別所使用的類別 */\n"
+        "class Used { };\n\n"
+        "/*! 由數個其他類別所繼承來的超類別(Super Class) */\n"
+        "class Inherited : public PublicBase,\n"
+        "                  protected ProtectedBase,\n"
+        "                  private PrivateBase,\n"
+        "                  public Undocumented\n"
+        "                  public Templ<int>\n"
+        "{\n"
+        "  private:\n"
+        "    Used *m_usedClass;\n"
+        "};\n"
+        "\\endcode\n"
+        "若在組態檔中的 \\c MAX_DOT_GRAPH_HEIGHT tag "
+        "設為 240，將會產生下列的圖示:"
+        "<p><center><img src=\"graph_legend."+Config_getEnum("DOT_IMAGE_FORMAT")+"\"></center>\n"
+        "<p>\n"
+        "上圖中的各區塊意義如下:\n"
+        "<ul>\n"
+        "<li>%A 填滿黑色的區塊代表產生這個圖示的類別或結構 "
+        ".\n"
+        "<li>%A 黑邊的區塊代表文件化過的結構或類別.\n"
+        "<li>%A 灰邊的區塊代表未經文件化的結構或是類別.\n"
+        "<li>%A 紅邊的區塊代表文件化的結構或是類別，"
+        "這些結構或類別的繼承或包含關係不會全部顯示. %A 圖示 "
+        "若無法塞入指定的邊界中將會被截斷.\n"
+        "</ul>\n"
+        "箭頭具有下面的意義:\n"
+        "<ul>\n"
+        "<li>%A 深藍色箭頭用來代表兩個類別間的公開繼承 "
+        "關係.\n"
+        "<li>%A 深綠色箭頭代表保護繼承.\n"
+        "<li>%A 深紅色箭頭代表私有繼承.\n"
+        "<li>%A 紫色箭頭用來表示類別被另一個包含或是使用."
+        "箭頭上標示著可存取該類別或是結構的對應變數"
+        ".\n"
+        "<li>%A 黃色箭頭代表樣版實體與樣版類別之間的關係。"
+        "箭頭上標記著樣版實體上的參數"
+        ".\n"
+        "</ul>\n";
+    }
+    /*! text for the link to the legend page */
+    virtual QCString trLegend()
+    {
+      return "圖示";
+    }
+    
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.0
+//////////////////////////////////////////////////////////////////////////
+    
+    /*! Used as a marker that is put before a test item */
+    virtual QCString trTest()
+    {
+      return "測試項目";
+    }
+    /*! Used as the header of the test list */
+    virtual QCString trTestList()
+    {
+      return "測試項目列表";
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.1
+//////////////////////////////////////////////////////////////////////////
+
+    /*! Used as a section header for KDE-2 IDL methods */
+    virtual QCString trDCOPMethods()
+    {
+      return "DCOP方法";
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.2
+//////////////////////////////////////////////////////////////////////////
+
+    /*! Used as a section header for IDL properties */
+    virtual QCString trProperties()
+    {
+      return "屬性(properties)";
+    }
+    /*! Used as a section header for IDL property documentation */
+    virtual QCString trPropertyDocumentation()
+    {
+      return "屬性(property)說明文件";
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.4
+//////////////////////////////////////////////////////////////////////////
+
+    /*! Used for Java interfaces in the summary section of Java packages */
+    virtual QCString trInterfaces()
+    {
+      return "介面";
+    }
+    /*! Used for Java classes in the summary section of Java packages */
+    virtual QCString trClasses()
+    {
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        return "資料結構";
+      }
+      else
+      {
+        return "類別";
+      }
+    }
+    /*! Used as the title of a Java package */
+    virtual QCString trPackage(const char *name)
+    {
+      return (QCString)"Package "+name;
+    }
+    /*! Title of the package index page */
+    virtual QCString trPackageList()
+    {
+      return "Package列表";
+    }
+    /*! The description of the package index page */
+    virtual QCString trPackageListDescription()
+    {
+      return "此處為Package的概略說明(如果有的話):";
+    }
+    /*! The link name in the Quick links header for each page */
+    virtual QCString trPackages()
+    {
+      return "Packages";
+    }
+    /*! Used as a chapter title for Latex & RTF output */
+    virtual QCString trPackageDocumentation()
+    {
+      return "Package說明文件";
+    }
+    /*! Text shown before a multi-line define */
+    virtual QCString trDefineValue()
+    {
+      return "值:";
+    }
+    
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.5
+//////////////////////////////////////////////////////////////////////////
+    
+    /*! Used as a marker that is put before a \\bug item */
+    virtual QCString trBug()
+    {
+      return "臭蟲";
+    }
+    /*! Used as the header of the bug list */
+    virtual QCString trBugList()
+    {
+      return "臭蟲列表";
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.6
+//////////////////////////////////////////////////////////////////////////
+
+    /*! Used as ansicpg for RTF file 
+     * 
+     * The following table shows the correlation of Charset name, Charset Value and 
+     * <pre>
+     * Codepage number:
+     * Charset Name       Charset Value(hex)  Codepage number
+     * ------------------------------------------------------
+     * DEFAULT_CHARSET           1 (x01)
+     * SYMBOL_CHARSET            2 (x02)
+     * OEM_CHARSET             255 (xFF)
+     * ANSI_CHARSET              0 (x00)            1252
+     * RUSSIAN_CHARSET         204 (xCC)            1251
+     * EE_CHARSET              238 (xEE)            1250
+     * GREEK_CHARSET           161 (xA1)            1253
+     * TURKISH_CHARSET         162 (xA2)            1254
+     * BALTIC_CHARSET          186 (xBA)            1257
+     * HEBREW_CHARSET          177 (xB1)            1255
+     * ARABIC _CHARSET         178 (xB2)            1256
+     * SHIFTJIS_CHARSET        128 (x80)             932
+     * HANGEUL_CHARSET         129 (x81)             949
+     * GB2313_CHARSET          134 (x86)             936
+     * CHINESEBIG5_CHARSET     136 (x88)             950
+     * </pre>
+     * 
+     */
+    virtual QCString trRTFansicp()
+    {
+      return "950";
+    }
+    
+
+    /*! Used as ansicpg for RTF fcharset 
+     *  \see trRTFansicp() for a table of possible values.
+     */
+    virtual QCString trRTFCharSet()
+    {
+      return "136";
+    }
+
+    /*! Used as header RTF general index */
+    virtual QCString trRTFGeneralIndex()
+    {
+      return "索引";
+    }
+   
+    /*! This is used for translation of the word that will possibly
+     *  be followed by a single name or by a list of names 
+     *  of the category.
+     */
+    virtual QCString trClass(bool /*first_capital*/, bool /*singular*/)
+    { 
+      return QCString("類別");
+    }
+
+    /*! This is used for translation of the word that will possibly
+     *  be followed by a single name or by a list of names 
+     *  of the category.
+     */
+    virtual QCString trFile(bool /*first_capital*/, bool /*singular*/)
+    { 
+      return QCString("檔案");
+    }
+
+    /*! This is used for translation of the word that will possibly
+     *  be followed by a single name or by a list of names 
+     *  of the category.
+     */
+    virtual QCString trNamespace(bool /*first_capital*/, bool /*singular*/)
+    { 
+      return QCString("命名空間");
+    }
+
+    /*! This is used for translation of the word that will possibly
+     *  be followed by a single name or by a list of names 
+     *  of the category.
+     */
+    virtual QCString trGroup(bool /*first_capital*/, bool /*singular*/)
+    { 
+      return QCString("群組");
+    }
+
+    /*! This is used for translation of the word that will possibly
+     *  be followed by a single name or by a list of names 
+     *  of the category.
+     */
+    virtual QCString trPage(bool /*first_capital*/, bool /*singular*/)
+    { 
+      return QCString("頁面");
+    }
+
+    /*! This is used for translation of the word that will possibly
+     *  be followed by a single name or by a list of names 
+     *  of the category.
+     */
+    virtual QCString trMember(bool /*first_capital*/, bool /*singular*/)
+    { 
+      return QCString("成員");
+    }
+   
+    /*! This is used for translation of the word that will possibly
+     *  be followed by a single name or by a list of names 
+     *  of the category.
+     */
+    virtual QCString trField(bool /*first_capital*/, bool /*singular*/)
+    { 
+      return QCString("欄位");
+    }
+
+    /*! This is used for translation of the word that will possibly
+     *  be followed by a single name or by a list of names 
+     *  of the category.
+     */
+    virtual QCString trGlobal(bool /*first_capital*/, bool /*singular*/)
+    { 
+      return QCString("全域");
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.7
+//////////////////////////////////////////////////////////////////////////
+
+    /*! This text is generated when the \\author command is used and
+     *  for the author section in man pages. */
+    virtual QCString trAuthor(bool /*first_capital*/, bool /*singular*/)
+    {                                                                         
+      return QCString("作者");
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.11
+//////////////////////////////////////////////////////////////////////////
+
+    /*! This text is put before the list of members referenced by a member
+     */
+    virtual QCString trReferences()
+    {
+      return "參考";
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.13
+//////////////////////////////////////////////////////////////////////////
+
+    /*! used in member documentation blocks to produce a list of 
+     *  members that are implemented by this one.
+     */
+    virtual QCString trImplementedFromList(int numEntries)
+    {
+      return "實作 "+trWriteList(numEntries)+".";
+    }
+
+    /*! used in member documentation blocks to produce a list of
+     *  all members that implement this abstract member.
+     */
+    virtual QCString trImplementedInList(int numEntries)
+    {
+      return "實作於 "+trWriteList(numEntries)+".";
+    }
+
+};
+
+#endif

src/util.cpp

@@ -1332,9 +1332,11 @@ static bool matchArgument(const Argument *srcA,const Argument *dstA,
                    NamespaceList *usingNamespaces,
                    ClassList *usingClasses)
 {
-  //printf("match argument start %s:%s <-> %s:%s\n",
+  //printf("match argument start %s:%s <-> %s:%s using nsp=%p class=%p\n",
   //    srcA->type.data(),srcA->name.data(),
-  //    dstA->type.data(),dstA->name.data());
+  //    dstA->type.data(),dstA->name.data(),
+  //    usingNamespaces,
+  //    usingClasses);
 
   // TODO: resolve any typedefs names that are part of srcA->type
   //       before matching. This should use className and namespaceName