From 7cdb9679aa5e9baf87772f2c7799ff7b5fe01207 Mon Sep 17 00:00:00 2001 From: dimitri Date: Mon, 22 Sep 2003 20:13:01 +0000 Subject: Release-1.3.4 --- INSTALL | 4 +- README | 4 +- VERSION | 2 +- doc/language.doc | 10 ++-- packages/rpm/doxygen.spec | 2 +- src/classdef.cpp | 7 +++ src/definition.cpp | 20 ++++++-- src/filedef.cpp | 7 +++ src/groupdef.cpp | 7 +++ src/memberdef.cpp | 9 ++++ src/namespacedef.cpp | 7 +++ src/searchindex.h | 49 ------------------- src/translator_de.h | 72 +++++++++++++++++++++++++++- src/translator_it.h | 2 +- src/translator_ru.h | 119 +++++++++++++++++++++++++++++++++++++++++++++- src/xmlgen.cpp | 4 +- 16 files changed, 255 insertions(+), 70 deletions(-) diff --git a/INSTALL b/INSTALL index 2f9f718..5325acf 100644 --- a/INSTALL +++ b/INSTALL @@ -1,7 +1,7 @@ -DOXYGEN Version 1.3.3-20030915 +DOXYGEN Version 1.3.4 Please read the installation section of the manual (http://www.doxygen.org/install.html) for instructions. -------- -Dimitri van Heesch (15 September 2003) +Dimitri van Heesch (22 September 2003) diff --git a/README b/README index 63f9315..0b5a20e 100644 --- a/README +++ b/README @@ -1,4 +1,4 @@ -DOXYGEN Version 1.3.3_20030915 +DOXYGEN Version 1.3.4 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) (15 September 2003) +Dimitri van Heesch (dimitri@stack.nl) (22 September 2003) diff --git a/VERSION b/VERSION index 594903d..d0149fe 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -1.3.3-20030915 +1.3.4 diff --git a/doc/language.doc b/doc/language.doc index a6d8fad..1e54ae0 100644 --- a/doc/language.doc +++ b/doc/language.doc @@ -25,7 +25,7 @@ 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.3.3), 29 languages +Currently (version unknown), 29 languages are supported (sorted alphabetically): Brazilian Portuguese, Catalan, Chinese, Chinese Traditional, Croatian, Czech, Danish, Dutch, English, Finnish, @@ -121,7 +121,7 @@ when the translator was updated. German Jens Seidel jensseidel@NOSPAM.users.sf.net - 1.3.1 + up-to-date Greek @@ -139,7 +139,7 @@ when the translator was updated. Italian Alessandro Falappa
Ahmed Aldo Faisal alessandro@NOSPAM.falappa.net
aaf23@NOSPAM.cam.ac.uk - 1.3.3 + up-to-date Japanese @@ -260,13 +260,13 @@ when the translator was updated. \hline French & Xavier Outhier & {\tt xouthier@yahoo.fr} & up-to-date \\ \hline - German & Jens Seidel & {\tt jensseidel@users.sf.net} & 1.3.1 \\ + German & Jens Seidel & {\tt jensseidel@users.sf.net} & up-to-date \\ \hline Greek & Harry Kalogirou & {\tt harkal@rainbow.cs.unipi.gr} & 1.2.11 \\ \hline Hungarian & F\"{o}ldv\'{a}ri Gy\"{o}rgy & {\tt foldvari@diatronltd.com} & 1.2.1 \\ \hline - Italian & Alessandro Falappa & {\tt alessandro@falappa.net} & 1.3.3 \\ + Italian & Alessandro Falappa & {\tt alessandro@falappa.net} & up-to-date \\ & Ahmed Aldo Faisal & {\tt aaf23@cam.ac.uk} & \\ \hline Japanese & Ryunosuke Satoh & {\tt sun594@hotmail.com} & 1.3.3 \\ diff --git a/packages/rpm/doxygen.spec b/packages/rpm/doxygen.spec index 428d3f4..221396f 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.3.3_20030915 +Version: 1.3.4 Release: 1 Epoch: 1 Source0: ftp://ftp.stack.nl/pub/users/dimitri/%{name}-%{version}.src.tar.gz diff --git a/src/classdef.cpp b/src/classdef.cpp index 315e7aa..8ea85c2 100644 --- a/src/classdef.cpp +++ b/src/classdef.cpp @@ -35,6 +35,7 @@ #include "defargs.h" #include "debug.h" #include "docparser.h" +#include "searchindex.h" // constructs a new class definition @@ -850,6 +851,12 @@ void ClassDef::writeDocumentation(OutputList &ol) addGroupListToTitle(ol,this); endTitle(ol,getOutputFileBase(),name()); + if (Config_getBool("SEARCHENGINE")) + { + Doxygen::searchIndex->setCurrentDoc(pageTitle,getOutputFileBase()); + Doxygen::searchIndex->addWord(localName().lower()); + } + ol.startTextBlock(); //printf("Class %s brief=`%s' doc=`%s'\n",name().data(),briefDescription().data(),documentation().data()); diff --git a/src/definition.cpp b/src/definition.cpp index c94c7c5..e0841ef 100644 --- a/src/definition.cpp +++ b/src/definition.cpp @@ -252,7 +252,7 @@ static bool readCodeFragment(const char *fileName, // skip until the startLine has reached while (lineNr readCodeFragment(%s,%d,%d) lineNr=%d\n",fileName,startLine,endLine,lineNr); if (found) { // For code with more than one line, @@ -305,11 +307,21 @@ static bool readCodeFragment(const char *fileName, char lineStr[maxLineLength]; do { + //printf("reading line %d in range %d-%d\n",lineNr,startLine,endLine); int size_read; - do { + do + { // read up to maxLineLength-1 bytes, the last byte being zero char *p = fgets(lineStr, maxLineLength,f); - if (p) size_read=qstrlen(p); else size_read=-1; + //printf(" read %s",p); + if (p) + { + size_read=qstrlen(p); + } + else + { + size_read=-1; + } result+=lineStr; } while (size_read == (maxLineLength-1)); @@ -432,7 +444,7 @@ void Definition::writeInlineCode(OutputList &ol,const char *scopeName) { ol.pushGeneratorState(); //printf("Source Fragment %s: %d-%d bodyDef=%p\n",name().data(), - // startBodyLine,endBodyLine,bodyDef); + // m_startBodyLine,m_endBodyLine,m_bodyDef); if (Config_getBool("INLINE_SOURCES") && m_startBodyLine!=-1 && m_endBodyLine>=m_startBodyLine && m_bodyDef) { diff --git a/src/filedef.cpp b/src/filedef.cpp index 2a94da2..161d1fc 100644 --- a/src/filedef.cpp +++ b/src/filedef.cpp @@ -31,6 +31,7 @@ #include "code.h" #include "docparser.h" #include "ftvhelp.h" +#include "searchindex.h" //#include "xml.h" class DevNullCodeDocInterface : public BaseCodeDocInterface @@ -220,6 +221,12 @@ void FileDef::writeDocumentation(OutputList &ol) endTitle(ol,getOutputFileBase(),docName()); //ol.newParagraph(); + if (Config_getBool("SEARCHENGINE")) + { + Doxygen::searchIndex->setCurrentDoc(pageTitle,getOutputFileBase()); + Doxygen::searchIndex->addWord(localName().lower()); + } + if (!Config_getString("GENERATE_TAGFILE").isEmpty()) { Doxygen::tagFile << " " << endl; diff --git a/src/groupdef.cpp b/src/groupdef.cpp index 28e21db..999f032 100644 --- a/src/groupdef.cpp +++ b/src/groupdef.cpp @@ -31,6 +31,7 @@ #include "doxygen.h" #include "pagedef.h" #include "docparser.h" +#include "searchindex.h" GroupDef::GroupDef(const char *df,int dl,const char *na,const char *t, const char *refFileName) : Definition(df,dl,na) @@ -413,6 +414,12 @@ void GroupDef::writeDocumentation(OutputList &ol) addGroupListToTitle(ol,this); endTitle(ol,getOutputFileBase(),title); + if (Config_getBool("SEARCHENGINE")) + { + Doxygen::searchIndex->setCurrentDoc(title,getOutputFileBase()); + Doxygen::searchIndex->addWord(localName().lower()); + } + if (Config_getBool("DETAILS_AT_TOP")) { writeDetailedDocumentation(ol); diff --git a/src/memberdef.cpp b/src/memberdef.cpp index 7f6dd61..92e9024 100644 --- a/src/memberdef.cpp +++ b/src/memberdef.cpp @@ -32,6 +32,7 @@ #include "defargs.h" #include "docparser.h" #include "dot.h" +#include "searchindex.h" //#include "xml.h" @@ -723,6 +724,14 @@ void MemberDef::writeDeclaration(OutputList &ol, // differs from the cname. if (getOuterScope()) osname=getOuterScope()->name(); + if (Config_getBool("SEARCHENGINE")) + { + Doxygen::searchIndex->setCurrentDoc(qualifiedName(),getOutputFileBase()+Config_getString("HTML_FILE_EXTENSION")+"#"+anchor()); + Doxygen::searchIndex->addWord(localName().lower()); + Doxygen::searchIndex->addWord(qualifiedName().lower()); + } + + HtmlHelp *htmlHelp=0; bool hasHtmlHelp = Config_getBool("GENERATE_HTML") && Config_getBool("GENERATE_HTMLHELP"); diff --git a/src/namespacedef.cpp b/src/namespacedef.cpp index 1146924..c2aa94a 100644 --- a/src/namespacedef.cpp +++ b/src/namespacedef.cpp @@ -26,6 +26,7 @@ #include "doxygen.h" #include "message.h" #include "docparser.h" +#include "searchindex.h" NamespaceDef::NamespaceDef(const char *df,int dl, const char *name,const char *lref) : @@ -260,6 +261,12 @@ void NamespaceDef::writeDocumentation(OutputList &ol) addGroupListToTitle(ol,this); endTitle(ol,getOutputFileBase(),displayName()); + if (Config_getBool("SEARCHENGINE")) + { + Doxygen::searchIndex->setCurrentDoc(pageTitle,getOutputFileBase()); + Doxygen::searchIndex->addWord(localName().lower()); + } + if (!Config_getString("GENERATE_TAGFILE").isEmpty()) { Doxygen::tagFile << " " << endl; diff --git a/src/searchindex.h b/src/searchindex.h index f9d9c2f..87fcd70 100644 --- a/src/searchindex.h +++ b/src/searchindex.h @@ -25,55 +25,6 @@ #include #include - -#if 0 // old version -#include "suffixtree.h" -//class IndexTree; -class SuffixTree; - -class DocRef -{ - public: - DocRef(int index,const char *name,const char *url) - { i=index; n=name; u=url; } - ~DocRef() {} - void setOffset(int offset) { o=offset; } - const char *name() const { return n; } - const char *url() const { return u; } - int index() const { return i; } - int offset() const { return o; } - - private: - QCString n; - QCString u; - int i; - int o; -}; - -typedef QList DocRefList; -typedef QDict DocRefDict; - -class SearchIndex -{ - public: - SearchIndex(); - ~SearchIndex(); - void addReference(const char *key,const char *ref); - bool addWord(const char *key,const char *word,bool special); - bool saveIndex(const char *fileName); - void dump() { suffixTree->dump(); } - - private: - //IndexTree *indexTree; - SuffixTree *suffixTree; - DocRefList refList; - DocRefDict refDict; - QIntDict nameIndex; - int indexCount; -}; - -#endif - struct URL { URL(const char *n,const char *u) : name(n), url(u) {} diff --git a/src/translator_de.h b/src/translator_de.h index 9ba91e1..3a7880f 100644 --- a/src/translator_de.h +++ b/src/translator_de.h @@ -77,13 +77,16 @@ // - Updated for "new since 1.3" version // - translated Java package to Paket // +// 2003/09/11 Jens Seidel (jensseidel@users.sourceforge.net) +// - Updated for "new since 1.3.1" version +// // Todo: // - see FIXME #ifndef TRANSLATOR_DE_H #define TRANSLATOR_DE_H -class TranslatorGerman : public TranslatorAdapter_1_3_1 +class TranslatorGerman : public Translator { public: @@ -1523,7 +1526,74 @@ class TranslatorGerman : public TranslatorAdapter_1_3_1 { return "Statische Paketattribute"; } + +////////////////////////////////////////////////////////////////////////// +// new since 1.3.1 +////////////////////////////////////////////////////////////////////////// + /*! Used in the quick index of a class/file/namespace member list page + * to link to the unfiltered list of all members. + */ + virtual QCString trAll() + { + return "Alle"; + } + /*! Put in front of the call graph for a function. */ + virtual QCString trCallGraph() + { + return "Hier ist der Graph aller Aufrufe fЭr diese Funktion:"; + } + +////////////////////////////////////////////////////////////////////////// +// new since 1.3.3 +////////////////////////////////////////////////////////////////////////// + + /*! When the search engine is enabled this text is put in the header + * of each page before the field where one can enter the text to search + * for. + */ + virtual QCString trSearchForIndex() + { + return "Suchen nach"; + } + /*! This string is used as the title for the page listing the search + * results. + */ + virtual QCString trSearchResultsTitle() + { + return "Suchergebnisse"; + } + /*! This string is put just before listing the search results. The + * text can be different depending on the number of documents found. + * Inside the text you can put the special marker $num to insert + * the number representing the actual number of search results. + * The @a numDocuments parameter can be either 0, 1 or 2, where the + * value 2 represents 2 or more matches. HTML markup is allowed inside + * the returned string. + */ + virtual QCString trSearchResults(int numDocuments) + { + if (numDocuments==0) + { + return "Es wurden keine Dokumente zu Ihrer Suchanfrage gefunden."; + } + else if (numDocuments==1) + { + return "Es wurde 1 Dokument zu Ihrer Suchanfrage gefunden."; + } + else + { + return "Es wurden $num Dokumente zu Ihrer Suchanfrage " + "gefunden. Die besten Treffer werden zuerst angezeigt."; + } + } + /*! This string is put before the list of matched words, for each search + * result. What follows is the list of words that matched the query. + */ + virtual QCString trSearchMatches() + { + return "Treffer:"; + } }; #endif diff --git a/src/translator_it.h b/src/translator_it.h index 9346593..1a43a17 100644 --- a/src/translator_it.h +++ b/src/translator_it.h @@ -70,7 +70,7 @@ #ifndef TRANSLATOR_IT_H #define TRANSLATOR_IT_H -class TranslatorItalian : public TranslatorAdapter_1_3_3 +class TranslatorItalian : public Translator { public: diff --git a/src/translator_ru.h b/src/translator_ru.h index 39fd1a3..a7ef03c 100644 --- a/src/translator_ru.h +++ b/src/translator_ru.h @@ -18,7 +18,7 @@ * * Nickolay Semyonov * Andrey V. Stolyarov released Feb 14, 2001 - * Alexandr V. Chelpanov released Apr 21, 2001 + * Alexandr V. Chelpanov released Sep 16, 2003 * * При переводе заголовков слова list и documentation убраны. * @@ -48,7 +48,7 @@ #ifndef TRANSLATOR_RU_H #define TRANSLATOR_RU_H -class TranslatorRussian : public TranslatorAdapter_1_3 +class TranslatorRussian : public Translator { private: /*! The Decode() inline assumes the source written in the @@ -1445,6 +1445,121 @@ class TranslatorRussian : public TranslatorAdapter_1_3 { return decode( "Cобытия" ); } + +////////////////////////////////////////////////////////////////////////// +// new since 1.3 +////////////////////////////////////////////////////////////////////////// + + /*! Used as a heading for a list of Java class types with package scope. + */ + virtual QCString trPackageTypes() + { + return decode( "Типы с областью видимости пакета" ); + } + /*! Used as a heading for a list of Java class functions with package + * scope. + */ + virtual QCString trPackageMembers() + { + return decode( "Функции с областью видимости пакета" ); + } + /*! Used as a heading for a list of static Java class functions with + * package scope. + */ + virtual QCString trStaticPackageMembers() + { + return decode( "Статические функции с областью видимости пакета" ); + } + /*! Used as a heading for a list of Java class variables with package + * scope. + */ + virtual QCString trPackageAttribs() + { + return decode( "Переменные с областью видимости пакета" ); + } + /*! Used as a heading for a list of static Java class variables with + * package scope. + */ + virtual QCString trStaticPackageAttribs() + { + return decode( "Статические переменные с областью видимости пакета" ); + } + +////////////////////////////////////////////////////////////////////////// +// new since 1.3.1 +////////////////////////////////////////////////////////////////////////// + + /*! Used in the quick index of a class/file/namespace member list page + * to link to the unfiltered list of all members. + */ + virtual QCString trAll() + { + return decode( "Указатель" ); + } + /*! Put in front of the call graph for a function. */ + virtual QCString trCallGraph() + { + return decode( "Граф вызовов:" ); + } + +////////////////////////////////////////////////////////////////////////// +// new since 1.3.3 +////////////////////////////////////////////////////////////////////////// + + /*! When the search engine is enabled this text is put in the header + * of each page before the field where one can enter the text to search + * for. + */ + virtual QCString trSearchForIndex() + { + return decode( "Поиск" ); + } + /*! This string is used as the title for the page listing the search + * results. + */ + virtual QCString trSearchResultsTitle() + { + return decode( "Результаты поиска" ); + } + /*! This string is put just before listing the search results. The + * text can be different depending on the number of documents found. + * Inside the text you can put the special marker $num to insert + * the number representing the actual number of search results. + * The @a numDocuments parameter can be either 0, 1 or 2, where the + * value 2 represents 2 or more matches. HTML markup is allowed inside + * the returned string. + */ + virtual QCString trSearchResults(int numDocuments) + { + if (numDocuments==0) + { + return decode( "К сожалению, по Вашему запросу ничего не найдено." ); + } + else if( numDocuments == 1 ) + { + return decode( "Найдено $num документ" ) + as_documents( numDocuments ) + + "."; + } + else + { + return decode( "Найдено $num документ" ) + as_documents( numDocuments ) + + decode( ". Документы отсортированы по релевантности." ); + } + } + /*! This string is put before the list of matched words, for each search + * result. What follows is the list of words that matched the query. + */ + virtual QCString trSearchMatches() + { + return decode( "Найдено:" ); + } + + QCString as_documents( int num ) + { + if( num % 10 == 1 ) return ""; + if( (num % 10) >= 2 && (num % 10) <= 4 ) return decode( "а" ); + return decode( "ов" ); + } }; #endif diff --git a/src/xmlgen.cpp b/src/xmlgen.cpp index 757e035..1ba6fe1 100644 --- a/src/xmlgen.cpp +++ b/src/xmlgen.cpp @@ -220,7 +220,7 @@ class XMLCodeGenerator : public BaseCodeDocInterface writeXMLCodeString(m_t,text); } void writeCodeLink(const char *ref,const char *file, - const char *anchor,const char *text) + const char *anchor,const char *name) { XML_DB(("(writeCodeLink)\n")); if (m_insideCodeLine && !m_insideSpecialHL && m_normalHLNeedStartTag) @@ -228,7 +228,7 @@ class XMLCodeGenerator : public BaseCodeDocInterface m_t << ""; m_normalHLNeedStartTag=FALSE; } - writeXMLLink(m_t,ref,file,anchor,text); + writeXMLLink(m_t,ref,file,anchor,name); } void startCodeLine() { -- cgit v0.12