From 97a3911e2682bfebeebbb8999c9e3844c414c3e0 Mon Sep 17 00:00:00 2001 From: dimitri Date: Thu, 15 Mar 2007 10:14:23 +0000 Subject: Release-1.5.1-20070315 --- INSTALL | 4 +- README | 4 +- addon/doxyapp/doxyapp.cpp | 2 +- configure | 2 +- doc/commands.doc | 55 +++++++++++++++ doc/config.doc | 10 +++ doc/faq.doc | 39 ++-------- doc/language.doc | 4 +- doc/translator_report.txt | 2 +- qtools/qcstring.cpp | 2 +- qtools/qcstring.h | 1 + qtools/scstring.cpp | 9 ++- src/cmdmapper.cpp | 2 + src/cmdmapper.h | 10 +-- src/commentcnv.l | 6 +- src/commentscan.l | 5 +- src/config.l | 53 +++++++++----- src/docparser.cpp | 12 ++++ src/docparser.h | 4 +- src/doctokenizer.h | 1 + src/doctokenizer.l | 33 +++++++-- src/ftvhelp.cpp | 3 + src/htmldocvisitor.cpp | 46 ++++++++++++ src/htmldocvisitor.h | 1 + src/latexdocvisitor.cpp | 48 +++++++++++++ src/latexdocvisitor.h | 1 + src/latexgen.cpp | 13 ++-- src/libdoxygen.pro.in | 2 + src/mandocvisitor.cpp | 1 + src/memberdef.cpp | 5 +- src/msc.cpp | 172 +++++++++++++++++++++++++++++++++++++++++++++ src/msc.h | 32 +++++++++ src/perlmodgen.cpp | 1 + src/portable.cpp | 11 +-- src/portable.h | 2 +- src/printdocvisitor.h | 2 + src/pyscanner.l | 2 +- src/rtfdocvisitor.cpp | 45 ++++++++++++ src/rtfdocvisitor.h | 1 + src/scanner.l | 40 +++++++++-- src/translator_br.h | 5 +- src/translator_ca.h | 2 +- src/translator_cn.h | 5 +- src/translator_de.h | 2 +- src/translator_dk.h | 2 +- src/translator_en.h | 2 +- src/translator_es.h | 4 +- src/translator_fr.h | 2 +- src/translator_gr.h | 5 +- src/translator_hr.h | 5 +- src/translator_hu.h | 2 +- src/translator_id.h | 2 +- src/translator_it.h | 5 +- src/translator_jp.h | 5 +- src/translator_kr.h | 2 +- src/translator_lt.h | 2 +- src/translator_nl.h | 5 +- src/translator_no.h | 4 +- src/translator_pl.h | 5 +- src/translator_pt.h | 5 +- src/translator_ro.h | 5 +- src/translator_se.h | 2 +- src/translator_si.h | 5 +- src/translator_sk.h | 9 ++- src/translator_sr.h | 2 +- src/translator_tw.h | 2 +- src/translator_ua.h | 5 +- src/translator_za.h | 2 +- src/translatordecoder.h | 2 +- src/util.cpp | 8 ++- src/xmldocvisitor.cpp | 5 ++ winbuild/Doxygen.vcproj | 12 ++++ winbuild/Doxywizard.vcproj | 16 +++-- 73 files changed, 694 insertions(+), 140 deletions(-) create mode 100644 src/msc.cpp create mode 100644 src/msc.h diff --git a/INSTALL b/INSTALL index 5adbe97..f6d7452 100644 --- a/INSTALL +++ b/INSTALL @@ -1,7 +1,7 @@ -DOXYGEN Version 1.5.1-20070219 +DOXYGEN Version 1.5.1-20070315 Please read the installation section of the manual (http://www.doxygen.org/install.html) for instructions. -------- -Dimitri van Heesch (19 February 2007) +Dimitri van Heesch (15 March 2007) diff --git a/README b/README index 2a5e75d..2717100 100644 --- a/README +++ b/README @@ -1,4 +1,4 @@ -DOXYGEN Version 1.5.1_20070219 +DOXYGEN Version 1.5.1_20070315 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) (19 February 2007) +Dimitri van Heesch (dimitri@stack.nl) (15 March 2007) diff --git a/addon/doxyapp/doxyapp.cpp b/addon/doxyapp/doxyapp.cpp index b453815..4c4b3f4 100644 --- a/addon/doxyapp/doxyapp.cpp +++ b/addon/doxyapp/doxyapp.cpp @@ -40,7 +40,7 @@ class XRefDummyCodeGenerator : public CodeOutputInterface // these are just null functions, they can be used to produce a syntax highlighted // and cross-linked version of the source code, but who needs that anyway ;-) void codify(const char *) {} - void writeCodeLink(const char *,const char *,const char *,const char *) {} + void writeCodeLink(const char *,const char *,const char *,const char *,const char *) {} void startCodeLine() {} void endCodeLine() {} void startCodeAnchor(const char *) {} diff --git a/configure b/configure index ba19263..1eff54a 100755 --- a/configure +++ b/configure @@ -20,7 +20,7 @@ doxygen_version_minor=5 doxygen_version_revision=1 #NOTE: Setting version_mmn to "NO" will omit mmn info from the package. -doxygen_version_mmn=20070219 +doxygen_version_mmn=20070315 bin_dirs=`echo $PATH | sed -e "s/:/ /g"` diff --git a/doc/commands.doc b/doc/commands.doc index 1b03dbb..298f492 100644 --- a/doc/commands.doc +++ b/doc/commands.doc @@ -74,6 +74,7 @@ documentation: \refitem cmdendlatexonly \\endlatexonly \refitem cmdendlink \\endlink \refitem cmdendmanonly \\endmanonly +\refitem cmdendmsc \\endmsc \refitem cmdendverbatim \\endverbatim \refitem cmdendxmlonly \\endxmlonly \refitem cmdenum \\enum @@ -102,6 +103,7 @@ documentation: \refitem cmdlink \\link \refitem cmdmainpage \\mainpage \refitem cmdmanonly \\manonly +\refitem cmdmsc \\msc \refitem cmdn \\n \refitem cmdname \\name \refitem cmdnamespace \\namespace @@ -1779,6 +1781,53 @@ class C {}; \endcode
+\section cmdmsc \\msc + + \addindex \\msc + Starts a text fragment which should contain a valid description of a + message sequence chart. See http://www.mcternan.me.uk/mscgen/ for examples. + The text fragment ends with \ref cmdendmsc "\\endmsc". + \note The text fragment should only include the part of the message + sequence chart that is + within the msc {...} block. + \note You need to install the mscgen tool, if you want to use this + command. + +Here is an example of the use of the \\msc command. +\code +/** Sender class. Can be used to send a command to the server. + * The receiver will acknowlegde the command by calling Ack(). + * \msc + * Sender,Receiver; + * Sender->Receiver [label="Command()", URL="\ref Receiver::Command()"]; + * Sender<-Receiver [label="Ack()", URL="\ref Ack()", ID="1"]; + * \endmsc + */ +class Sender +{ + public: + /** Acknowledgement from server */ + void Ack(bool ok); +}; + +/** Receiver class. Can be used to receive and execute commands. + * After execution of a command, the receiver will send an acknowledgement + * \msc + * Receiver,Sender; + * Receiver<-Sender [label="Command()", URL="\ref Command()"]; + * Receiver->Sender [label="Ack()", URL="\ref Sender::Ack()", ID="1"]; + * \endmsc + */ +class Receiver +{ + public: + /** Executable a command on the server */ + void Command(int commandId); +}; + +\endcode + +
\section cmddotfile \\dotfile ["caption"] \addindex \\dotfile @@ -1845,6 +1894,12 @@ class C {}; Ends a blocks that was started with \ref cmddot "\\dot".
+\section cmdendmsc \\endmsc + + \addindex \\endmsc + Ends a blocks that was started with \ref cmdmsc "\\msc". + +
\section cmdendhtmlonly \\endhtmlonly \addindex \\endhtmlonly diff --git a/doc/config.doc b/doc/config.doc index e1c9481..8801aa1 100644 --- a/doc/config.doc +++ b/doc/config.doc @@ -163,6 +163,7 @@ followed by the descriptions of the tags grouped by category. \refitem cfg_man_links MAN_LINKS \refitem cfg_man_output MAN_OUTPUT \refitem cfg_max_initializer_lines MAX_INITIALIZER_LINES +\refitem cfg_mscgen_path MSCGEN_PATH \refitem cfg_multiline_cpp_is_brief MULTILINE_CPP_IS_BRIEF \refitem cfg_optimize_output_for_c OPTIMIZE_OUTPUT_FOR_C \refitem cfg_optimize_output_java OPTIMIZE_OUTPUT_JAVA @@ -1635,6 +1636,15 @@ TAGFILES = file1=loc1 "file2 = loc2" ... This is only a fallback. It is recommended to install and use dot, since it yields more powerful graphs. +\anchor cfg_mscgen_path +
\c MSCGEN_PATH
+ \addindex MSCGEN_PATH + You can define message sequence charts within doxygen comments using the \ref cmdmsc "\\msc" + command. Doxygen will then run the msgen tool) to + produce the chart and insert it in the documentation. The MSCGEN_PATH tag allows you to + specify the directory where the mscgen tool resides. If left empty the tool is assumed to + be found in the default search path. + \anchor cfg_have_dot
\c HAVE_DOT
\addindex HAVE_DOT diff --git a/doc/faq.doc b/doc/faq.doc index 8ade978..51f3c24 100644 --- a/doc/faq.doc +++ b/doc/faq.doc @@ -237,39 +237,12 @@ various buffers and then run "texconfig init".
  • Why are dependencies via STL classes not shown in the dot graphs? -Doxygen is unware of the STL classes, so it does not know that class A relates -to class B in the following example - -\code -#include - -using namespace std; - -class B {}; - -class A -{ - public: - vector m_bvec; -}; -\endcode - -To overcome this problem you could provide the definition of the vector -class to doxygen (by including the file that defines it at the INPUT tag -in the config file). Since STL header files are often messy, a -(possibly) better approach is to include a dummy definition of a vector -class to the input. Here is an example of a dummy STL file for the vector -class: - -\code -namespace std { - /*! STL vector class */ - template class vector { public: T element; }; -} -\endcode - -I'm still looking for someone who can provide me with definitions -for all (relevant) STL classes. +Doxygen is unware of the STL classes, unless the option BUILTIN_STL_SUPPORT is +turned on. + +
  • I have problems getting the search engine to work with PHP5 and/or windows + +Please read this for hints on where to look.
  • Can I configure doxygen from the command line? diff --git a/doc/language.doc b/doc/language.doc index e2f9114..c304eec 100644 --- a/doc/language.doc +++ b/doc/language.doc @@ -1,7 +1,7 @@ /****************************************************************************** * Do not edit this file. It was generated by the translator.py script. * - * Copyright (C) 1997-2007 by Dimitri van Heesch. + * Copyright (C) 1997-2006 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 @@ -23,7 +23,7 @@ text fragments, generated by doxygen, can be produced in languages other than English (the default). The output language is chosen through the configuration file (with default name and known as Doxyfile). -Currently (version 1.5.1), 33 languages +Currently (version 1.5.1-20070219), 33 languages are supported (sorted alphabetically): Afrikaans, Arabic, Brazilian Portuguese, Catalan, Chinese, Chinese Traditional, Croatian, Czech, Danish, Dutch, English, Finnish, French, diff --git a/doc/translator_report.txt b/doc/translator_report.txt index 1f65482..2b351ed 100644 --- a/doc/translator_report.txt +++ b/doc/translator_report.txt @@ -1,4 +1,4 @@ -(1.5.1) +(1.5.1-20070219) Doxygen supports the following 33 languages (sorted alphabetically): diff --git a/qtools/qcstring.cpp b/qtools/qcstring.cpp index 1bd7c7f..e0e53e4 100644 --- a/qtools/qcstring.cpp +++ b/qtools/qcstring.cpp @@ -58,7 +58,7 @@ QCString::QCString( const char *str, uint maxlen ) if (str && ( l = QMIN(qstrlen(str),maxlen) )) { m_data=(char *)malloc(l+1); - strncpy(m_data,str,maxlen); + strncpy(m_data,str,l+1); m_data[l]='\0'; } else diff --git a/qtools/qcstring.h b/qtools/qcstring.h index e56b1e4..8df3bfd 100644 --- a/qtools/qcstring.h +++ b/qtools/qcstring.h @@ -50,6 +50,7 @@ #include #endif + class QGString; /***************************************************************************** diff --git a/qtools/scstring.cpp b/qtools/scstring.cpp index 18a5492..5632f57 100644 --- a/qtools/scstring.cpp +++ b/qtools/scstring.cpp @@ -13,10 +13,17 @@ * */ +// with this switch you can choose between the original qcstring implementation, +// which implicitly shares data so copying is faster, but requires at least 12 bytes, and +// the new implementation in this file, which has a smaller footprint (only 4 bytes for +// an empty string), but always copies strings. +#define SMALLSTRING + #include "qcstring.h" #ifndef SMALLSTRING #include "qcstring.cpp" #else +#define SCString QCString #include #include @@ -60,7 +67,7 @@ SCString::SCString( const char *str, uint maxlen ) if (str && ( l = QMIN(qstrlen(str),maxlen) )) { m_data=(char *)malloc(l+1); - strncpy(m_data,str,maxlen); + strncpy(m_data,str,l+1); m_data[l]='\0'; } else diff --git a/src/cmdmapper.cpp b/src/cmdmapper.cpp index da66f45..352095c 100644 --- a/src/cmdmapper.cpp +++ b/src/cmdmapper.cpp @@ -102,7 +102,9 @@ CommandMap cmdMap[] = { "%", CMD_PERCENT }, { "_internalref", CMD_INTERNALREF }, { "dot", CMD_DOT }, + { "msc", CMD_MSC }, { "enddot", CMD_ENDDOT }, + { "endmsc", CMD_ENDMSC }, { "manonly", CMD_MANONLY }, { "endmanonly", CMD_ENDMANONLY }, { "includelineno", CMD_INCWITHLINES }, diff --git a/src/cmdmapper.h b/src/cmdmapper.h index 1ef3053..586e766 100644 --- a/src/cmdmapper.h +++ b/src/cmdmapper.h @@ -104,10 +104,12 @@ enum CommandType CMD_XMLONLY = 70, CMD_DOT = 71, CMD_ENDDOT = 72, - CMD_MANONLY = 73, - CMD_ENDMANONLY = 74, - CMD_INCWITHLINES = 75, - CMD_INHERITDOC = 76 + CMD_MSC = 73, + CMD_ENDMSC = 74, + CMD_MANONLY = 75, + CMD_ENDMANONLY = 76, + CMD_INCWITHLINES = 77, + CMD_INHERITDOC = 78 }; enum HtmlTagType diff --git a/src/commentcnv.l b/src/commentcnv.l index 25a0f1a..238e56b 100644 --- a/src/commentcnv.l +++ b/src/commentcnv.l @@ -323,7 +323,7 @@ CHARLIT (("'"\\[0-7]{1,3}"'")|("'"\\."'")|("'"[^' \\\n]{1,4}"'")) copyToOutput(yytext,yyleng); BEGIN(CComment); } -[\\@]("dot"|"code")/[^a-z_A-Z0-9] { /* start of a verbatim block */ +[\\@]("dot"|"code"|"msc")/[^a-z_A-Z0-9] { /* start of a verbatim block */ copyToOutput(yytext,yyleng); g_lastCommentContext = YY_START; g_blockName=&yytext[1]; @@ -352,7 +352,7 @@ CHARLIT (("'"\\[0-7]{1,3}"'")|("'"\\."'")|("'"[^' \\\n]{1,4}"'")) . { /* any other character */ copyToOutput(yytext,yyleng); } -[\\@]("endverbatim"|"endlatexonly"|"endhtmlonly"|"endxmlonly"|"endrtfonly"|"endmanonly"|"enddot"|"endcode"|"f$"|"f]"|"f}") { /* end of verbatim block */ +[\\@]("endverbatim"|"endlatexonly"|"endhtmlonly"|"endxmlonly"|"endrtfonly"|"endmanonly"|"f$"|"f]"|"f}") { /* end of verbatim block */ copyToOutput(yytext,yyleng); if (yytext[1]=='f') // end of formula { @@ -363,7 +363,7 @@ CHARLIT (("'"\\[0-7]{1,3}"'")|("'"\\."'")|("'"[^' \\\n]{1,4}"'")) BEGIN(g_lastCommentContext); } } -[\\@]("enddot"|"endcode") { /* end of verbatim block */ +[\\@]("enddot"|"endcode"|"endmsc") { /* end of verbatim block */ copyToOutput(yytext,yyleng); if (&yytext[4]==g_blockName) { diff --git a/src/commentscan.l b/src/commentscan.l index ec58264..105d512 100644 --- a/src/commentscan.l +++ b/src/commentscan.l @@ -170,6 +170,7 @@ static DocCmdMap docCmdMap[] = { "rtfonly", &handleFormatBlock, FALSE }, { "manonly", &handleFormatBlock, FALSE }, { "dot", &handleFormatBlock, TRUE }, + { "msc", &handleFormatBlock, TRUE }, { "code", &handleFormatBlock, TRUE }, { "addindex", &handleAddIndex, TRUE }, { "if", &handleIf, FALSE }, @@ -742,7 +743,7 @@ static int yyread(char *buf,int max_size) /* start command character */ CMD ("\\"|"@") DCMD1 ("arg"|"attention"|"author"|"code") -DCMD2 ("date"|"dot"|"dotfile"|"example") +DCMD2 ("date"|"dot"|"msc"|"dotfile"|"example") DCMD3 ("htmlinclude"|"htmlonly"|"image"|"include") DCMD4 ("includelineno"|"internal"|"invariant") DCMD5 ("latexonly"|"li"|"line"|"manonly"|"name") @@ -1488,7 +1489,7 @@ MAILADR [a-z_A-Z0-9.+\-]+"@"[a-z_A-Z0-9\-]+("."[a-z_A-Z0-9\-]+)+[a-z_A-Z0-9\-] /* ----- handle arguments of the preformatted block commands ------- */ -{CMD}("endverbatim"|"endlatexonly"|"endhtmlonly"|"endxmlonly"|"endrtfonly"|"endmanonly"|"enddot"|"endcode")/{NW} { // possible ends +{CMD}("endverbatim"|"endlatexonly"|"endhtmlonly"|"endxmlonly"|"endrtfonly"|"endmanonly"|"enddot"|"endcode"|"endmsc")/{NW} { // possible ends addOutput(yytext); if (&yytext[4]==blockName) // found end of the block { diff --git a/src/config.l b/src/config.l index 2818b0a..b1ea378 100644 --- a/src/config.l +++ b/src/config.l @@ -363,7 +363,7 @@ static QCString configStringRecode( { outputSize-=oLeft; output.resize(outputSize+1); - output.at(outputSize+1)='\0'; + output.at(outputSize)='\0'; //printf("iconv: input size=%d output size=%d\n[%s]\n",size,newSize,srcBuf.data()); } else @@ -1089,21 +1089,7 @@ void Config::check() QCString &dotPath = Config_getString("DOT_PATH"); if (!dotPath.isEmpty()) { - if (dotPath.find('\\')!=-1) - { - if (dotPath.at(dotPath.length()-1)!='\\') - { - dotPath+='\\'; - } - } - else if (dotPath.find('/')!=-1) - { - if (dotPath.at(dotPath.length()-1)!='/') - { - dotPath+='/'; - } - } - QFileInfo dp(dotPath+portable_dotCommand()); + QFileInfo dp(dotPath+"/dot"+portable_commandExtension()); if (!dp.exists() || !dp.isFile()) { config_err("Warning: the dot tool could not be found at %s\n",dotPath.data()); @@ -1122,6 +1108,31 @@ void Config::check() { dotPath=""; } + + // check mscgen path + QCString &mscgenPath = Config_getString("MSCGEN_PATH"); + if (!mscgenPath.isEmpty()) + { + QFileInfo dp(mscgenPath+"/mscgen"+portable_commandExtension()); + if (!dp.exists() || !dp.isFile()) + { + config_err("Warning: the mscgen tool could not be found at %s\n",mscgenPath.data()); + mscgenPath=""; + } + else + { + mscgenPath=dp.dirPath(TRUE)+"/"; +#if defined(_WIN32) // convert slashes + uint i=0,l=mscgenPath.length(); + for (i=0;iverb,DocVerbatim::Msc,g_isExample,g_exampleName)); + if (retval==0) warn_doc_error(g_fileName,doctokenizerYYlineno,"Warning: msc section ended without end marker"); + doctokenizerYYsetStatePara(); + } + break; case CMD_ENDCODE: case CMD_ENDHTMLONLY: case CMD_ENDMANONLY: @@ -4402,6 +4411,9 @@ int DocPara::handleCommand(const QString &cmdName) case CMD_ENDDOT: warn_doc_error(g_fileName,doctokenizerYYlineno,"Warning: unexpected command %s",g_token->name.data()); break; + case CMD_ENDMSC: + warn_doc_error(g_fileName,doctokenizerYYlineno,"Warning: unexpected command %s",g_token->name.data()); + break; case CMD_PARAM: retval = handleParamSection(cmdName,DocParamSect::Param,FALSE,g_token->paramDir); break; diff --git a/src/docparser.h b/src/docparser.h index 7f074e4..7d09ac5 100644 --- a/src/docparser.h +++ b/src/docparser.h @@ -362,7 +362,7 @@ class DocWhiteSpace : public DocNode class DocVerbatim : public DocNode { public: - enum Type { Code, HtmlOnly, ManOnly, LatexOnly, XmlOnly, Verbatim, Dot }; + enum Type { Code, HtmlOnly, ManOnly, LatexOnly, XmlOnly, Verbatim, Dot, Msc }; DocVerbatim(DocNode *parent,const QString &context, const QString &text, Type t,bool isExample, const QString &exampleFile); @@ -374,7 +374,7 @@ class DocVerbatim : public DocNode void accept(DocVisitor *v) { v->visit(this); } bool isExample() const { return m_isExample; } QString exampleFile() const { return m_exampleFile; } - QString relPath() const { return m_relPath; } + QString relPath() const { return m_relPath; } private: DocNode *m_parent; diff --git a/src/doctokenizer.h b/src/doctokenizer.h index 301f79b..7e6e521 100644 --- a/src/doctokenizer.h +++ b/src/doctokenizer.h @@ -133,6 +133,7 @@ void doctokenizerYYsetStateLatexOnly(); void doctokenizerYYsetStateXmlOnly(); void doctokenizerYYsetStateVerbatim(); void doctokenizerYYsetStateDot(); +void doctokenizerYYsetStateMsc(); void doctokenizerYYsetStateParam(); void doctokenizerYYsetStateXRefItem(); void doctokenizerYYsetStateFile(); diff --git a/src/doctokenizer.l b/src/doctokenizer.l index d26db37..8fd3856 100644 --- a/src/doctokenizer.l +++ b/src/doctokenizer.l @@ -358,6 +358,7 @@ REFWORD ("#"|"::")?({ID}("."|"#"|"::"|"-"|"/"))*({ID}(":")?){FUNCARG}? %x St_XmlOnly %x St_Verbatim %x St_Dot +%x St_Msc %x St_Param %x St_XRefItem %x St_XRefItem2 @@ -602,17 +603,25 @@ REFWORD ("#"|"::")?({ID}("."|"#"|"::"|"-"|"/"))*({ID}(":")?){FUNCARG}? g_token->verb=stripEmptyLines(g_token->verb); return RetVal_OK; } -[^\\@\n]+ | -\n | -. { /* Verbatim text */ +[^\\@\n]+ | +\n | +. { /* Verbatim text */ g_token->verb+=yytext; } -{CMD}"enddot" { +{CMD}"enddot" { return RetVal_OK; } -[^\\@\n]+ | -\n | -. { /* dot text */ +[^\\@\n]+ | +\n | +. { /* dot text */ + g_token->verb+=yytext; + } +{CMD}"endmsc" { + return RetVal_OK; + } +[^\\@\n]+ | +\n | +. { /* msc text */ g_token->verb+=yytext; } "\"" { // quoted title @@ -844,6 +853,10 @@ REFWORD ("#"|"::")?({ID}("."|"#"|"::"|"-"|"/"))*({ID}(":")?){FUNCARG}? g_endMarker="enddot"; BEGIN(St_SecSkip); } +{CMD}"msc"/[^a-z_A-Z0-9] { + g_endMarker="endmsc"; + BEGIN(St_SecSkip); + } {CMD}"htmlonly"/[^a-z_A-Z0-9] { g_endMarker="endhtmlonly"; BEGIN(St_SecSkip); @@ -1006,6 +1019,12 @@ void doctokenizerYYsetStateDot() BEGIN(St_Dot); } +void doctokenizerYYsetStateMsc() +{ + g_token->verb=""; + BEGIN(St_Msc); +} + void doctokenizerYYsetStateParam() { BEGIN(St_Param); diff --git a/src/ftvhelp.cpp b/src/ftvhelp.cpp index e72da91..5be662d 100644 --- a/src/ftvhelp.cpp +++ b/src/ftvhelp.cpp @@ -611,6 +611,9 @@ void FTVHelp::generateTreeView() t << "" << endl; t << " " << endl; t << " " << endl; + t << " " << endl; + t << " <a href=\"main.html\">Frames are disabled. Click here to go to the main page.</a>" << endl; + t << " " << endl; t << "" << endl; t << "" << endl; f.close(); diff --git a/src/htmldocvisitor.cpp b/src/htmldocvisitor.cpp index 4f1034f..e7910b5 100644 --- a/src/htmldocvisitor.cpp +++ b/src/htmldocvisitor.cpp @@ -27,6 +27,7 @@ #include "config.h" #include "htmlgen.h" #include "parserintf.h" +#include "msc.h" static const int NUM_HTML_LIST_TYPES = 4; @@ -248,6 +249,33 @@ void HtmlDocVisitor::visit(DocVerbatim *s) if (Config_getBool("DOT_CLEANUP")) file.remove(); } break; + case DocVerbatim::Msc: + { + static int mscindex = 1; + QCString baseName(4096); + + baseName.sprintf("%s%d", + (Config_getString("HTML_OUTPUT")+"/inline_mscgraph_").data(), + mscindex++ + ); + QFile file(baseName+".msc"); + if (!file.open(IO_WriteOnly)) + { + err("Could not open file %s.msc for writing\n",baseName.data()); + } + QCString text = "msc {"; + text+=s->text(); + text+="}"; + file.writeBlock( text, text.length() ); + file.close(); + + m_t << "
    " << endl; + writeMscFile(baseName,s->relPath()); + m_t << "
    " << endl; + + if (Config_getBool("DOT_CLEANUP")) file.remove(); + } + break; } } @@ -1131,3 +1159,21 @@ void HtmlDocVisitor::writeDotFile(const QString &fileName,const QString &relPath m_t << "" << imap << "" << endl; } +void HtmlDocVisitor::writeMscFile(const QString &fileName,const QString &relPath) +{ + QString baseName=fileName; + int i; + if ((i=baseName.findRev('/'))!=-1) + { + baseName=baseName.right(baseName.length()-i-1); + } + QString outDir = Config_getString("HTML_OUTPUT"); + writeMscGraphFromFile(fileName,outDir,baseName,MSC_BITMAP); + QString mapName = baseName+".map"; + QString mapFile = fileName+".map"; + m_t << "\""" << endl; + QString imap = getMscImageMapFromFile(fileName,outDir,relPath.data()); + m_t << "" << imap << "" << endl; +} + diff --git a/src/htmldocvisitor.h b/src/htmldocvisitor.h index 7dedf88..db4d6fc 100644 --- a/src/htmldocvisitor.h +++ b/src/htmldocvisitor.h @@ -136,6 +136,7 @@ class HtmlDocVisitor : public DocVisitor const QString &tooltip = QString::null); void endLink(); void writeDotFile(const QString &fileName,const QString &relPath); + void writeMscFile(const QString &fileName,const QString &relPath); void pushEnabled(); void popEnabled(); diff --git a/src/latexdocvisitor.cpp b/src/latexdocvisitor.cpp index 9426a1e..76bff77 100644 --- a/src/latexdocvisitor.cpp +++ b/src/latexdocvisitor.cpp @@ -25,6 +25,7 @@ #include "util.h" #include "message.h" #include "parserintf.h" +#include "msc.h" static QString escapeLabelName(const char *s) { @@ -302,6 +303,33 @@ void LatexDocVisitor::visit(DocVerbatim *s) if (Config_getBool("DOT_CLEANUP")) file.remove(); } break; + case DocVerbatim::Msc: + { + static int mscindex = 1; + QCString baseName(4096); + + baseName.sprintf("%s%d", + (Config_getString("LATEX_OUTPUT")+"/inline_mscgraph_").data(), + mscindex++ + ); + QFile file(baseName+".msc"); + if (!file.open(IO_WriteOnly)) + { + err("Could not open file %s.msc for writing\n",baseName.data()); + } + QCString text = "msc {"; + text+=s->text(); + text+="}"; + file.writeBlock( text, text.length() ); + file.close(); + + m_t << "\\begin{center}\n"; + writeMscFile(baseName); + m_t << "\\end{center}\n"; + + if (Config_getBool("DOT_CLEANUP")) file.remove(); + } + break; } } @@ -1141,3 +1169,23 @@ void LatexDocVisitor::endDotFile(bool hasCaption) } } +void LatexDocVisitor::writeMscFile(const QString &baseName) +{ + QString outDir = Config_getString("LATEX_OUTPUT"); + writeMscGraphFromFile(baseName,outDir,baseName,MSC_EPS); + m_t << "\\begin{ImageNoCaption}\\mbox{"; + m_t << "\\includegraphics"; + //if (!width.isEmpty()) + //{ + // m_t << "[width=" << width << "]"; + //} + //else if (!height.isEmpty()) + //{ + // m_t << "[height=" << height << "]"; + //} + m_t << "{" << baseName << "}"; + + m_t << "}" << endl; // end mbox + m_t << "\\end{ImageNoCaption}" << endl; +} + diff --git a/src/latexdocvisitor.h b/src/latexdocvisitor.h index 62f1011..562d299 100644 --- a/src/latexdocvisitor.h +++ b/src/latexdocvisitor.h @@ -143,6 +143,7 @@ class LatexDocVisitor : public DocVisitor void startDotFile(const QString &fileName,const QString &width, const QString &height, bool hasCaption); void endDotFile(bool hasCaption); + void writeMscFile(const QString &fileName); void pushEnabled(); void popEnabled(); diff --git a/src/latexgen.cpp b/src/latexgen.cpp index 385c7bc..d93b503 100644 --- a/src/latexgen.cpp +++ b/src/latexgen.cpp @@ -1142,13 +1142,12 @@ void LatexGenerator::startMemberDoc(const char *clname, t << "}" << endl; } if (Config_getBool("COMPACT_LATEX")) t << "\\paragraph"; else t << "\\subsubsection"; - if (Config_getBool("PDF_HYPERLINKS") && memname) - { - t << "["; - escapeMakeIndexChars(this,t,memname); - //filterTitle(title) - t << "]"; - } + //if (Config_getBool("PDF_HYPERLINKS") && memname) + //{ + // t << "["; + // escapeMakeIndexChars(this,t,memname); + // t << "]"; + //} t << "{\\setlength{\\rightskip}{0pt plus 5cm}"; } diff --git a/src/libdoxygen.pro.in b/src/libdoxygen.pro.in index 656c75f..12dfbd7 100644 --- a/src/libdoxygen.pro.in +++ b/src/libdoxygen.pro.in @@ -70,6 +70,7 @@ HEADERS = bufstr.h \ memberlist.h \ membername.h \ message.h \ + msc.h \ namespacedef.h \ objcache.h \ outputgen.h \ @@ -178,6 +179,7 @@ SOURCES = ce_lex.cpp \ memberlist.cpp \ membername.cpp \ message.cpp \ + msc.cpp \ namespacedef.cpp \ objcache.cpp \ outputgen.cpp \ diff --git a/src/mandocvisitor.cpp b/src/mandocvisitor.cpp index 3f305a9..8a63d5d 100644 --- a/src/mandocvisitor.cpp +++ b/src/mandocvisitor.cpp @@ -219,6 +219,7 @@ void ManDocVisitor::visit(DocVerbatim *s) case DocVerbatim::XmlOnly: case DocVerbatim::LatexOnly: case DocVerbatim::Dot: + case DocVerbatim::Msc: /* nothing */ break; } diff --git a/src/memberdef.cpp b/src/memberdef.cpp index 155e10d..e149cc9 100644 --- a/src/memberdef.cpp +++ b/src/memberdef.cpp @@ -1549,7 +1549,7 @@ void MemberDef::writeDocumentation(MemberList *ml,OutputList &ol, QCString cfiname = container->getOutputFileBase(); static bool hasHtmlHelp = Config_getBool("GENERATE_HTML") && Config_getBool("GENERATE_HTMLHELP"); - HtmlHelp *htmlHelp = 0; + HtmlHelp *htmlHelp = HtmlHelp::getInstance(); if (hasHtmlHelp) { if (isEnumerate() && name().at(0)=='@') @@ -1558,7 +1558,6 @@ void MemberDef::writeDocumentation(MemberList *ml,OutputList &ol, } else { - htmlHelp = HtmlHelp::getInstance(); htmlHelp->addIndexItem(ciname, // level1 name(), // level2 separateMemPages ? cfname : cfiname, // contRef @@ -1876,7 +1875,7 @@ void MemberDef::writeDocumentation(MemberList *ml,OutputList &ol, } /* write detailed description */ - if (!detailed.isEmpty()) + if (!detailed.isEmpty() || !m_impl->inbodyDocs.isEmpty()) { ol.parseDoc(docFile(),docLine(),getOuterScope()?getOuterScope():container,this,detailed+"\n",TRUE,FALSE); if (!m_impl->inbodyDocs.isEmpty()) diff --git a/src/msc.cpp b/src/msc.cpp new file mode 100644 index 0000000..afde2ed --- /dev/null +++ b/src/msc.cpp @@ -0,0 +1,172 @@ +/****************************************************************************** + * + * + * + * Copyright (C) 1997-2007 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. + * + */ + +#include "msc.h" +#include "portable.h" +#include "config.h" +#include "message.h" +#include "docparser.h" +#include "doxygen.h" + +#include + +static const int maxCmdLine = 40960; + +static bool convertMapFile(QTextStream &t,const char *mapName,const QCString relPath) +{ + QFile f(mapName); + if (!f.open(IO_ReadOnly)) + { + err("Error opening map file %s for inclusion in the docs!\n",mapName); + return FALSE; + } + const int maxLineLen=1024; + char buf[maxLineLen]; + char url[maxLineLen]; + char ref[maxLineLen]; + int x1,y1,x2,y2; + while (!f.atEnd()) + { + bool isRef = FALSE; + int numBytes = f.readLine(buf,maxLineLen); + buf[numBytes-1]='\0'; + //printf("ReadLine `%s'\n",buf); + if (strncmp(buf,"rect",4)==0) + { + // obtain the url and the coordinates in the order used by graphviz-1.5 + sscanf(buf,"rect %s %d,%d %d,%d",url,&x1,&y1,&x2,&y2); + + if ( strcmp(url,"\\ref") == 0 ) + { + isRef = TRUE; + sscanf(buf,"rect %s %s %d,%d %d,%d",ref,url,&x1,&y1,&x2,&y2); + } + + // sanity checks + if (y2ref().isEmpty()) + { + if ((dest=Doxygen::tagDestinationDict[df->ref()])) t << *dest << "/"; + } + if (!df->file().isEmpty()) t << relPath << df->file() << Doxygen::htmlFileExtension; + if (!df->anchor().isEmpty()) t << "#" << df->anchor(); + } + else + { + t << url; + } + t << "\" shape=\"rect\" coords=\"" + << x1 << "," << y1 << "," << x2 << "," << y2 << "\"" + << " alt=\"\">" << endl; + } + } + + return TRUE; +} +void writeMscGraphFromFile(const char *inFile,const char *outDir, + const char *outFile,MscOutputFormat format) +{ + QCString absOutFile = outDir; + absOutFile+=portable_pathSeparator(); + absOutFile+=outFile; + + // chdir to the output dir, so dot can find the font file. + QCString oldDir = convertToQCString(QDir::currentDirPath()); + // go to the html output directory (i.e. path) + QDir::setCurrent(outDir); + //printf("Going to dir %s\n",QDir::currentDirPath().data()); + QCString mscExe = /*Config_getString("MSC_PATH")+*/ "mscgen"; + QCString mscArgs; + QCString extension; + if (format==MSC_BITMAP) + { + mscArgs+="-T png"; + extension=".png"; + } + else if (format==MSC_EPS) + { + mscArgs+="-T eps"; + extension=".eps"; + } + mscArgs+=" -i \""; + mscArgs+=inFile; + mscArgs+=".msc\" -o \""; + mscArgs+=outFile; + mscArgs+=extension+"\""; + int exitCode; + //printf("*** running: %s %s\n",mscExe.data(),mscArgs.data()); + if ((exitCode=portable_system(mscExe,mscArgs,FALSE))!=0) + { + goto error; + } + if ( (format==MSC_EPS) && (Config_getBool("USE_PDFLATEX")) ) + { + QCString epstopdfArgs(maxCmdLine); + epstopdfArgs.sprintf("\"%s.eps\" --outfile=\"%s.pdf\"", + outFile,outFile); + if (portable_system("epstopdf",epstopdfArgs)!=0) + { + err("Error: Problems running epstopdf. Check your TeX installation!\n"); + } + } + +error: + QDir::setCurrent(oldDir); +} + +QString getMscImageMapFromFile(const QString& inFile, const QString& outDir, + const QCString& relPath) +{ + QString outFile = inFile + ".map"; + + // chdir to the output dir, so dot can find the font file. + QCString oldDir = convertToQCString(QDir::currentDirPath()); + // go to the html output directory (i.e. path) + QDir::setCurrent(outDir); + //printf("Going to dir %s\n",QDir::currentDirPath().data()); + + QCString mscExe = "mscgen"; + QCString mscArgs = "-T ismap -i \""; + mscArgs+=inFile + ".msc\" -o \""; + mscArgs+=outFile + ".map\""; + + int exitCode; + if ((exitCode=portable_system(mscExe,mscArgs,FALSE))!=0) + { + QDir::setCurrent(oldDir); + return ""; + } + + QString result; + QTextOStream tmpout(&result); + convertMapFile(tmpout, outFile+".map", relPath); + QDir().remove(outFile); + + QDir::setCurrent(oldDir); + return result; +} + + diff --git a/src/msc.h b/src/msc.h new file mode 100644 index 0000000..74a15ea --- /dev/null +++ b/src/msc.h @@ -0,0 +1,32 @@ +/****************************************************************************** + * + * + * + * Copyright (C) 1997-2007 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 _MSC_H +#define _MSC_H + +#include "qtbc.h" + +enum MscOutputFormat { MSC_BITMAP , MSC_EPS }; + +void writeMscGraphFromFile(const char *inFile,const char *outDir, + const char *outFile,MscOutputFormat format); + +QString getMscImageMapFromFile(const QString& inFile, const QString& outDir, + const QCString& relPath); + +#endif + diff --git a/src/perlmodgen.cpp b/src/perlmodgen.cpp index 73f25db..dadc439 100644 --- a/src/perlmodgen.cpp +++ b/src/perlmodgen.cpp @@ -629,6 +629,7 @@ void PerlModDocVisitor::visit(DocVerbatim *s) case DocVerbatim::LatexOnly: type = "latexonly"; break; case DocVerbatim::XmlOnly: type = "xmlonly"; break; case DocVerbatim::Dot: type = "dot"; break; + case DocVerbatim::Msc: type = "msc"; break; } openItem(type); m_output.addFieldQuotedString("content", s->text()); diff --git a/src/portable.cpp b/src/portable.cpp index 94f8c20..8a0d6e5 100644 --- a/src/portable.cpp +++ b/src/portable.cpp @@ -127,7 +127,10 @@ int portable_system(const char *command,const char *args,bool commandHasConsole SHELLEXECUTEINFO sInfo = { sizeof(SHELLEXECUTEINFO), /* structure size */ - SEE_MASK_NOCLOSEPROCESS | SEE_MASK_FLAG_NO_UI, /* leave the process running */ + SEE_MASK_NOCLOSEPROCESS | SEE_MASK_FLAG_NO_UI, /* tell us the process + * handle so we can wait till it's done | + * do not display msg box if error + */ NULL, /* window handle */ NULL, /* action to perform: open */ command, /* file to execute */ @@ -334,12 +337,12 @@ const char *portable_ghostScriptCommand() #endif } -const char *portable_dotCommand() +const char *portable_commandExtension() { #if defined(_WIN32) && !defined(__CYGWIN__) - return "dot.exe"; + return ".exe"; #else - return "dot"; + return ""; #endif } diff --git a/src/portable.h b/src/portable.h index 0a88079..cf21902 100644 --- a/src/portable.h +++ b/src/portable.h @@ -24,7 +24,7 @@ portable_off_t portable_ftell(FILE *f); char portable_pathSeparator(); char portable_pathListSeparator(); const char * portable_ghostScriptCommand(); -const char * portable_dotCommand(); +const char * portable_commandExtension(); bool portable_fileSystemIsCaseSensitive(); FILE * portable_popen(const char *name,const char *type); int portable_pclose(FILE *stream); diff --git a/src/printdocvisitor.h b/src/printdocvisitor.h index faf9b16..27db658 100644 --- a/src/printdocvisitor.h +++ b/src/printdocvisitor.h @@ -151,6 +151,7 @@ class PrintDocVisitor : public DocVisitor case DocVerbatim::LatexOnly: printf(""); break; case DocVerbatim::XmlOnly: printf(""); break; case DocVerbatim::Dot: printf(""); break; + case DocVerbatim::Msc: printf(""); break; } printf("%s",s->text().data()); switch(s->type()) @@ -162,6 +163,7 @@ class PrintDocVisitor : public DocVisitor case DocVerbatim::LatexOnly: printf(""); break; case DocVerbatim::XmlOnly: printf(""); break; case DocVerbatim::Dot: printf(""); break; + case DocVerbatim::Msc: printf(""); break; } } void visit(DocAnchor *a) diff --git a/src/pyscanner.l b/src/pyscanner.l index bdd4f71..e6bacc5 100644 --- a/src/pyscanner.l +++ b/src/pyscanner.l @@ -606,7 +606,7 @@ STARTDOCSYMS ^{B}"##"/[^#] { "*" { // import all - QCString item=g_packageName+"."+yytext; + QCString item=g_packageName; current->name=removeRedundantWhiteSpace(substitute(item,".","::")); current->fileName = yyFileName; //printf("Adding using directive: found:%s:%d name=%s\n",yyFileName.data(),yyLineNr,current->name.data()); diff --git a/src/rtfdocvisitor.cpp b/src/rtfdocvisitor.cpp index fb0b1e1..05fe40d 100644 --- a/src/rtfdocvisitor.cpp +++ b/src/rtfdocvisitor.cpp @@ -27,6 +27,7 @@ #include "message.h" #include #include "parserintf.h" +#include "msc.h" //#define DBG_RTF(x) m_t << x @@ -372,6 +373,31 @@ void RTFDocVisitor::visit(DocVerbatim *s) if (Config_getBool("DOT_CLEANUP")) file.remove(); } break; + case DocVerbatim::Msc: + { + static int mscindex = 1; + QCString baseName(4096); + + baseName.sprintf("%s%d", + (Config_getString("RTF_OUTPUT")+"/inline_mscgraph_").data(), + mscindex++ + ); + QFile file(baseName+".msc"); + if (!file.open(IO_WriteOnly)) + { + err("Could not open file %s for writing\n",baseName.data()); + } + QCString text = "msc {"; + text+=s->text(); + text+="}"; + file.writeBlock( text, text.length() ); + file.close(); + m_t << "\\par{\\qc "; // center picture + writeMscFile(baseName); + m_t << "} "; + if (Config_getBool("DOT_CLEANUP")) file.remove(); + } + break; } m_lastIsPara=FALSE; } @@ -1420,4 +1446,23 @@ void RTFDocVisitor::writeDotFile(const QString &fileName) m_lastIsPara=TRUE; } +void RTFDocVisitor::writeMscFile(const QString &fileName) +{ + QString baseName=fileName; + int i; + if ((i=baseName.findRev('/'))!=-1) + { + baseName=baseName.right(baseName.length()-i-1); + } + QString outDir = Config_getString("RTF_OUTPUT"); + writeMscGraphFromFile(fileName,outDir,baseName,MSC_BITMAP); + if (!m_lastIsPara) m_t << "\\par" << endl; + m_t << "{" << endl; + m_t << rtf_Style_Reset; + m_t << "\\pard \\qc {\\field\\flddirty {\\*\\fldinst INCLUDEPICTURE \""; + m_t << baseName << ".png"; + m_t << "\" \\\\d \\\\*MERGEFORMAT}{\\fldrslt IMAGE}}\\par" << endl; + m_t << "}" << endl; + m_lastIsPara=TRUE; +} diff --git a/src/rtfdocvisitor.h b/src/rtfdocvisitor.h index 63aa662..02bc904 100644 --- a/src/rtfdocvisitor.h +++ b/src/rtfdocvisitor.h @@ -144,6 +144,7 @@ class RTFDocVisitor : public DocVisitor void pushEnabled(); void popEnabled(); void writeDotFile(const QString &fileName); + void writeMscFile(const QString &fileName); //-------------------------------------- // state variables diff --git a/src/scanner.l b/src/scanner.l index ec6ff31..e4180dc 100644 --- a/src/scanner.l +++ b/src/scanner.l @@ -1070,6 +1070,29 @@ TYPEDEFPREFIX (("typedef"{BN}+)?)((("volatile"|"const"){BN}+)?) {BN}{1,80} { lineCount(); } +"@"{ID}{BN}*"(" { + if (insideJava) // Java annotation + { + lineCount(); + lastSkipRoundContext = YY_START; + roundCount=1; + BEGIN( SkipRound ); + } + else + { + REJECT; + } + } +"@"{ID} { + if (insideJava) // Java annotation + { + // skip annotation + } + else + { + REJECT; + } + } {ID}("."{ID})* { isTypedef=FALSE; current->name = yytext; @@ -1186,7 +1209,7 @@ TYPEDEFPREFIX (("typedef"{BN}+)?)((("volatile"|"const"){BN}+)?) current->name = QCString(yytext).stripWhiteSpace(); } } -{B}*((("disp")?"interface")|"valuetype"){BN}+ { // M$/Corba IDL interface +{B}*((("disp")?"interface")|"valuetype"){BN}+ { // M$/Corba IDL/Java interface lineCount(); if (insideIDL || insideJava || insideCS || insideD || insidePHP) { @@ -1219,12 +1242,12 @@ TYPEDEFPREFIX (("typedef"{BN}+)?)((("volatile"|"const"){BN}+)?) current->bodyLine = yyLineNr; BEGIN( CompoundName ); } -{B}*"@interface"{BN}+ { // Objective-C class interface +{B}*"@interface"{BN}+ { // Objective-C class interface, or Java attribute lineCount(); isTypedef=FALSE; current->section = Entry::CLASS_SEC; current->spec = Entry::Interface; - current->objc = insideObjC = TRUE; + current->objc = insideObjC = !insideJava; current->protection = protection = Public ; addType( current ) ; current->type += " interface" ; @@ -1593,7 +1616,16 @@ TYPEDEFPREFIX (("typedef"{BN}+)?)((("volatile"|"const"){BN}+)?) sharpCount++; } ">>" { - current->name+=yytext; + if (insideJava || insideCS) + { + unput('>'); + unput(' '); + unput('>'); + } + else + { + current->name+=yytext; + } // *currentTemplateSpec+=yytext; } ">" { diff --git a/src/translator_br.h b/src/translator_br.h index da6bdbd..2a0eade 100644 --- a/src/translator_br.h +++ b/src/translator_br.h @@ -1016,6 +1016,8 @@ class TranslatorBrazilian : public Translator "class Undocumented { };\n\n" "/*! Class that is inherited using public inheritance */\n" "class PublicBase : public Truncated { };\n\n" + "/*! A template class */\n" + "template class Templ { };\n\n" "/*! Class that is inherited using protected inheritance */\n" "class ProtectedBase { };\n\n" "/*! Class that is inherited using private inheritance */\n" @@ -1026,7 +1028,8 @@ class TranslatorBrazilian : public Translator "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" + " public Templ\n" "{\n" " private:\n" " Used *m_usedClass;\n" diff --git a/src/translator_ca.h b/src/translator_ca.h index 5380d0a..03a6fa6 100644 --- a/src/translator_ca.h +++ b/src/translator_ca.h @@ -1038,7 +1038,7 @@ class TranslatorCatalan : public Translator "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" " public Templ\n" "{\n" " private:\n" diff --git a/src/translator_cn.h b/src/translator_cn.h index ac2bb6d..4c3168b 100644 --- a/src/translator_cn.h +++ b/src/translator_cn.h @@ -912,6 +912,8 @@ class TranslatorChinese : public Translator "class Undocumented { };\n\n" "/*! ±»¹«Óм̳еÄÀà */\n" "class PublicBase : public Truncated { };\n\n" + "/*! A template class */\n" + "template class Templ { };\n\n" "/*! ±»±£»¤¼Ì³ÐµÄÀà */\n" "class ProtectedBase { };\n\n" "/*! ±»Ë½Óм̳еÄÀà */\n" @@ -922,7 +924,8 @@ class TranslatorChinese : public Translator "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" + " public Templ\n" "{\n" " private:\n" " Used *m_usedClass;\n" diff --git a/src/translator_de.h b/src/translator_de.h index f36c971..fd1313d 100644 --- a/src/translator_de.h +++ b/src/translator_de.h @@ -1126,7 +1126,7 @@ class TranslatorGerman : public Translator "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" " public Templ\n" "{\n" " private:\n" diff --git a/src/translator_dk.h b/src/translator_dk.h index c6fe415..70ff479 100644 --- a/src/translator_dk.h +++ b/src/translator_dk.h @@ -1002,7 +1002,7 @@ class TranslatorDanish : public Translator "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" " public Templ\n" "{\n" " private:\n" diff --git a/src/translator_en.h b/src/translator_en.h index b53a355..c6fde5b 100644 --- a/src/translator_en.h +++ b/src/translator_en.h @@ -1039,7 +1039,7 @@ class TranslatorEnglish : public Translator "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" " public Templ\n" "{\n" " private:\n" diff --git a/src/translator_es.h b/src/translator_es.h index 996665d..d145f69 100644 --- a/src/translator_es.h +++ b/src/translator_es.h @@ -1013,7 +1013,7 @@ class TranslatorSpanish : public Translator "class PublicBase : public Truncated { };\n\n" "/*! Clase plantilla */\n" "template class Templ { };\n\n" - "/*! Clase que es heredera usando herencia protegida */\n" + "/*! Clase que es heredera usando herencia protegida */\n" "class ProtectedBase { };\n\n" "/*! Clase que es heredera usando herencia privada */\n" "class PrivateBase { };\n\n" @@ -1023,7 +1023,7 @@ class TranslatorSpanish : public Translator "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" " public Templ\n" "{\n" " private:\n" diff --git a/src/translator_fr.h b/src/translator_fr.h index f79b0cc..0ee59b5 100644 --- a/src/translator_fr.h +++ b/src/translator_fr.h @@ -1184,7 +1184,7 @@ class TranslatorFrench : public Translator "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" " public Templ\n" "{\n" " private:\n" diff --git a/src/translator_gr.h b/src/translator_gr.h index 3faae08..224fe99 100644 --- a/src/translator_gr.h +++ b/src/translator_gr.h @@ -1027,6 +1027,8 @@ class TranslatorGreek : public Translator "class Undocumented { };\n\n" "/*! Class that is inherited using public inheritance */\n" "class PublicBase : public Truncated { };\n\n" + "/*! A template class */\n" + "template class Templ { };\n\n" "/*! Class that is inherited using protected inheritance */\n" "class ProtectedBase { };\n\n" "/*! Class that is inherited using private inheritance */\n" @@ -1037,7 +1039,8 @@ class TranslatorGreek : public Translator "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" + " public Templ\n" "{\n" " private:\n" " Used *m_usedClass;\n" diff --git a/src/translator_hr.h b/src/translator_hr.h index 7779087..81d29f1 100644 --- a/src/translator_hr.h +++ b/src/translator_hr.h @@ -757,6 +757,8 @@ class TranslatorCroatian : public Translator "class Undocumented { };\n\n" "/*! Klasa koja je naslijeðena public */\n" "class PublicBase : public Truncated { };\n\n" + "/*! A template class */\n" + "template class Templ { };\n\n" "/*! Klasa koje je naslijeðena protected */\n" "class ProtectedBase { };\n\n" "/*! Klasa koje je naslijeðena private */\n" @@ -767,7 +769,8 @@ class TranslatorCroatian : public Translator "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" + " public Templ\n" "{\n" " private:\n" " Used *m_usedClass;\n" diff --git a/src/translator_hu.h b/src/translator_hu.h index 3325125..dd3e405 100644 --- a/src/translator_hu.h +++ b/src/translator_hu.h @@ -1018,7 +1018,7 @@ class TranslatorHungarian : public TranslatorAdapter_1_4_6 "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" " public Templ\n" "{\n" " private:\n" diff --git a/src/translator_id.h b/src/translator_id.h index 053f0d6..311e0a8 100644 --- a/src/translator_id.h +++ b/src/translator_id.h @@ -1049,7 +1049,7 @@ class TranslatorIndonesian : public TranslatorAdapter_1_4_6 "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" " public Templ\n" "{\n" " private:\n" diff --git a/src/translator_it.h b/src/translator_it.h index c289807..edaba52 100644 --- a/src/translator_it.h +++ b/src/translator_it.h @@ -1029,6 +1029,8 @@ class TranslatorItalian : public Translator "class Undocumented { };\n\n" "/*! Classe che utilizza una ereditarietà pubblica */\n" "class PublicBase : public Truncated { };\n\n" + "/*! A template class */\n" + "template class Templ { };\n\n" "/*! Classe che utilizza una ereditarietà protetta*/\n" "class ProtectedBase { };\n\n" "/*! Classe che utilizza una ereditarietà privata*/\n" @@ -1039,7 +1041,8 @@ class TranslatorItalian : public Translator "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" + " public Templ\n" "{\n" " private:\n" " Used *m_usedClass;\n" diff --git a/src/translator_jp.h b/src/translator_jp.h index 1b509b4..ff226d8 100644 --- a/src/translator_jp.h +++ b/src/translator_jp.h @@ -1001,6 +1001,8 @@ class TranslatorJapanese : public Translator "class Undocumented { };\n\n" "/*! public ¤Ç·Ñ¾µ¤µ¤ì¤¿¥¯¥é¥¹ */\n" "class PublicBase : public Truncated { };\n\n" + "/*! A template class */\n" + "template class Templ { };\n\n" "/*! protected ¤Ç·Ñ¾µ¤µ¤ì¤¿¥¯¥é¥¹ */\n" "class ProtectedBase { };\n\n" "/*! private ¤Ç·Ñ¾µ¤µ¤ì¤¿¥¯¥é¥¹ */\n" @@ -1011,7 +1013,8 @@ class TranslatorJapanese : public Translator "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" + " public Templ\n" "{\n" " private:\n" " Used *m_usedClass;\n" diff --git a/src/translator_kr.h b/src/translator_kr.h index 2593e02..7125c40 100644 --- a/src/translator_kr.h +++ b/src/translator_kr.h @@ -1008,7 +1008,7 @@ class TranslatorKorean : public TranslatorAdapter_1_4_6 "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" " public Templ\n" "{\n" " private:\n" diff --git a/src/translator_lt.h b/src/translator_lt.h index 72c4199..35ec74f 100644 --- a/src/translator_lt.h +++ b/src/translator_lt.h @@ -1027,7 +1027,7 @@ class TranslatorLithuanian : public TranslatorAdapter_1_4_6 "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" " public Templ\n" "{\n" " private:\n" diff --git a/src/translator_nl.h b/src/translator_nl.h index fcf821cb..e2f1e1a 100644 --- a/src/translator_nl.h +++ b/src/translator_nl.h @@ -655,6 +655,8 @@ class TranslatorDutch : public Translator "class Undocumented { };\n\n" "/*! Klasse met public inheritance */\n" "class PublicBase : public Truncated { };\n\n" + "/*! A template class */\n" + "template class Templ { };\n\n" "/*! Klasse met protected inheritance */\n" "class ProtectedBase { };\n\n" "/*! Klasse met private inheritance */\n" @@ -665,7 +667,8 @@ class TranslatorDutch : public Translator "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" + " public Templ\n" "{\n" " private:\n" " Used *m_usedClass;\n" diff --git a/src/translator_no.h b/src/translator_no.h index 35df614..761afc2 100644 --- a/src/translator_no.h +++ b/src/translator_no.h @@ -1057,6 +1057,8 @@ class TranslatorNorwegian : public TranslatorAdapter_1_4_6 "class Undocumented { };\n\n" "/*! Klasse med public-arv */\n" "class PublicBase : public Truncated { };\n\n" + "/*! A template class */\n" + "template class Templ { };\n\n" "/*! Klasse med protected-arv */\n" "class ProtectedBase { };\n\n" "/*! Klasse med private-arv */\n" @@ -1067,7 +1069,7 @@ class TranslatorNorwegian : public TranslatorAdapter_1_4_6 "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" " public Templ\n" "{\n" " private:\n" diff --git a/src/translator_pl.h b/src/translator_pl.h index 71af4c8..c911b5d 100644 --- a/src/translator_pl.h +++ b/src/translator_pl.h @@ -1044,6 +1044,8 @@ class TranslatorPolish : public TranslatorAdapter_1_4_6 "class Nieudokumentowana { };\n\n" "/*! Klasa, która jest dziedziczona publicznie */\n" "class PublicznaBaza : public Okrojona { };\n\n" + "/*! A template class */\n" + "template class Templ { };\n\n" "/*! Klasa, która jest dziedziczona przy u¿yciu dziedziczenia chronionego */\n" "class ChronionaBaza { };\n\n" "/*! Klasa, która jest dziedziczona prywatnie */\n" @@ -1054,7 +1056,8 @@ class TranslatorPolish : public TranslatorAdapter_1_4_6 "class Dziedziczona : public PublicznaBaza,\n" " protected ChronionaBaza,\n" " private PrywatnaBaza,\n" - " public Nieudokumentowana\n" + " public Nieudokumentowana,\n" + " public Templ\n" "{\n" " private:\n" " Uzyta *m_usedClass;\n" diff --git a/src/translator_pt.h b/src/translator_pt.h index ebe8ce9..657460f 100644 --- a/src/translator_pt.h +++ b/src/translator_pt.h @@ -1043,6 +1043,8 @@ class TranslatorPortuguese : public TranslatorAdapter_1_3_3 "class Undocumented { };\n\n" "/*! Classe derivada usando derivação pública */\n" "class PublicBase : public Truncated { };\n\n" + "/*! A template class */\n" + "template class Templ { };\n\n" "/*! Classe derivada usando derivação protegida */\n" "class ProtectedBase { };\n\n" "/*! Classe derivada usando derivação privada */\n" @@ -1053,7 +1055,8 @@ class TranslatorPortuguese : public TranslatorAdapter_1_3_3 "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" + " public Templ\n" "{\n" " private:\n" " Used *m_usedClass;\n" diff --git a/src/translator_ro.h b/src/translator_ro.h index 32fb99c..b2e5e46 100644 --- a/src/translator_ro.h +++ b/src/translator_ro.h @@ -1073,6 +1073,8 @@ class TranslatorRomanian : public TranslatorAdapter_1_4_1 "class Undocumented { };\n\n" "/*! Clasã care este moºtenitã în mod public */\n" "class PublicBase : public Truncated { };\n\n" + "/*! A template class */\n" + "template class Templ { };\n\n" "/*! Clasã care este moºtenitã în mod protejat */\n" "class ProtectedBase { };\n\n" "/*! Clasã care este moºtenitã în mod privat */\n" @@ -1083,7 +1085,8 @@ class TranslatorRomanian : public TranslatorAdapter_1_4_1 "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" + " public Templ\n" "{\n" " private:\n" " Used *m_usedClass;\n" diff --git a/src/translator_se.h b/src/translator_se.h index a474915..ee50224 100644 --- a/src/translator_se.h +++ b/src/translator_se.h @@ -917,7 +917,7 @@ class TranslatorSwedish : public TranslatorAdapter_1_4_6 "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" " public Templ\n" "{\n" " private:\n" diff --git a/src/translator_si.h b/src/translator_si.h index d5fb31e..0549d5e 100644 --- a/src/translator_si.h +++ b/src/translator_si.h @@ -684,6 +684,8 @@ class TranslatorSlovene : public TranslatorAdapter_1_4_6 "class Undocumented { };\n\n" "/*! Razred, ki ga dedujemo s pomoèjo javnega dedovanja */\n" "class PublicBase : public Truncated { };\n\n" + "/*! A template class */\n" + "template class Templ { };\n\n" "/*! Razred, ki ga dedujemo s pomoèjo za¹èitenega dedovanja */\n" "class ProtectedBase { };\n\n" "/*! Razred, ki ga dedujemo s pomoèjo skritega dedovanja */\n" @@ -694,7 +696,8 @@ class TranslatorSlovene : public TranslatorAdapter_1_4_6 "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" + " public Templ\n" "{\n" " private:\n" " Used *m_usedClass;\n" diff --git a/src/translator_sk.h b/src/translator_sk.h index 20bf1d1..f696620 100644 --- a/src/translator_sk.h +++ b/src/translator_sk.h @@ -1055,6 +1055,8 @@ class TranslatorSlovak : public TranslatorAdapter_1_2_18 "/*! Odvodená trieda s verejným (public) dedením bázovej triedy. */\n" "class PublicBase : public Truncated { };\n\n" "/*! Odvodená trieda s chráneným (protected) dedením bázovej triedy. */\n" + "/*! A template class */\n" + "template class Templ { };\n\n" "class ProtectedBase { };\n\n" "/*! Odvodená trieda s privátnym dedením bázovej triedy. */\n" "class PrivateBase { };\n\n" @@ -1063,9 +1065,10 @@ class TranslatorSlovak : public TranslatorAdapter_1_2_18 "/*! Odvodená trieda, ktorá rôznym spôsobom dedí od viacerých bázových " "tried. */\n" "class Inherited : public PublicBase,\n" - " protected ProtectedBase,\n" - " private PrivateBase,\n" - " public Undocumented\n" + " protected ProtectedBase,\n" + " private PrivateBase,\n" + " public Undocumented,\n" + " public Templ\n" "{\n" " private:\n" " Used *m_usedClass;\n" diff --git a/src/translator_sr.h b/src/translator_sr.h index 6445d1e..b951e5c 100644 --- a/src/translator_sr.h +++ b/src/translator_sr.h @@ -1071,7 +1071,7 @@ private: "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" " public Templ\n" "{\n" " private:\n" diff --git a/src/translator_tw.h b/src/translator_tw.h index 1fcedba..0ec19d2 100644 --- a/src/translator_tw.h +++ b/src/translator_tw.h @@ -1068,7 +1068,7 @@ class TranslatorChinesetraditional : public TranslatorAdapter_1_4_6 "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" " public Templ\n" "{\n" " private:\n" diff --git a/src/translator_ua.h b/src/translator_ua.h index c9460de..7ba2235 100644 --- a/src/translator_ua.h +++ b/src/translator_ua.h @@ -1056,6 +1056,8 @@ class TranslatorUkrainian : public TranslatorAdapter_1_4_1 "class Undocumented { };\n\n" "/*! úÁÇÁÌØÎÏÄÏÓÔÕÐÎÅ ÕÓÐÁÄËÕ×ÁÎÎÑ */\n" "class PublicBase : public Truncated { };\n\n" + "/*! A template class */\n" + "template class Templ { };\n\n" "/*! úÁÈÉÝÅÎÅ ÕÓÐÁÄËÕ×ÁÎÎÑ */\n" "class ProtectedBase { };\n\n" "/*! ðÒÉ×ÁÔÎÅ ÕÓÐÁÄËÕ×ÁÎÎÑ */\n" @@ -1066,7 +1068,8 @@ class TranslatorUkrainian : public TranslatorAdapter_1_4_1 "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Undocumented\n" + " public Undocumented,\n" + " public Templ\n" "{\n" " private:\n" " Used *m_usedClass;\n" diff --git a/src/translator_za.h b/src/translator_za.h index 75e0a09..3745d1a 100644 --- a/src/translator_za.h +++ b/src/translator_za.h @@ -1021,7 +1021,7 @@ class TranslatorAfrikaans : public TranslatorAdapter_1_4_6 "class Inherited : public PublicBase,\n" " protected ProtectedBase,\n" " private PrivateBase,\n" - " public Ongedokumenteer\n" + " public Ongedokumenteer,\n" " public Templ\n" "{\n" " private:\n" diff --git a/src/translatordecoder.h b/src/translatordecoder.h index 71610eb..b29ced2 100644 --- a/src/translatordecoder.h +++ b/src/translatordecoder.h @@ -71,7 +71,7 @@ class TranslatorDecoder : public Translator { oSize -= oLeft; output.resize(oSize+1); - output.at(oSize+1)='\0'; + output.at(oSize)='\0'; return output; } else diff --git a/src/util.cpp b/src/util.cpp index 985718a..866b555 100644 --- a/src/util.cpp +++ b/src/util.cpp @@ -395,6 +395,10 @@ QCString resolveTypeDef(Definition *context,const QCString &qualifiedName, // qualifiedName.data(),context->name().data(),md->typeString() // ); result=md->typeString(); + if (result.find("*)")!=-1) // typedef of a function/member pointer + { + result+=md->argsString(); + } if (typedefContext) *typedefContext=md->getOuterScope(); } else @@ -1929,7 +1933,7 @@ QCString recodeString(const QCString &str,const char *fromEncoding,const char *t { outputSize-=oLeft; output.resize(outputSize+1); - output.at(outputSize+1)='\0'; + output.at(outputSize)='\0'; //printf("iconv: input size=%d output size=%d\n[%s]\n",size,newSize,srcBuf.data()); } else @@ -1966,7 +1970,7 @@ QCString transcodeCharacterStringToUTF8(const QCString &input) { outputSize-=oLeft; output.resize(outputSize+1); - output.at(outputSize+1)='\0'; + output.at(outputSize)='\0'; //printf("iconv: input size=%d output size=%d\n[%s]\n",size,newSize,srcBuf.data()); } else diff --git a/src/xmldocvisitor.cpp b/src/xmldocvisitor.cpp index 2fd186a..564438d 100644 --- a/src/xmldocvisitor.cpp +++ b/src/xmldocvisitor.cpp @@ -208,6 +208,11 @@ void XmlDocVisitor::visit(DocVerbatim *s) filter(s->text()); m_t << ""; break; + case DocVerbatim::Msc: + m_t << ""; + filter(s->text()); + m_t << ""; + break; } } diff --git a/winbuild/Doxygen.vcproj b/winbuild/Doxygen.vcproj index 8309c86..5f586c8 100644 --- a/winbuild/Doxygen.vcproj +++ b/winbuild/Doxygen.vcproj @@ -1311,6 +1311,10 @@ + + + + @@ -2034,6 +2042,10 @@ > + + diff --git a/winbuild/Doxywizard.vcproj b/winbuild/Doxywizard.vcproj index 7219517..022ff11 100644 --- a/winbuild/Doxywizard.vcproj +++ b/winbuild/Doxywizard.vcproj @@ -52,8 +52,8 @@ + + -- cgit v0.12