diff options
43 files changed, 2357 insertions, 392 deletions
@@ -1,6 +1,6 @@ -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) @@ -1,4 +1,4 @@ -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) @@ -1 +1 @@ -1.2.15-20020421 +1.2.15-20020430 diff --git a/addon/doxmlparser/include/doxmlintf.h b/addon/doxmlparser/include/doxmlintf.h index becbe78..5c051dd 100644 --- a/addon/doxmlparser/include/doxmlintf.h +++ b/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() }; diff --git a/addon/doxmlparser/src/compoundhandler.cpp b/addon/doxmlparser/src/compoundhandler.cpp index 59d4cd9..b6c6235 100644 --- a/addon/doxmlparser/src/compoundhandler.cpp +++ b/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; +} + diff --git a/addon/doxmlparser/src/compoundhandler.h b/addon/doxmlparser/src/compoundhandler.h index b331bec..bc725e3 100644 --- a/addon/doxmlparser/src/compoundhandler.h +++ b/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; }; diff --git a/addon/doxmlparser/src/dochandler.cpp b/addon/doxmlparser/src/dochandler.cpp index f21c90f..6a37f7a 100644 --- a/addon/doxmlparser/src/dochandler.cpp +++ b/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; diff --git a/addon/doxmlparser/src/doxmlintf.h b/addon/doxmlparser/src/doxmlintf.h index becbe78..5c051dd 100644 --- a/addon/doxmlparser/src/doxmlintf.h +++ b/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() }; diff --git a/addon/doxmlparser/test/main.cpp b/addon/doxmlparser/test/main.cpp index a6b867d..31beab8 100644 --- a/addon/doxmlparser/test/main.cpp +++ b/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(); @@ -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; diff --git a/doc/docblocks.doc b/doc/docblocks.doc index 49a2f5f..9cb89e0 100644 --- a/doc/docblocks.doc +++ b/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 diff --git a/doc/language.doc b/doc/language.doc index 10a7082..58a92ec 100644 --- a/doc/language.doc +++ b/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 @@ -63,6 +64,12 @@ when the translator was updated. <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> <TD>boris.bralo@NOSPAM.zg.tel.hr</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 diff --git a/doc/maintainers.txt b/doc/maintainers.txt index 488573d..5f2ec0c 100644 --- a/doc/maintainers.txt +++ b/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 diff --git a/libpng/libpng.pro.in b/libpng/libpng.pro.in index 5b731e3..34bfd32 100644 --- a/libpng/libpng.pro.in +++ b/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 diff --git a/packages/rpm/doxygen.spec b/packages/rpm/doxygen.spec index 3902a67..c468fe6 100644 --- a/packages/rpm/doxygen.spec +++ b/packages/rpm/doxygen.spec @@ -1,6 +1,6 @@ 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 diff --git a/qtools/qtools.pro.in b/qtools/qtools.pro.in index 57fc1ab..74776ef 100644 --- a/qtools/qtools.pro.in +++ b/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 diff --git a/src/bufstr.h b/src/bufstr.h index 9281d3e..21257c0 100644 --- a/src/bufstr.h +++ b/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; } @@ -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 diff --git a/src/commentcnv.h b/src/commentcnv.h new file mode 100644 index 0000000..41cd661 --- /dev/null +++ b/src/commentcnv.h @@ -0,0 +1,26 @@ +/***************************************************************************** + * + * + * + * 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 + diff --git a/src/commentcnv.l b/src/commentcnv.l new file mode 100644 index 0000000..d2da72c --- /dev/null +++ b/src/commentcnv.l @@ -0,0 +1,185 @@ +/***************************************************************************** + * + * + * + * 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); } +} + diff --git a/src/config.l b/src/config.l index 05b9b19..c3409d8 100644 --- a/src/config.l +++ b/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 diff --git a/src/defargs.l b/src/defargs.l index d736369..b88ef13 100644 --- a/src/defargs.l +++ b/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()); diff --git a/src/dot.cpp b/src/dot.cpp index 6ed5daa..c421c2c 100644 --- a/src/dot.cpp +++ b/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) diff --git a/src/doxygen.cpp b/src/doxygen.cpp index 499564e..5824c07 100644 --- a/src/doxygen.cpp +++ b/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 * **************************************************************************/ diff --git a/src/doxygen.pro.in b/src/doxygen.pro.in index 75ffd35..dbb006f 100644 --- a/src/doxygen.pro.in +++ b/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 diff --git a/src/doxytag.pro.in b/src/doxytag.pro.in index 090ec81..3016535 100644 --- a/src/doxytag.pro.in +++ b/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 diff --git a/src/filedef.cpp b/src/filedef.cpp index 7e4a2c1..177cfa6 100644 --- a/src/filedef.cpp +++ b/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); diff --git a/src/filedef.h b/src/filedef.h index 52be3f6..4841d1c 100644 --- a/src/filedef.h +++ b/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); diff --git a/src/htmlhelp.cpp b/src/htmlhelp.cpp index f179449..71941b5 100644 --- a/src/htmlhelp.cpp +++ b/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 << "\">"; } diff --git a/src/instdox.cpp b/src/instdox.cpp index 3e480dc..cd803cd 100644 --- a/src/instdox.cpp +++ b/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"; diff --git a/src/lang_cfg.h b/src/lang_cfg.h index 4e6639b..8c54688 100644 --- a/src/lang_cfg.h +++ b/src/lang_cfg.h @@ -22,3 +22,4 @@ #define LANG_SK #define LANG_UA #define LANG_GR +#define LANG_TW diff --git a/src/language.cpp b/src/language.cpp index 06c3d11..7c9494a 100644 --- a/src/language.cpp +++ b/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")) { diff --git a/src/latexgen.cpp b/src/latexgen.cpp index f851e19..4ecc4d1 100644 --- a/src/latexgen.cpp +++ b/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) diff --git a/src/libdoxycfg.pro.in b/src/libdoxycfg.pro.in index 98ea518..2455a5b 100644 --- a/src/libdoxycfg.pro.in +++ b/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 diff --git a/src/libdoxygen.pro.in b/src/libdoxygen.pro.in index 2d4cf8d..796ce76 100644 --- a/src/libdoxygen.pro.in +++ b/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 += . diff --git a/src/libdoxygen.t b/src/libdoxygen.t index ac3bc82..da0e45c 100644 --- a/src/libdoxygen.t +++ b/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 diff --git a/src/rtfgen.cpp b/src/rtfgen.cpp index 3d70b3a..d84c54f 100644 --- a/src/rtfgen.cpp +++ b/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")) diff --git a/src/rtfgen.h b/src/rtfgen.h index ddf6e7b..afa2df6 100644 --- a/src/rtfgen.h +++ b/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(); diff --git a/src/scanner.l b/src/scanner.l index 27c94ec..8bfa406 100644 --- a/src/scanner.l +++ b/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); } diff --git a/src/tagreader.cpp b/src/tagreader.cpp index d3c85ba..c40a442 100644 --- a/src/tagreader.cpp +++ b/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(); } diff --git a/src/translator_jp.h b/src/translator_jp.h index 1d7fe84..2e995a5 100644 --- a/src/translator_jp.h +++ b/src/translator_jp.h @@ -1,39 +1,37 @@ /****************************************************************************** -* -* -* -* 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("����Ū����ͳ�ˤ��Ƽ�������ޤ�������API�ˤϱƶ����ޤ���"); 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("����Ū����ͳ�ˤ��Ƽ�������ޤ�������API�ˤϱƶ����ޤ���"); /*! 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 - diff --git a/src/translator_tw.h b/src/translator_tw.h new file mode 100644 index 0000000..abd798a --- /dev/null +++ b/src/translator_tw.h @@ -0,0 +1,1378 @@ +/****************************************************************************** + * + * + * + * 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 "(���G�o�Ǥ��O�����禡)"; } + + /*! header that is put before the detailed description of files, classes and namespaces. */ + virtual QCString trDetailedDescription() + { return "�ԲӴy�z"; } + + /*! header that is put before the list of typedefs. */ + virtual QCString trMemberTypedefDocumentation() + { return "���A�w�q�����������"; } + + /*! header that is put before the list of enumerations. */ + virtual QCString trMemberEnumerationDocumentation() + { return "�C�|���A�����������"; } + + /*! 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 "��h..."; } + + /*! put in the class documentation */ + virtual QCString trListOfAllMembers() + { return "���������C��"; } + + /*! used as the title of the "list of all members" page of a class */ + virtual QCString trMemberList() + { return "�����C��"; } + + /*! this is the first part of a sentence that is followed by a class name */ + virtual QCString trThisIsTheListOfAllMembers() + { return "���㦨���C���A���O��"; } + + /*! this is the remainder of the sentence after the class name */ + virtual QCString trIncludingInheritedMembers() + { return ", �]�t�Ҧ��~�Ӫ�����"; } + + /*! 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+=" ����l�X���۰ʲ���."; + return result; + } + + /*! put after an enum name in the list of all members */ + virtual QCString trEnumName() + { return "�C�|���A�W��"; } + + /*! put after an enum value in the list of all members */ + virtual QCString trEnumValue() + { return "�C�|��"; } + + /*! put after an undocumented member in the list of all members */ + virtual QCString trDefinedIn() + { return "�Q�w�q��"; } + + // 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 "���O���h"; } + + /*! 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 "��Ƶ��c"; + } + else + { + return "�ƦX�C��"; + } + } + + /*! This is put above each page as a link to the list of documented files */ + virtual QCString trFileList() + { return "�ɮצC��"; } + + /*! This is put above each page as a link to the list of all verbatim headers */ + virtual QCString trHeaderFiles() + { return "���Y�ɮ�"; } + + /*! 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 "�ƦX����"; + } + } + + /*! 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 "�d��"; } + + /*! This is put above each page as a link to the search engine. */ + virtual QCString trSearch() + { return "�j�M"; } + + /*! This is an introduction to the class hierarchy. */ + virtual QCString trClassHierarchyDescription() + { return "�o���~�ӦC���g�L²�����r���Ƨ�: "; + } + + /*! This is an introduction to the list with all files. */ + virtual QCString trFileListDescription(bool extractAll) + { + QCString result="�o�O���a²������"; + if (!extractAll) result+="�B�g�L����"; + result+="���ɮצC��:"; + return result; + } + + /*! This is an introduction to the annotated compound list. */ + virtual QCString trCompoundListDescription() + { + + if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) + { + return "�o�O���a²����������Ƶ��c:"; + } + else + { + return "�o�O���a²�����������O�A���c�A" + "�p�X���A(unions)�Τ���(interfaces):"; + } + } + + /*! This is an introduction to the page with all class members. */ + virtual QCString trCompoundMembersDescription(bool extractAll) + { + QCString result="�o�O����"; + if (!extractAll) + { + result+="���ƹL"; + } + if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) + { + result+="���c���p�X���A���"; + } + else + { + result+="���O����"; + } + result+=", �åB�a���s����"; + if (extractAll) + { + if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) + { + result+="�C����쪺���c/�p�X���A�������:"; + } + else + { + result+="�C�Ӧ��������O�������:"; + } + } + else + { + if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) + { + result+="�o�ǵ��c/�p�X���A�O�ݩ�:"; + } + else + { + result+="�o�����O�O�ݩ�:"; + } + } + return result; + } + + /*! This is an introduction to the page with all file members. */ + virtual QCString trFileMembersDescription(bool extractAll) + { + QCString result="�o�O����"; + if (!extractAll) result+="���ƪ�"; + + if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) + { + result+="�禡�A�ܼơA�w�q�A�C�|�A�Ϋ��A�w�q"; + } + else + { + result+="�ɮצ���"; + } + result+="�A�åB�a���s����"; + if (extractAll) + result+="�o���ɮש���:"; + else + result+="�������:"; + return result; + } + + /*! This is an introduction to the page with the list of all header files. */ + virtual QCString trHeaderFilesDescription() + { return "�զ�API�����Y��:"; } + + /*! This is an introduction to the page with the list of all examples */ + virtual QCString trExamplesDescription() + { return "�Ҧ��d�ҦC��:"; } + + /*! This is an introduction to the page with the list of related pages */ + virtual QCString trRelatedPagesDescription() + { return "�Ҧ���������C��:"; } + + /*! This is an introduction to the page with the list of class/file groups */ + virtual QCString trModulesDescription() + { return "�Ҧ��ҲզC��:"; } + + /*! This sentences is used in the annotated class/file lists if no brief + * description is given. + */ + virtual QCString trNoDescriptionAvailable() + { return "�S���i�Ϊ������y�z"; } + + // 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 "���h����"; } + + /*! 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 "��Ƶ��c����"; + } + else + { + return "�ƦX����"; + } + } + + /*! 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 "��Ƶ��c�������"; + } + else + { + return "���O�������"; + } + } + + /*! 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 "�d�һ������"; } + + /*! 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 "�ѦҤ�U"; } + + /*! This is used in the documentation of a file as a header before the + * list of defines + */ + virtual QCString trDefines() + { return "�w�q"; } + + /*! 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 "���A�w�q"; } + + /*! This is used in the documentation of a file as a header before the + * list of enumerations + */ + virtual QCString trEnumerations() + { return "�C�|���A"; } + + /*! 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 "�C�|��"; } + + /*! This is used in the documentation of a file before the list of + * documentation blocks for defines + */ + virtual QCString trDefineDocumentation() + { return "�w�q�����������"; } + + /*! 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 "���A�w�q�������"; } + + /*! This is used in the documentation of a file/namespace before the list + * of documentation blocks for enumeration types + */ + virtual QCString trEnumerationTypeDocumentation() + { return "�C�|���A�������"; } + + /*! This is used in the documentation of a file/namespace before the list + * of documentation blocks for enumeration values + */ + virtual QCString trEnumerationValueDocumentation() + { return "�C�|�Ȼ������"; } + + /*! 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 "��Ƶ��c"; + } + else + { + return "�ƦX����"; + } + } + + /*! 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)", �M��:"+projName; + result+=(QCString)", ���;�:"; + return result; + } + /*! This is part of the sentence used in the standard footer of each page. + */ + virtual QCString trWrittenBy() + { + return "���g�H:"; + } + + /*! this text is put before a class diagram */ + virtual QCString trClassDiagram(const char *clName) + { + return (QCString)"���O"+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 "�]������]���s��@; ���v�TAPI."; } + + /*! this text is generated when the \\warning command is used. */ + virtual QCString trWarning() + { return "ĵ�i"; } + + /*! 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 "�R�W�Ŷ�(name space)�C��"; } + + /*! used as an introduction to the namespace list */ + virtual QCString trNamespaceListDescription(bool extractAll) + { + QCString result="�o�O�Ҧ����a²��������"; + if (!extractAll) result+="���ƪ�"; + result+="�R�W�Ŷ�(namespaces):"; + return result; + } + + /*! used in the class documentation as a header before the list of all + * friends of a class + */ + virtual QCString trFriends() + { return "���O�B��(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 "���O�B�ͤά����禡�������"; } + +////////////////////////////////////////////////////////////////////////// +// 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+=" ���O"; break; + case ClassDef::Struct: result+=" ���c"; break; + case ClassDef::Union: result+=" �p�X"; 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+=" �R�W�Ŷ�(Namespace)�ѦҤ��"; + return result; + } + + virtual QCString trPublicMembers() + { return "���}��k(Public Methods)"; } + virtual QCString trPublicSlots() + { return "���}����(Public Slots)"; } + virtual QCString trSignals() + { return "�T��(Signals)"; } + virtual QCString trStaticPublicMembers() + { return "�R�A���}��k(Static Public Methods)"; } + virtual QCString trProtectedMembers() + { return "�O�@��k(Protected Methods)"; } + virtual QCString trProtectedSlots() + { return "�O�@����(Protected Slots)"; } + virtual QCString trStaticProtectedMembers() + { return "�R�A�O�@��k(Static Protected Methods)"; } + virtual QCString trPrivateMembers() + { return "�p����k(Private Methods)"; } + virtual QCString trPrivateSlots() + { return "�p������(Private Slots)"; } + virtual QCString trStaticPrivateMembers() + { return "�R�A�p����k(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 "�Q "+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)+"���s��@."; + } + + /*! 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 "�b"+trWriteList(numEntries)+"���s��@."; + } + + /*! This is put above each page as a link to all members of namespaces. */ + virtual QCString trNamespaceMembers() + { return "�R�W�Ŷ�(Namespace)����"; } + + /*! This is an introduction to the page with all namespace members */ + virtual QCString trNamespaceMemberDescription(bool extractAll) + { + QCString result="���B�C�����Ҧ� "; + if (!extractAll) result+="���ƪ� "; + result+="�R�W�Ŷ�(namespace)�����A�åB���a�s���� "; + if (extractAll) + result+="�C�Ӧ������������:"; + else + result+="�өR�W�Ŷ����ݤ��B:"; + return result; + } + /*! This is used in LaTeX as the title of the chapter with the + * index of all namespaces. + */ + virtual QCString trNamespaceIndex() + { return "�R�W�Ŷ�(Namespace)����"; } + + /*! This is used in LaTeX as the title of the chapter containing + * the documentation of all namespaces. + */ + virtual QCString trNamespaceDocumentation() + { return "�R�W�Ŷ�(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 "�R�W�Ŷ�(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+="���O(class)"; break; + case ClassDef::Struct: result+="���c(structure)"; break; + case ClassDef::Union: result+="�p�X(union)"; break; + case ClassDef::Interface: result+="����(interface)"; break; + case ClassDef::Exception: result+="�ҥ~(exception)"; break; + } + result+=" ���O�ѤU�C�ɮפ�����"; + 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 "�r�����ǦC��"; } + +////////////////////////////////////////////////////////////////////////// +// 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 "�D����"; } + + /*! 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 "��l�X"; + } + virtual QCString trDefinedAtLineInSourceFile() + { + return "�w�q�b @1 �ɮפ��� @0 ��."; + } + virtual QCString trDefinedInSourceFile() + { + return "�w�q�b @0 ��."; + } + +////////////////////////////////////////////////////////////////////////// +// new since 0.49-991205 +////////////////////////////////////////////////////////////////////////// + + virtual QCString trDeprecated() + { + return "�L��"; + } + +////////////////////////////////////////////////////////////////////////// +// new since 1.0.0 +////////////////////////////////////////////////////////////////////////// + + /*! this text is put before a collaboration diagram */ + virtual QCString trCollaborationDiagram(const char *clName) + { + return (QCString)""+clName+"���X�@��:"; + } + /*! this text is put before an include dependency graph */ + virtual QCString trInclDepGraph(const char *fName) + { + return (QCString)""+fName+"���]�t�̹ۨ�:"; + } + /*! header that is put before the list of constructor/destructors. */ + virtual QCString trConstructorDocumentation() + { + return "�غc�l�P�Ѻc�l�������"; + } + /*! Used in the file documentation to point to the corresponding sources. */ + virtual QCString trGotoSourceCode() + { + return "�d�ݥ��ɮת���l�X."; + } + /*! Used in the file sources to point to the corresponding documentation. */ + virtual QCString trGotoDocumentation() + { + return "�d�ݥ��ɮ������."; + } + /*! Text for the \\pre command */ + virtual QCString trPrecondition() + { + return "�e�m����"; + } + /*! Text for the \\post command */ + virtual QCString trPostcondition() + { + return "��m����"; + } + /*! 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 "�{���X"; + } + virtual QCString trGraphicalHierarchy() + { + return "�ϧΤƤ����O���h"; + } + virtual QCString trGotoGraphicalHierarchy() + { + return "�d�ݹϧΤƤ����O���h"; + } + virtual QCString trGotoTextualHierarchy() + { + return "�d�ݤ�r�Ƥ����O���h"; + } + virtual QCString trPageIndex() + { + return "��������"; + } + +////////////////////////////////////////////////////////////////////////// +// new since 1.1.0 +////////////////////////////////////////////////////////////////////////// + + virtual QCString trNote() + { + return "��"; + } + virtual QCString trPublicTypes() + { + return "���}���A"; + } + virtual QCString trPublicAttribs() + { + if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C")) + { + return "������"; + } + else + { + return "���}�ݩ�"; + } + } + virtual QCString trStaticPublicAttribs() + { + return "�R�A���}�ݩ�"; + } + virtual QCString trProtectedTypes() + { + return "�O�@���A"; + } + virtual QCString trProtectedAttribs() + { + return "�O�@�ݩ�"; + } + virtual QCString trStaticProtectedAttribs() + { + return "�R�A�O�@�ݩ�"; + } + virtual QCString trPrivateTypes() + { + return "�p�����A"; + } + virtual QCString trPrivateAttribs() + { + return "�p���ݩ�"; + } + virtual QCString trStaticPrivateAttribs() + { + return "�R�A�p���ݩ�"; + } + +////////////////////////////////////////////////////////////////////////// +// 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 "�ݿ�ƶ��C��"; + } + +////////////////////////////////////////////////////////////////////////// +// new since 1.1.4 +////////////////////////////////////////////////////////////////////////// + + virtual QCString trReferencedBy() + { + return "�Q�Ѧҩ�"; + } + virtual QCString trRemarks() + { + return "�Ƶ�"; + } + virtual QCString trAttention() + { + return "�`�N"; + } + virtual QCString trInclByDepGraph() + { + return "������ܥX�����ɮת����ζ���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 + "���������p���Ķ�o�ǥ�doxygen�Ҳ��ͪ��ϥ� " + ".<p>\n" + "�ЬݤU���d��:\n" + "\\code\n" + "/*! �]���I�_�����i�����O */\n" + "class Invisible { };\n\n" + "/*! �I�_�����O, �~�����Y�Q���� */\n" + "class Truncated : public Invisible { };\n\n" + "/* ���g�Ldoxygen���ѳB�z�L�����O */\n" + "class Undocumented { };\n\n" + "/*! �g�L���}(Public)�~�Ӫ����O */\n" + "class PublicBase : public Truncated { };\n\n" + "/*! �@�Ӽ˪����O */\n" + "template<class T> class Templ { };\n\n" + "/*! �ϥΫO�@(Protected)�~�Ӫ����O */\n" + "class ProtectedBase { };\n\n" + "/*! �ϥΨp��(Private)�~�Ӫ����O */\n" + "class PrivateBase { };\n\n" + "/*! �ѳQ�~�����O�ҨϥΪ����O */\n" + "class Used { };\n\n" + "/*! �ѼƭӨ�L���O���~�ӨӪ��W���O(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" + "�Y�b�պA�ɤ��� \\c MAX_DOT_GRAPH_HEIGHT tag " + "�]�� 240�A�N�|���ͤU�C���ϥ�:" + "<p><center><img src=\"graph_legend."+Config_getEnum("DOT_IMAGE_FORMAT")+"\"></center>\n" + "<p>\n" + "�W�Ϥ����U�϶��N�q�p�U:\n" + "<ul>\n" + "<li>%A �¦⪺�϶��N�����ͳo�ӹϥܪ����O�ε��c " + ".\n" + "<li>%A ���䪺�϶��N�����ƹL�����c�����O.\n" + "<li>%A ���䪺�϶��N�����g���ƪ����c�άO���O.\n" + "<li>%A ���䪺�϶��N�����ƪ����c�άO���O�A" + "�o�ǵ��c�����O���~�өΥ]�t���Y���|�������. %A �ϥ� " + "�Y�L�k��J���w����ɤ��N�|�Q�I�_.\n" + "</ul>\n" + "�b�Y�㦳�U�����N�q:\n" + "<ul>\n" + "<li>%A �`�Ŧ�b�Y�ΨӥN��������O�������}�~�� " + "���Y.\n" + "<li>%A �`���b�Y�N���O�@�~��.\n" + "<li>%A �`����b�Y�N���p���~��.\n" + "<li>%A ����b�Y�ΨӪ������O�Q�t�@�ӥ]�t�άO�ϥ�." + "�b�Y�W�Хܵۥi�s�������O�άO���c�������ܼ�" + ".\n" + "<li>%A ����b�Y�N���˪�����P�˪����O���������Y�C" + "�b�Y�W�аO�ۼ˪�����W���Ѽ�" + ".\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 "���ն��ئC��"; + } + +////////////////////////////////////////////////////////////////////////// +// new since 1.2.1 +////////////////////////////////////////////////////////////////////////// + + /*! Used as a section header for KDE-2 IDL methods */ + virtual QCString trDCOPMethods() + { + return "DCOP��k"; + } + +////////////////////////////////////////////////////////////////////////// +// 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 "��Ƶ��c"; + } + else + { + return "���O"; + } + } + /*! 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�C��"; + } + /*! The description of the package index page */ + virtual QCString trPackageListDescription() + { + return "���B��Package����������(�p�G������):"; + } + /*! 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 "���ΦC��"; + } + +////////////////////////////////////////////////////////////////////////// +// 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("���O"); + } + + /*! 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("�R�W�Ŷ�"); + } + + /*! 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("�s��"); + } + + /*! 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 diff --git a/src/util.cpp b/src/util.cpp index 66d87bf..d55b53d 100644 --- a/src/util.cpp +++ b/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 |