Release-1.5.5-20080420

INSTALL

-DOXYGEN Version 1.5.5-20080325
+DOXYGEN Version 1.5.5-20080420
 
 Please read the installation section of the manual 
 (http://www.doxygen.org/install.html) for instructions.
 
 --------
-Dimitri van Heesch (25 March 2008)
+Dimitri van Heesch (20 April 2008)

Makefile.in

@@ -63,9 +63,6 @@ install: doxywizard_install
 	cat doc/doxytag.1    | sed -e "s/DATE/$(DATE)/g" -e "s/VERSION/$(VERSION)/g" > doxytag.1
 	$(INSTTOOL) -m 644 doxytag.1 $(INSTALL)/$(MAN1DIR)/doxytag.1
 	rm doxytag.1
-	cat doc/doxywizard.1 | sed -e "s/DATE/$(DATE)/g" -e "s/VERSION/$(VERSION)/g" > doxywizard.1
-	$(INSTTOOL) -m 644 doxywizard.1 $(INSTALL)/$(MAN1DIR)/doxywizard.1
-	rm doxywizard.1
 
 install_docs: 
 	$(INSTTOOL) -d $(DOCDIR)
@@ -118,7 +115,7 @@ rpm: dist
 	tar -rvf $(DISTDIR).src.tar $(DISTDIR)/packages/rpm/doxygen.spec
 	rm -rf $(DISTDIR)
 	gzip -9v $(DISTDIR).src.tar
-	rpmbuild -ta $(DISTDIR).src.tar.gz
+	rpmbuild -ta %%WITHDOXYWIZARD%% $(DISTDIR).src.tar.gz
 
 rpmsrc: dist
 	gzip -df $(DISTDIR).src.tar.gz
@@ -129,7 +126,7 @@ rpmsrc: dist
 	tar -rvf $(DISTDIR).src.tar $(DISTDIR)/packages/rpm/doxygen.spec
 	rm -rf $(DISTDIR)
 	gzip -9v $(DISTDIR).src.tar
-	rpmbuild -ts $(DISTDIR).src.tar.gz
+	rpmbuild -ts %%WITHDOXYWIZARD%% $(DISTDIR).src.tar.gz
 
 rpmbinary: dist
 	gzip -df $(DISTDIR).src.tar.gz
@@ -140,7 +137,7 @@ rpmbinary: dist
 	tar -rvf $(DISTDIR).src.tar $(DISTDIR)/packages/rpm/doxygen.spec
 	rm -rf $(DISTDIR)
 	gzip -9v $(DISTDIR).src.tar
-	rpmbuild -tb $(DISTDIR).src.tar.gz
+	rpmbuild -tb %%WITHDOXYWIZARD%% $(DISTDIR).src.tar.gz
 
 
 ctags:

README

-DOXYGEN Version 1.5.5_20080325
+DOXYGEN Version 1.5.5_20080420
 
 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) (25 March 2008)
+Dimitri van Heesch (dimitri@stack.nl) (20 April 2008)

addon/doxywizard/Makefile.in

@@ -41,8 +41,14 @@ clean: Makefile.doxywizard
 distclean: clean
 	$(RM) Makefile.doxywizard version.cpp config.l config.h portable.h portable.cpp
 
+MAN1DIR = man/man1
+
 install:
 	$(INSTTOOL) -d $(INSTALL)/bin	
 	$(INSTTOOL) -m 755 ../../bin/doxywizard $(INSTALL)/bin	
+	$(INSTTOOL) -d $(INSTALL)/$(MAN1DIR)
+	cat ../../doc/doxywizard.1 | sed -e "s/DATE/$(DATE)/g" -e "s/VERSION/$(VERSION)/g" > doxywizard.1
+	$(INSTTOOL) -m 644 doxywizard.1 $(INSTALL)/$(MAN1DIR)/doxywizard.1
+	rm doxywizard.1
 
 FORCE:

configure

@@ -20,7 +20,7 @@ doxygen_version_minor=5
 doxygen_version_revision=5
 
 #NOTE: Setting version_mmn to "NO" will omit mmn info from the package.
-doxygen_version_mmn=20080325
+doxygen_version_mmn=20080420
 
 bin_dirs=`echo $PATH | sed -e "s/:/ /g"`
 
@@ -537,11 +537,7 @@ fi
 mkdir -p packages
 mkdir -p packages/rpm
 
-if test "$f_wizard" = YES; then
-  cat spec.tmp ./packages/rpm/doxygen.spec.in > ./packages/rpm/doxygen.spec
-else
-  cat spec.tmp ./packages/rpm/doxygen-nodoxywizard.spec.in > ./packages/rpm/doxygen.spec
-fi
+cat spec.tmp ./packages/rpm/doxygen.spec.in > ./packages/rpm/doxygen.spec
 
 rm -f spec.tmp
 
@@ -633,7 +629,11 @@ EOF
        fi
        echo "" >> $DST
      fi
-     cat $SRC >> $DST
+     if test $f_wizard = YES; then
+       sed -e "s/%%WITHDOXYWIZARD%% /--with doxywizard /g" $SRC >> $DST
+     else
+       sed -e "s/%%WITHDOXYWIZARD%% //g" $SRC >> $DST
+     fi
      echo "  Created $DST from $SRC..."
 done
 

doc/commands.doc

@@ -54,7 +54,7 @@ documentation:
 \refitem cmdcode \\code
 \refitem cmdcond \\cond
 \refitem cmdcopybrief \\copybrief
-\refitem cmdcopydefails \\copydetails
+\refitem cmdcopydetails \\copydetails
 \refitem cmdcopydoc \\copydoc
 \refitem cmddate \\date
 \refitem cmddef \\def
@@ -152,6 +152,7 @@ documentation:
 \refitem cmdtest \\test
 \refitem cmdthrow \\throw
 \refitem cmdtodo \\todo
+\refitem cmdtparam \\tparam
 \refitem cmdtypedef \\typedef
 \refitem cmdunion \\union
 \refitem cmduntil \\until
@@ -1087,7 +1088,7 @@ ALIASES  = "english=\if english" \
 
   \addindex \\param
   Starts a parameter description for a function parameter with name 
-  \<parameter-name\>. Followed by a description of the parameter. 
+  \<parameter-name\>, followed by a description of the parameter. 
   The existence of the parameter is checked and a warning is given if
   the documentation of this (or any other) parameter is missing or not
   present in the function declaration or definition.
@@ -1116,6 +1117,16 @@ void memcpy(void *dest, const void *src, size_t n);
   sectioning command is encountered. See section \ref cmdfn "\\fn" for an 
   example.
 
+<hr>
+\section cmdtparam \\tparam <template-parameter-name> { description }
+
+  \addindex \\tparam
+  Starts a template parameters for a class or function template parameter
+  with name \<template-parameter-name\>, followed by a description of the
+  template parameter.
+
+  Otherwise similar to \ref cmdparam "\\cmdparam".
+
 <hr>
 \section cmdpost \\post { description of the postcondition }
 

doc/config.doc

@@ -113,6 +113,7 @@ followed by the descriptions of the tags grouped by category.
 \refitem cfg_file_version_filter FILE_VERSION_FILTER
 \refitem cfg_filter_patterns FILTER_PATTERNS
 \refitem cfg_filter_source_files FILTER_SOURCE_FILES
+\refitem cfg_formula_fontsize FORMULA_FONTSIZE
 \refitem cfg_full_path_names FULL_PATH_NAMES
 \refitem cfg_generate_autogen_def GENERATE_AUTOGEN_DEF
 \refitem cfg_generate_buglist GENERATE_BUGLIST
@@ -147,6 +148,7 @@ followed by the descriptions of the tags grouped by category.
 \refitem cfg_html_header HTML_HEADER
 \refitem cfg_html_output HTML_OUTPUT
 \refitem cfg_html_stylesheet HTML_STYLESHEET
+\refitem cfg_idl_property_support IDL_PROPERTY_SUPPORT
 \refitem cfg_ignore_prefix IGNORE_PREFIX
 \refitem cfg_image_path IMAGE_PATH
 \refitem cfg_include_graph INCLUDE_GRAPH
@@ -445,6 +447,16 @@ followed by the descriptions of the tags grouped by category.
  Doxygen will parse them like normal C++ but will assume all classes use public 
  instead of private inheritance when no explicit protection keyword is present. 
 
+\anchor cfg_idl_property_support
+<dt>\c IDL_PROPERTY_SUPPORT <dd>
+ \addindex IDL_PROPERTY_SUPPORT
+ For Microsoft's IDL there are propget and propput attributes to indicate getter
+ and setter methods for a property. Setting this option to \c YES (the default)
+ will make doxygen to replace the get and set methods by a property in the
+ documentation. This will only work if the methods are indeed getting or 
+ setting a simple type. If this is not the case, or you want to show the 
+ methods anyway, you should set this option to \c NO.
+
 \anchor cfg_distribute_group_doc
 <dt>\c DISTRIBUTE_GROUP_DOC <dd>
  \addindex DISTRIBUTE_GROUP_DOC
@@ -1038,14 +1050,14 @@ FILE_VERSION_INFO = "cleartool desc -fmt \%Vn"
 \anchor cfg_referenced_by_relation
 <dt>\c REFERENCED_BY_RELATION <dd>
  \addindex REFERENCED_BY_RELATION
- If the \c REFERENCED_BY_RELATION tag is set to \c YES (the default)
+ If the \c REFERENCED_BY_RELATION tag is set to \c YES
  then for each documented function all documented
  functions referencing it will be listed. 
 
 \anchor cfg_references_relation
 <dt>\c REFERENCES_RELATION <dd>
  \addindex REFERENCES_RELATION
- If the \c REFERENCES_RELATION tag is set to \c YES (the default)
+ If the \c REFERENCES_RELATION tag is set to \c YES
  then for each documented function all documented entities
  called/used by that function will be listed. 
 
@@ -1353,6 +1365,15 @@ FILE_VERSION_INFO = "cleartool desc -fmt \%Vn"
  used to set the initial width (in pixels) of the frame in which the tree
  is shown.
 
+\anchor cfg_formula_fontsize
+<dt>\c FORMULA_FONTSIZE <dd>
+ \addindex FORMULA_FONTSIZE
+ Use this tag to change the font size of Latex formulas included
+ as images in the HTML documentation. The default is 10.
+ when you change the font size after a successful doxygen run you need
+ to manually remove any <code>form_*.png</code> images from the HTML 
+ output directory to force them to be regenerated.
+ 
 </dl>
 \section latex_output LaTeX related options
 \anchor cfg_generate_latex
@@ -1815,6 +1836,26 @@ TAGFILES = file1=loc1 "file2 = loc2" ... </pre>
  <a href="http://www.research.att.com/sw/tools/graphviz/">Graphviz</a>, a graph 
  visualization toolkit from AT\&T and Lucent Bell Labs. The other options in 
  this section have no effect if this option is set to \c NO (the default)
+
+\anchor cfg_dot_fontname
+<dt>\c DOT_FONTNAME <dd>
+ \addindex DOT_FONTNAME
+ By default doxygen will write a font called \c FreeSans.ttf to the output
+ directory and reference it in all dot files that doxygen generates. This
+ font does not include all possible unicode characters however, so when you need 
+ these (or just want a differently looking font) you can specify the font name
+ using \c DOT_FONTNAME. You need need to make sure dot is able to find the font,
+ which can be done by putting it in a standard location or by setting the
+ \c DOTFONTPATH environment variable or by setting \c DOT_FONTPATH to the directory
+ containing the font.
+
+\anchor cfg_dot_fontpath
+<dt>\c DOT_FONTPATH <dd>
+ \addindex DOT_FONTPATH
+ By default doxygen will tell dot to use the output directory to look for the 
+ \c FreeSans.ttf font (which doxygen will put there itself). If you specify a 
+ different font using \c DOT_FONTNAME you can set the path where dot 
+ can find it using this tag.
  
 <dt>\c DOT_FONTNAME <dd>
  \addindex DOT_FONTNAME
@@ -1927,7 +1968,7 @@ TAGFILES = file1=loc1 "file2 = loc2" ... </pre>
 \anchor cfg_dot_graph_max_nodes 
 <dt>\c DOT_GRAPH_MAX_NODES <dd>
  \addindex DOT_GRAPH_MAX_NODES
- The \c MAX_DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of 
+ The \c DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of 
  nodes that will be shown in the graph. If the number of nodes in a graph
  becomes larger than this value, doxygen will truncate the graph, which is 
  visualized by representing a node as a red box. Note that doxygen if the number

doc/doxywizard_usage.doc

@@ -81,7 +81,7 @@ produce. For HTML and LaTeX there are additional options.
 Doxygen can produce a number of diagrams. Using the diagrams tab you
 can select which ones to generate. For most diagrams the 
 dot tool of the <a href="http://www.graphviz.org">GraphViz</a> package
-is needed (if you use the binary packages for Mac or Windows this
+is needed (if you use the binary packages for MacOSX this
 tool is already included).
 
 <h3>Expert dialog</h3>

doc/language.doc

@@ -119,9 +119,9 @@ when the translator was updated.
   </tr>
   <tr bgcolor="#ffffff">
     <td>Finnish</td>
-    <td>Olli Korhonen</td>
-    <td>olli.korhonen lost at cyberspace</td>
-    <td>obsolete</td>
+    <td>Antti Laine</td>
+    <td>antti.a.laine at tut dot fi</td>
+    <td>up-to-date</td>
   </tr>
   <tr bgcolor="#ffffff">
     <td>French</td>
@@ -307,7 +307,7 @@ when the translator was updated.
   \hline
   English & Dimitri van Heesch & {\tt\tiny dimitri@stack.nl} & up-to-date \\
   \hline
-  Finnish & Olli Korhonen & {\tt\tiny olli.korhonen lost@cyberspace} & obsolete \\
+  Finnish & Antti Laine & {\tt\tiny antti.a.laine@tut.fi} & up-to-date \\
   \hline
   French & Xavier Outhier & {\tt\tiny xouthier@yahoo.fr} & 1.5.4 \\
   \hline

doc/maintainers.txt

@@ -46,7 +46,7 @@ TranslatorEnglish
 Dimitri van Heesch: dimitri@stack.nl
 
 TranslatorFinnish
-Olli Korhonen: olli.korhonen lost@cyberspace
+Antti Laine: antti.a.laine@tut.fi
 
 TranslatorFrench
 Xavier Outhier: xouthier@yahoo.fr

doc/translator_report.txt

@@ -9,7 +9,7 @@ German, Greek, Hungarian, Indonesian, Italian, Japanese (+En), Korean
 Romanian, Russian, Serbian, Slovak, Slovene, Spanish, Swedish, and
 Ukrainian.
 
-Of them, 12 translators are up-to-date, 22 translators are based on
+Of them, 13 translators are up-to-date, 21 translators are based on
 some adapter class, and 2 are English based.
 
 ----------------------------------------------------------------------
@@ -25,6 +25,7 @@ still may be some details listed even for them:
   TranslatorCzech
   TranslatorDutch
   TranslatorEnglish
+  TranslatorFinnish
   TranslatorGerman
   TranslatorItalian
   TranslatorKorean
@@ -60,7 +61,6 @@ must be implemented to become up-to-date:
   TranslatorRomanian              1.4.1 	24 methods to implement
   TranslatorPortuguese            1.3.3 	35 methods to implement
   TranslatorSlovak                1.2.18	44 methods to implement
-  TranslatorFinnish               obsolete	118 methods to implement
 
 ----------------------------------------------------------------------
 The following translator classes derive directly from the
@@ -215,144 +215,6 @@ TranslatorDanish   (TranslatorAdapter_1_5_4)  22 methods to implement
     virtual QCString trSubprogramDocumentation()
 
 
-TranslatorFinnish   (TranslatorEnglish)  118 methods to implement
------------------
-
-  Implements 98 of the required methods.
-
-  Missing methods (should be implemented):
-
-    virtual QCString trPublicAttribs()
-    virtual QCString trPropertyDocumentation()
-    virtual QCString trMember(bool first_capital, bool singular)
-    virtual QCString trPageIndex()
-    virtual QCString trCompoundMembersDescriptionFortran(bool extractAll)
-    virtual QCString trOverloadText()
-    virtual QCString trSince()
-    virtual QCString trEventDocumentation()
-    virtual QCString trDirIndex()
-    virtual QCString trRemarks()
-    virtual QCString trProtectedTypes()
-    virtual QCString trGeneratedFromFilesFortran(ClassDef::CompoundType compType, bool single)
-    virtual QCString trFile(bool first_capital, bool singular)
-    virtual QCString trPackages()
-    virtual QCString trInclByDepGraph()
-    virtual QCString trRTFansicp()
-    virtual QCString trImplementedFromList(int numEntries)
-    virtual QCString trSubprograms()
-    virtual QCString trCollaborationDiagram(const char * clName)
-    virtual QCString trPackageListDescription()
-    virtual QCString trDefineValue()
-    virtual QCString trPackageMembers()
-    virtual QCString trStaticPackageMembers()
-    virtual QCString trModulesListDescription(bool extractAll)
-    virtual QCString trModulesList()
-    virtual QCString trDirDocumentation()
-    virtual QCString trPackage(const char * name)
-    virtual QCString trPublicTypes()
-    virtual QCString trSearchResultsTitle()
-    virtual QCString trDirectories()
-    virtual QCString trTest()
-    virtual QCString trTypeConstraints()
-    virtual QCString trInvariant()
-    virtual QCString trDeprecatedList()
-    virtual QCString trGraphicalHierarchy()
-    virtual QCString trPostcondition()
-    virtual QCString trGotoGraphicalHierarchy()
-    virtual QCString trPageAbbreviation()
-    virtual QCString trMemberFunctionDocumentationFortran()
-    virtual QCString trDirDescription()
-    virtual QCString trGotoSourceCode()
-    virtual QCString trStaticPackageAttribs()
-    virtual QCString trCompoundListDescriptionFortran()
-    virtual QCString trCallGraph()
-    virtual QCString trStaticPublicAttribs()
-    virtual QCString trCode()
-    virtual QCString trTodo()
-    virtual QCString trTypeDocumentation()
-    virtual QCString trModuleReference(const char * namespaceName)
-    virtual QCString trModulesMemberDescription(bool extractAll)
-    virtual QCString trRTFCharSet()
-    virtual QCString trModulesMembers()
-    virtual QCString trInitialValue()
-    virtual QCString trAlphabeticalList()
-    virtual QCString trBug()
-    virtual QCString trNote()
-    virtual QCString trStaticPrivateAttribs()
-    virtual QCString trAttention()
-    virtual QCString trGotoTextualHierarchy()
-    virtual QCString trModulesIndex()
-    virtual QCString trPackageTypes()
-    virtual QCString trMainPage()
-    virtual QCString trDeprecated()
-    virtual QCString trCompoundListFortran()
-    virtual QCString trClass(bool first_capital, bool singular)
-    virtual QCString trImplementedInList(int numEntries)
-    virtual QCString trPrivateTypes()
-    virtual QCString trDataTypes()
-    virtual QCString trInclDepGraph(const char * fName)
-    virtual QCString trSearchResults(int numDocuments)
-    virtual QCString trGeneratedFromFiles(ClassDef::CompoundType compType, bool single)
-    virtual QCString trNamespaces()
-    virtual QCString trPrivateAttribs()
-    virtual QCString idLanguageCharset()
-    virtual QCString trDefinedInSourceFile()
-    virtual QCString trConstructorDocumentation()
-    virtual QCString trLegend()
-    virtual QCString trPackageAttribs()
-    virtual QCString trSearchMatches()
-    virtual QCString trClasses()
-    virtual QCString trProtectedAttribs()
-    virtual QCString trLegendTitle()
-    virtual QCString trCompoundIndexFortran()
-    virtual QCString trSubprogram(bool first_capital, bool singular)
-    virtual QCString trEvents()
-    virtual QCString trGlobal(bool first_capital, bool singular)
-    virtual QCString trDCOPMethods()
-    virtual QCString latexLanguageSupportCommand()
-    virtual QCString trBugList()
-    virtual QCString trRTFGeneralIndex()
-    virtual QCString trCallerGraph()
-    virtual QCString trNamespace(bool first_capital, bool singular)
-    virtual QCString trTestList()
-    virtual QCString trPrecondition()
-    virtual QCString trCompoundReferenceFortran(const char * clName, ClassDef::CompoundType compType, bool isTemplate)
-    virtual QCString trReturnValues()
-    virtual QCString trReferences()
-    virtual QCString trType(bool first_capital, bool singular)
-    virtual QCString trAuthor(bool first_capital, bool singular)
-    virtual QCString trLegendDocs()
-    virtual QCString trModule(bool first_capital, bool singular)
-    virtual QCString trPackageList()
-    virtual QCString trTodoList()
-    virtual QCString trPage(bool first_capital, bool singular)
-    virtual QCString trCompoundMembersFortran()
-    virtual QCString trSourceFile(QCString & filename)
-    virtual QCString trGotoDocumentation()
-    virtual QCString trDefinedAtLineInSourceFile()
-    virtual QCString trDirReference(const char * dirName)
-    virtual QCString trDir(bool first_capital, bool singular)
-    virtual QCString trSearchForIndex()
-    virtual QCString trAll()
-    virtual QCString trSubprogramDocumentation()
-    virtual QCString trRTFTableOfContents()
-    virtual QCString trGroup(bool first_capital, bool singular)
-    virtual QCString trReferencedBy()
-    virtual QCString trStaticProtectedAttribs()
-    virtual QCString trProperties()
-
-  Obsolete methods (should be removed, never used):
-
-    QCString trHeaderFilesDescription()
-    QCString trReimplementedForInternalReasons()
-    QCString trFiles()
-    virtual QCString updateNeededMessage()
-    QCString trHeaderFiles()
-    QCString trAuthors()
-    QCString trBugsAndLimitations()
-    QCString trNoDescriptionAvailable()
-
-
 TranslatorFrench   (TranslatorAdapter_1_5_4)  22 methods to implement
 ----------------
 

packages/rpm/doxygen-nodoxywizard.spec.in

-%define name doxygen
-
-%define contentdir /var/www
-%define suexec_caller doxygen
-%define buildroot /var/tmp/%{name}-%{version}-%{revision}root
-
-Summary: A documentation system for C/C++.
-Name: doxygen
-Version: %{version}
-Release: %{revision}
-URL: http://www.stack.nl/~dimitri/doxygen/index.html
-Vendor: Dimitri van Heesch
-License: GNU General Public License
-Group: Development/Tools
-Source: %{name}-%{version}_%{revision}.src.tar.gz
-BuildRoot: %{buildroot}
-BuildPrereq: libstdc++-devel >= 2.96, /usr/bin/perl, /usr/bin/latex, /usr/bin/dvips
-Prereq: /sbin/chkconfig, /bin/mktemp, /bin/rm, /bin/mv, libstdc++ >= 2.96
-Provides: doxygen = %{mmn}
-
-%description
-Doxygen can generate an online class browser (in HTML) and/or a
-reference manual (in LaTeX) from a set of documented source files. The
-documentation is extracted directly from the sources. Doxygen can
-also be configured to extract the code structure from undocumented
-source files.
-
-%prep
-%setup -q -n %{name}-%{version}_%{revision}
-./configure --prefix $RPM_BUILD_ROOT/usr
-
-%build
-make %{?_smp_mflags}
-make %{?_smp_mflags} pdf
-
-%install
-rm -rf $RPM_BUILD_ROOT
-make install
-
-%clean
-rm -rf $RPM_BUILD_ROOT
-
-%files
-%defattr(-,root,root)
-
-%doc README LICENSE LANGUAGE.HOWTO examples ./latex/*.pdf
-%doc /usr/man/man1/doxygen.1.gz
-%doc /usr/man/man1/doxytag.1.gz
-
-%{_bindir}/doxygen
-%{_bindir}/doxytag
-
-%changelog
-* Sun Nov 18 2007 Kevin McBride <kevin@planetsaphire.com> 1.5.4
-- consolidated manual package in lieu of --excludedocs flag for rpm --install
-
-* Fri Oct 21 2005 Kevin McBride <kevin@planetsaphire.com> 1.4.5
-- made .spec file compatible with tmake
-
-* Mon Oct 10 2005 Kevin McBride <kevin@planetsaphire.com> 1.4.5
-- fixed versioning bugs.
-
-* Tue Oct 4 2005 Kevin McBride <kevin@planetsaphire.com> 1.4.5
-- added obsoletes and proides sections.
-
-* Sun Sep 20 2005 Kevin McBride <kevin@planetsaphire.com> 1.4.4
-- modified rpm spec file for Fedora Core acceptance criteria.
-
-* Sun Aug 7 2005 Kevin McBride <kevin@planetsaphire.com> 1.4.4
-- created initial rpm spec file for doxygen-1.4.4
-

packages/rpm/doxygen.spec.in

 %define name doxygen
 
+# optionally pass --with-doxywizard to rpmbuild
+
 %define contentdir /var/www
 %define suexec_caller doxygen
 %define buildroot /var/tmp/%{name}-%{version}-%{revision}root
@@ -14,7 +16,7 @@ License: GNU General Public License
 Group: Development/Tools
 Source: %{name}-%{version}_%{revision}.src.tar.gz
 BuildRoot: %{buildroot}
-BuildPrereq: libstdc++-devel >= 2.96, /usr/bin/perl, /usr/bin/latex, /usr/bin/dvips
+BuildPrereq: libstdc++-devel >= 2.96, /usr/bin/perl, /usr/bin/latex, /usr/bin/dvips, /usr/bin/gs
 Prereq: /sbin/chkconfig, /bin/mktemp, /bin/rm, /bin/mv, libstdc++ >= 2.96
 Provides: doxygen = %{mmn}
 
@@ -25,6 +27,7 @@ documentation is extracted directly from the sources. Doxygen can
 also be configured to extract the code structure from undocumented
 source files.
 
+%if %{?_with_doxywizard:1}%{!?_with_doxywizard:0}
 %package doxywizard
 Group: Development/Libraries
 Summary: GUI Interface for doxygen.
@@ -42,10 +45,11 @@ source files.
 
 This is the GUI interface for doxygen.  It requires qt and X11 to
 install.
+%endif
 
 %prep
 %setup -q -n %{name}-%{version}_%{revision}
-./configure --with-doxywizard --prefix $RPM_BUILD_ROOT/usr
+./configure %{?_with_doxywizard} --prefix $RPM_BUILD_ROOT/usr
 
 %build
 make %{?_smp_mflags}
@@ -68,12 +72,18 @@ rm -rf $RPM_BUILD_ROOT
 %{_bindir}/doxygen
 %{_bindir}/doxytag
 
+%if %{?_with_doxywizard:1}%{!?_with_doxywizard:0}
 %files doxywizard
 %defattr(-,root,root)
 %{_bindir}/doxywizard
 %doc /usr/man/man1/doxywizard.1.gz
+%endif
 
 %changelog
+* Fri Apr 18 2008 Kenneth Porter <shiva+doxygenspec@sewingwitch.com> 1.5.5-1
+- consolidate with and without doxywizard spec files with rpm macro
+- add gs BuildPrereq
+
 * Sun Nov 18 2007 Kevin McBride <kevin@planetsaphire.com> 1.5.4
 - consolidated manual package in lieu of --excludedocs flag for rpm --install
 

src/classdef.cpp

@@ -1075,6 +1075,12 @@ void ClassDef::writeClassDiagrams(OutputList &ol)
       if (ok && bcd)
       {
         ClassDef *cd=bcd->classDef;
+
+        // use the class name but with the template arguments as given
+        // in the inheritance relation
+        QCString displayName = insertTemplateSpecifierInScope(
+            cd->name(),bcd->templSpecifiers);
+
         if (cd->isLinkable())
         {
           if (!Config_getString("GENERATE_TAGFILE").isEmpty()) 
@@ -1098,11 +1104,11 @@ void ClassDef::writeClassDiagrams(OutputList &ol)
           ol.writeObjectLink(cd->getReference(),
                              cd->getOutputFileBase(),
                              0,
-                             cd->displayName()+bcd->templSpecifiers);
+                             displayName);
         }
         else
         {
-          ol.docify(cd->displayName());
+          ol.docify(displayName);
         }
       }
       else
@@ -3384,3 +3390,15 @@ bool ClassDef::isUsedOnly() const
   return m_impl->usedOnly;
 }
 
+void ClassDef::reclassifyMember(MemberDef *md,MemberDef::MemberType t)
+{
+  md->setMemberType(t);
+  MemberList *ml = m_impl->memberLists.first();
+  while (ml)
+  {
+    ml->remove(md);
+    ml = m_impl->memberLists.next();
+  }
+  insertMember(md);
+}
+

src/classdef.h

@@ -314,6 +314,7 @@ class ClassDef : public Definition
     void writeDeclaration(OutputList &ol,MemberDef *md,bool inGroup);
     void writeDetailedDescription(OutputList &ol,const QCString &pageType,bool exampleFlag);
     void writeQuickMemberLinks(OutputList &ol,MemberDef *md) const;
+    void reclassifyMember(MemberDef *md,MemberDef::MemberType t);
     
     bool visited;
 

src/config.l

@@ -961,7 +961,7 @@ void Config::check()
   //}
 
   QCString &warnFormat = Config_getString("WARN_FORMAT");
-  if (warnFormat.isEmpty())
+  if (warnFormat.stripWhiteSpace().isEmpty())
   {
     warnFormat="$file:$line $text";
   }
@@ -969,18 +969,15 @@ void Config::check()
   {
     if (warnFormat.find("$file")==-1)
     {
-      config_err("Error: warning format does not contain a $file tag!\n");
-      exit(1);
+      config_err("Warning: warning format does not contain a $file tag!\n");
     }
     if (warnFormat.find("$line")==-1)
     {
-      config_err("Error: warning format does not contain a $line tag!\n");
-      exit(1);
+      config_err("Warning: warning format does not contain a $line tag!\n");
     }
     if (warnFormat.find("$text")==-1)
     {
-      config_err("Error: wanring format foes not contain a $text tag!\n");
-      exit(1);
+      config_err("Warning: warning format foes not contain a $text tag!\n");
     }
   }
 
@@ -1248,6 +1245,28 @@ void Config::check()
     examplePatternList.append("*");
   }
 
+  // if no output format is enabled, warn the user
+  if (!Config_getBool("GENERATE_HTML")    && 
+      !Config_getBool("GENERATE_LATEX")   &&
+      !Config_getBool("GENERATE_MAN")     && 
+      !Config_getBool("GENERATE_RTF")     &&
+      !Config_getBool("GENERATE_XML")     &&
+      !Config_getBool("GENERATE_PERLMOD") &&
+      !Config_getBool("GENERATE_RTF")     &&
+      !Config_getBool("GENERATE_AUTOGEN_DEF") &&
+      Config_getString("GENERATE_TAGFILE").isEmpty()
+     )
+  {
+    config_err("Warning: No output formats selected! Set at least one of the main GENERATE_* options to YES.\n");
+  }
+
+  // you can't generate HTMLHELP without HTML enabled!
+  if (!Config_getBool("GENERATE_HTML") && 
+      Config_getBool("GENERATE_HTMLHELP"))
+  {
+    config_err("Warning: GENERATE_HTMLHELP=YES requires GENERATE_HTML=YES.\n");
+  }
+
   if (Config_getBool("HAVE_DOT")) 
   {
     QCString curFontPath = Config_getString("DOT_FONTPATH");
@@ -1299,28 +1318,6 @@ void Config::check()
     annotationFromBrief.append("the");
   }
 
-#if 0
-  if (Config_getBool("CALL_GRAPH") && 
-      (!Config_getBool("SOURCE_BROWSER") || !Config_getBool("REFERENCES_RELATION"))
-     )
-  {
-      config_err("Warning: turning on CALL_GRAPH requires turning "
-	         "SOURCE_BROWSER and\nREFERENCES_RELATION on as well!\n"
-		 "Assuming SOURCE_BROWSER=YES and REFERENCES_RELATION=YES\n");
-      Config_getBool("SOURCE_BROWSER")=TRUE;
-      Config_getBool("REFERENCES_RELATION")=TRUE;
-  }
-  if (Config_getBool("CALLER_GRAPH") && 
-      (!Config_getBool("SOURCE_BROWSER") || !Config_getBool("REFERENCED_BY_RELATION"))
-     )
-  {
-      config_err("Warning: turning on CALLER_GRAPH requires turning "
-	         "SOURCE_BROWSER and\nREFERENCEDBY_RELATION on as well!\n"
-		 "Assuming SOURCE_BROWSER=YES and REFERENCED_BY_RELATION=YES\n");
-      Config_getBool("SOURCE_BROWSER")=TRUE;
-      Config_getBool("REFERENCED_BY_RELATION")=TRUE;
-  }
-#endif
   // some default settings for vhdl
   if (Config_getBool("OPTIMIZE_OUTPUT_VHDL") && 
       (Config_getBool("INLINE_INHERITED_MEMB") || 
@@ -1743,6 +1740,15 @@ void Config::create()
 		    "instead of private inheritance when no explicit protection keyword is present. \n",
                     FALSE
                  );
+  cb = addBool(    "IDL_PROPERTY_SUPPORT",
+                   "For Microsoft's IDL there are propget and propput attributes to indicate getter \n"
+		   "and setter methods for a property. Setting this option to YES (the default) \n"
+		   "will make doxygen to replace the get and set methods by a property in the \n"
+		   "documentation. This will only work if the methods are indeed getting or \n"
+		   "setting a simple type. If this is not the case, or you want to show the \n"
+		   "methods anyway, you should set this option to NO. \n",
+		   TRUE
+		  );
   cb = addBool(
                     "DISTRIBUTE_GROUP_DOC",
                     "If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC \n"
@@ -2209,13 +2215,13 @@ void Config::create()
                     TRUE
                  );
   cb = addBool(     "REFERENCED_BY_RELATION",
-                    "If the REFERENCED_BY_RELATION tag is set to YES (the default) \n"
+                    "If the REFERENCED_BY_RELATION tag is set to YES \n"
 		    "then for each documented function all documented \n"
 		    "functions referencing it will be listed. \n",
                     FALSE
               );
   cb = addBool(     "REFERENCES_RELATION",
-                    "If the REFERENCES_RELATION tag is set to YES (the default) \n"
+                    "If the REFERENCES_RELATION tag is set to YES \n"
 		    "then for each documented function all documented entities \n"
 		    "called/used by that function will be listed. \n",
                     FALSE
@@ -2339,8 +2345,8 @@ void Config::create()
                     "of the generated HTML documentation. \n",
                     FALSE
                  );
-  cb = addBool(
-                    "GENERATE_DOCSET",
+  cb->addDependency("GENERATE_HTML");
+  cb = addBool( "GENERATE_DOCSET",
                     "If the GENERATE_DOCSET tag is set to YES, additional index files \n"
                     "will be generated that can be used as input for Apple's Xcode 3 \n"
                     "integrated development environment, introduced with OSX 10.5 (Leopard). \n"
@@ -2360,7 +2366,7 @@ void Config::create()
 		    "can be grouped. \n"
                 );
   cs->setDefaultValue("Doxygen generated docs");
-  cb->addDependency("GENERATE_DOCSET");
+  cs->addDependency("GENERATE_DOCSET");
   cs = addString(
                     "DOCSET_BUNDLE_ID",
                     "When GENERATE_DOCSET tag is set to YES, this tag specifies a string that \n"
@@ -2369,7 +2375,7 @@ void Config::create()
 		    "will append .docset to the name. \n"
 		);
   cs->setDefaultValue("org.doxygen.Project");
-  cb->addDependency("GENERATE_DOCSET");
+  cs->addDependency("GENERATE_DOCSET");
 
   cb = addBool(
                     "HTML_DYNAMIC_SECTIONS",
@@ -2468,6 +2474,16 @@ void Config::create()
                     0,1500,250
                  );
   ci->addDependency("GENERATE_HTML");
+  ci = addInt(
+                    "FORMULA_FONTSIZE",
+                    "Use this tag to change the font size of Latex formulas included \n"
+                    "as images in the HTML documentation. The default is 10. Note that \n"
+		    "when you change the font size after a successful doxygen run you need \n"
+		    "to manually remove any form_*.png images from the HTML output directory \n"
+		    "to force them to be regenerated. \n",
+                    8,50,10
+                 );
+  ci->addDependency("GENERATE_HTML");
 
   //-----------------------------------------------------------------------------------------------
   addInfo(  "LaTeX","configuration options related to the LaTeX output");
@@ -3080,7 +3096,7 @@ void Config::create()
   cl->addDependency("HAVE_DOT");
   ci = addInt(
                     "DOT_GRAPH_MAX_NODES",
-                    "The MAX_DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of \n"
+                    "The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of \n"
                     "nodes that will be shown in the graph. If the number of nodes in a graph \n"
                     "becomes larger than this value, doxygen will truncate the graph, which is \n"
                     "visualized by representing a node as a red box. Note that doxygen if the \n"

src/defargs.l

@@ -317,7 +317,7 @@ ID	[a-z_A-Z][a-z_A-Z0-9]*
 						a->array = a->array.mid(1,alen-2);
 						if (i>0 && a->name.isEmpty())
 						{
-						  a->name  = a->array.left(i);
+						  a->name  = a->array.left(i).stripWhiteSpace();
 						  a->array = a->array.mid(i);
 						}
 					      }

src/defgen.cpp

@@ -479,7 +479,7 @@ void generateDEFSection(Definition *d,
     MemberList *ml,
     const char *kind)
 {
-  if (ml->count()>0)
+  if (ml && ml->count()>0)
   {
     t << "    " << kind << " = {" << endl;
     MemberListIterator mli(*ml);

src/diagram.cpp

@@ -208,7 +208,9 @@ QCString DiagramItem::label() const
   QCString result;
   if (!templSpec.isEmpty())
   {
-    result=insertTemplateSpecifierInScope(classDef->displayName(),templSpec);
+    // we use classDef->name() here and not diplayName() in order
+    // to get the name used in the inheritance relation.
+    result=insertTemplateSpecifierInScope(classDef->name(),templSpec);
   }
   else
   {

src/docparser.cpp

@@ -339,6 +339,7 @@ static void checkArgumentName(const QString &name,bool isParam)
     for (ali.toFirst();(a=ali.current());++ali)
     {
       QString argName = g_memberDef->isDefine() ? a->type : a->name;
+      argName=argName.stripWhiteSpace();
       //printf("argName=`%s'\n",argName.data());
       if (argName.right(3)=="...") argName=argName.left(argName.length()-3);
       if (aName==argName) 
@@ -368,7 +369,7 @@ static void checkArgumentName(const QString &name,bool isParam)
         
       }
       warn_doc_error(docFile,docLine,
-	  "Warning: argument `%s' of command @param "
+	  "Warning: argument '%s' of command @param "
 	  "is not found in the argument list of %s%s%s%s",
 	  aName.data(),scope.data(),g_memberDef->name().data(),
 	  argListToString(al.pointer()).data(),inheritedFrom.data());
@@ -397,6 +398,7 @@ static void checkUndocumentedParams()
       for (ali.toFirst();(a=ali.current());++ali)
       {
         QString argName = g_memberDef->isDefine() ? a->type : a->name;
+        argName=argName.stripWhiteSpace();
         if (argName.right(3)=="...") argName=argName.left(argName.length()-3);
         if (!argName.isEmpty() && g_paramsFound.find(argName)==0 && a->docs.isEmpty()) 
         {
@@ -415,6 +417,7 @@ static void checkUndocumentedParams()
         for (ali.toFirst();(a=ali.current());++ali)
         {
           QString argName = g_memberDef->isDefine() ? a->type : a->name;
+          argName=argName.stripWhiteSpace();
           if (!argName.isEmpty() && g_paramsFound.find(argName)==0) 
           {
             if (!first)
@@ -425,7 +428,7 @@ static void checkUndocumentedParams()
             {
               first=FALSE;
             }
-            errMsg+="  parameter "+argName;
+            errMsg+="  parameter '"+argName+"'";
           }
         }
         if (g_memberDef->inheritsDocsFrom())

src/dot.cpp

@@ -617,6 +617,7 @@ void DotNode::writeBox(QTextStream &t,
     t << "\\n|";
     writeBoxMemberList(t,'+',m_classDef->getMemberList(MemberList::pubAttribs),m_classDef);
     writeBoxMemberList(t,'+',m_classDef->getMemberList(MemberList::pubStaticAttribs),m_classDef);
+    writeBoxMemberList(t,'+',m_classDef->getMemberList(MemberList::properties),m_classDef);
     writeBoxMemberList(t,'~',m_classDef->getMemberList(MemberList::pacAttribs),m_classDef);
     writeBoxMemberList(t,'~',m_classDef->getMemberList(MemberList::pacStaticAttribs),m_classDef);
     writeBoxMemberList(t,'#',m_classDef->getMemberList(MemberList::proAttribs),m_classDef);

src/doxygen.cpp

@@ -1938,15 +1938,27 @@ static MemberDef *addVariableToClass(
     MemberDef *md;
     for (mni.toFirst();(md=mni.current());++mni)
     {
-      if (md->getClassDef()==cd && root->type==md->typeString()) 
+      //printf("md->getClassDef()=%p cd=%p type=[%s] md->typeString()=[%s]\n",
+      //    md->getClassDef(),cd,root->type.data(),md->typeString());
+      if (md->getClassDef()==cd && 
+          removeRedundantWhiteSpace(root->type)==md->typeString()) 
         // member already in the scope
       {
+
+        if (root->objc && 
+            root->mtype==Property && 
+            md->memberType()==MemberDef::Variable)
+        { // Objective-C 2.0 property
+          // turn variable into a property
+          cd->reclassifyMember(md,MemberDef::Property);
+        }
         addMemberDocs(rootNav,md,def,0,FALSE);
         //printf("    Member already found!\n");
         return md;
       }
     } 
   }
+
   // new member variable, typedef or enum value
   MemberDef *md=new MemberDef(
       root->fileName,root->startLine,
@@ -1985,7 +1997,7 @@ static MemberDef *addVariableToClass(
   //
   md->setBodyDef(rootNav->fileDef());
 
-  //printf("Adding member=%s\n",md->name().data());
+  //printf("    Adding member=%s\n",md->name().data());
   // add the member to the global list
   if (mn)
   {
@@ -2104,6 +2116,7 @@ static MemberDef *addVariableToFile(
            || (nd!=0 && md->getNamespaceDef()==nd) // both in same namespace
           )
           && !md->isDefine() // function style #define's can be "overloaded" by typedefs or variables
+          && !md->isEnumerate() // in C# an enum value and enum can have the same name
          )
         // variable already in the scope
       {
@@ -6510,7 +6523,7 @@ static void addEnumValuesToEnums(EntryNav *rootNav)
                 e->loadEntry(g_storage);
                 MemberDef *fmd = addVariableToFile(e,MemberDef::EnumValue,
                                  md->getOuterScope() ? md->getOuterScope()->name() : QCString(),
-                                 e->name(),TRUE,0); 
+                                 e->name(),FALSE,0); 
                 md->insertEnumField(fmd);
                 fmd->setEnumScope(md);
                 e->releaseEntry();
@@ -9832,6 +9845,7 @@ void parseInput()
   //}
   classEntries.clear();          
 
+  msg("Add enum values to enums...\n");
   addEnumValuesToEnums(rootNav);
   findEnumDocumentation(rootNav);
 
@@ -10166,7 +10180,9 @@ void generateOutput()
     msg("Generating Perl module output...\n");
     generatePerlMod();
   }
-  if (Config_getBool("GENERATE_HTMLHELP") && !Config_getString("HHC_LOCATION").isEmpty())
+  if (Config_getBool("GENERATE_HTML") &&
+      Config_getBool("GENERATE_HTMLHELP") && 
+      !Config_getString("HHC_LOCATION").isEmpty())
   {
     msg("Running html help compiler...\n");
     QString oldDir = QDir::currentDirPath();

src/filedef.cpp

@@ -662,7 +662,7 @@ void FileDef::writeSource(OutputList &ol)
     startFile(ol,getSourceFileBase(),0,pageTitle,HLI_FileVisible,TRUE);
     getDirDef()->writeNavigationPath(ol);
     ol.endQuickIndices();
-    ol.endContents();
+    ol.startContents();
     startTitle(ol,getOutputFileBase());
     ol.parseText(name());
     endTitle(ol,getOutputFileBase(),title);

src/formula.cpp

@@ -166,7 +166,10 @@ void FormulaList::generateBitmaps(const char *path)
       }
       // scale the image so that it is four times larger than needed.
       // and the sizes are a multiple of four.
-      const double scaleFactor = 16.0/3.0; 
+      double scaleFactor = 16.0/3.0; 
+      int zoomFactor = Config_getInt("FORMULA_FONTSIZE");
+      if (zoomFactor<8 || zoomFactor>50) zoomFactor=10;
+      scaleFactor *= zoomFactor/10.0;
       int gx = (((int)((x2-x1)*scaleFactor))+3)&~2;
       int gy = (((int)((y2-y1)*scaleFactor))+3)&~2;
       // Then we run ghostscript to convert the postscript to a pixmap

src/groupdef.cpp

@@ -60,24 +60,6 @@ GroupDef::GroupDef(const char *df,int dl,const char *na,const char *t,
   memberGroupSDict->setAutoDelete(TRUE);
 
   allMemberList = new MemberList(MemberList::allMembersList);
-#if 0
-
-  decDefineMembers.setInGroup(TRUE);
-  decProtoMembers.setInGroup(TRUE);
-  decTypedefMembers.setInGroup(TRUE);
-  decEnumMembers.setInGroup(TRUE);
-  decEnumValMembers.setInGroup(TRUE);
-  decFuncMembers.setInGroup(TRUE);
-  decVarMembers.setInGroup(TRUE);
-
-  docDefineMembers.setInGroup(TRUE);
-  docProtoMembers.setInGroup(TRUE);
-  docTypedefMembers.setInGroup(TRUE);
-  docEnumMembers.setInGroup(TRUE);
-  docEnumValMembers.setInGroup(TRUE);
-  docFuncMembers.setInGroup(TRUE);
-  docVarMembers.setInGroup(TRUE);
-#endif
 
   visited = 0;
   groupScope = 0;
@@ -142,14 +124,6 @@ void GroupDef::findSectionsInDocumentation()
       ml->findSectionsInDocumentation();
     }
   }
-#if 0
-  decDefineMembers.findSectionsInDocumentation();
-  decProtoMembers.findSectionsInDocumentation();
-  decTypedefMembers.findSectionsInDocumentation();
-  decEnumMembers.findSectionsInDocumentation();
-  decFuncMembers.findSectionsInDocumentation();
-  decVarMembers.findSectionsInDocumentation();
-#endif
 }
 
 void GroupDef::addFile(const FileDef *def)
@@ -224,15 +198,6 @@ void GroupDef::addMembersToMemberGroup()
       ::addMembersToMemberGroup(ml,&memberGroupSDict,this);
     }
   }
-#if 0
-  ::addMembersToMemberGroup(&decDefineMembers,&memberGroupSDict,this);
-  ::addMembersToMemberGroup(&decProtoMembers,&memberGroupSDict,this);
-  ::addMembersToMemberGroup(&decTypedefMembers,&memberGroupSDict,this);
-  ::addMembersToMemberGroup(&decEnumMembers,&memberGroupSDict,this);
-  ::addMembersToMemberGroup(&decEnumValMembers,&memberGroupSDict,this);
-  ::addMembersToMemberGroup(&decFuncMembers,&memberGroupSDict,this);
-  ::addMembersToMemberGroup(&decVarMembers,&memberGroupSDict,this);
-#endif
 
   //printf("GroupDef::addMembersToMemberGroup() memberGroupList=%d\n",memberGroupList->count());
   MemberGroupSDict::Iterator mgli(*memberGroupSDict);
@@ -872,14 +837,6 @@ void GroupDef::writeMemberPages(OutputList &ol)
        ml->writeDocumentationPage(ol,name(),this);
     }
   }
-#if 0
-  docDefineMembers.writeDocumentationPage(ol,name(),this);
-  docProtoMembers.writeDocumentationPage(ol,name(),this);
-  docTypedefMembers.writeDocumentationPage(ol,name(),this);
-  docEnumMembers.writeDocumentationPage(ol,name(),this);
-  docFuncMembers.writeDocumentationPage(ol,name(),this);
-  docVarMembers.writeDocumentationPage(ol,name(),this);
-#endif
 
   ol.popGeneratorState();
 }
@@ -1154,14 +1111,6 @@ void GroupDef::addListReferences()
       ml->addListReferences(this);
     }
   }
-#if 0
-  docDefineMembers.addListReferences(this);
-  docProtoMembers.addListReferences(this);
-  docTypedefMembers.addListReferences(this);
-  docEnumMembers.addListReferences(this);
-  docFuncMembers.addListReferences(this);
-  docVarMembers.addListReferences(this);
-#endif
 }
 
 MemberList *GroupDef::createMemberList(MemberList::ListType lt)

src/index.cpp

@@ -1736,7 +1736,6 @@ void writeQuickMemberIndex(OutputList &ol,
     }
   }
   endQuickIndexList(ol);
-  ol.newParagraph();
 }
 
 //----------------------------------------------------------------------------

src/language.cpp

@@ -54,7 +54,7 @@
 #include "translator_es.h"
 #endif
 #ifdef LANG_FI
-//#include "translator_fi.h"
+#include "translator_fi.h"
 #endif
 #ifdef LANG_RU
 #include "translator_ru.h"

src/memberdef.cpp

@@ -533,8 +533,8 @@ void MemberDefImpl::init(Definition *def,
   {
     declArgList = new ArgumentList;
     stringToArgumentList(args,declArgList,&extraTypeChars);
-    //printf("setDeclArgList %s to %p const=%d\n",args.data(),
-    //    declArgList,declArgList->constSpecifier);
+    //printf("setDeclArgList %s to %s const=%d\n",args.data(),
+    //    argListToString(declArgList).data(),declArgList->constSpecifier);
   }
   else
   {
@@ -766,7 +766,10 @@ QCString MemberDef::anchor() const
   QCString result=m_impl->anc;
   if (m_impl->groupAlias)     return m_impl->groupAlias->anchor();
   if (m_impl->templateMaster) return m_impl->templateMaster->anchor();
-  if (m_impl->enumScope) result.prepend(m_impl->enumScope->anchor());
+  if (m_impl->enumScope && m_impl->enumScope!=this) // avoid recursion for C#'s public enum E { E, F }
+  {
+    result.prepend(m_impl->enumScope->anchor());
+  }
   if (m_impl->group) 
   {
     if (m_impl->groupMember)
@@ -1047,9 +1050,10 @@ bool MemberDef::isBriefSectionVisible() const
 
   //printf("visibleIfStatic=%d visibleIfDocumented=%d visibleIfEnabled=%d "
   //       "visibleIfPrivate=%d visibltIfNotDefaultCDTor=%d "
-  //       "visibleIfFriendCompound=%d\n",visibleIfStatic,visibleIfDocumented,
+  //       "visibleIfFriendCompound=%d !annScope=%d\n",
+  //       visibleIfStatic,visibleIfDocumented,
   //       visibleIfEnabled,visibleIfPrivate,visibleIfNotDefaultCDTor,
-  //       visibleIfFriendCompound);
+  //       visibleIfFriendCompound,!m_impl->annScope);
   
   bool visible = visibleIfStatic     && visibleIfDocumented      && 
                  visibleIfEnabled    && visibleIfPrivate         &&

src/membergroup.cpp

@@ -165,17 +165,30 @@ void MemberGroup::distributeMemberGroupDocumentation()
 {
   //printf("MemberGroup::distributeMemberGroupDocumentation() %s\n",grpHeader.data());
   MemberDef *md=memberList->first();
-  if (md && !(md->documentation().isEmpty() && 
-              md->briefDescription().isEmpty() && 
-              md->inbodyDocumentation().isEmpty()
-             )
-     )
+  while (md)
   {
-    //printf("First member %s has documentation!\n",md->name().data());
-    MemberDef *omd=memberList->next();
+    //printf("checking md=%s\n",md->name().data());
+    // find the first member of the group with documentation
+    if (!md->documentation().isEmpty()       ||
+        !md->briefDescription().isEmpty()    ||
+        !md->inbodyDocumentation().isEmpty()
+       )
+    {
+      //printf("found it!\n");
+      break;
+    }
+    md=memberList->next();
+  }
+  if (md) // distribute docs of md to other members of the list
+  {
+    //printf("Member %s has documentation!\n",md->name().data());
+    MemberDef *omd=memberList->first();
     while (omd)
     {
-      if (omd->documentation().isEmpty() && omd->briefDescription().isEmpty() && omd->inbodyDocumentation().isEmpty())
+      if (md!=omd && omd->documentation().isEmpty() && 
+                     omd->briefDescription().isEmpty() && 
+                     omd->inbodyDocumentation().isEmpty()
+         )
       {
         //printf("Copying documentation to member %s\n",omd->name().data());
         omd->setBriefDescription(md->briefDescription(),md->briefFile(),md->briefLine());

src/perlmodgen.cpp

@@ -546,7 +546,7 @@ void PerlModDocVisitor::visit(DocSymbol *sy)
   case DocSymbol::Rdquo:   c = '"'; break;
   case DocSymbol::Ndash:   c = '-'; break;
   case DocSymbol::Mdash:   s = "--"; break;
-  case DocSymbol::Nbsp:    c = ''; break;
+  case DocSymbol::Nbsp:    c = ' '; break;
   case DocSymbol::Uml:     accent = "umlaut"; break;
   case DocSymbol::Acute:   accent = "acute"; break;
   case DocSymbol::Grave:   accent = "grave"; break;

src/scanner.l

@@ -644,6 +644,7 @@ TYPEDEFPREFIX (("typedef"{BN}+)?)((("volatile"|"const"){BN}+)?)
 %x	PackageName
 %x	JavaImport
 %x	CSAccessorDecl
+%x	CSGeneric
 %x	PreLineCtrl
 %x	DefinePHP
 %x	DefinePHPEnd
@@ -2725,11 +2726,17 @@ TYPEDEFPREFIX (("typedef"{BN}+)?)((("volatile"|"const"){BN}+)?)
 					  }
 					}
 <IDLAttribute>"propput"	                {
-					  current->mtype = Property;
+                                          if (Config_getBool("IDL_PROPERTY_SUPPORT"))
+					  {
+					    current->mtype = Property;
+					  }
 					  current->spec |= Entry::Settable;
 					}
 <IDLAttribute>"propget" 		{
-					  current->mtype = Property;
+                                          if (Config_getBool("IDL_PROPERTY_SUPPORT"))
+					  {
+					    current->mtype = Property;
+					  }
 					  current->spec |= Entry::Gettable;
 					}
 <IDLAttribute>.				{
@@ -2744,7 +2751,8 @@ TYPEDEFPREFIX (("typedef"{BN}+)?)((("volatile"|"const"){BN}+)?)
 					  BEGIN( IDLProp );
 					}
 <IDLProp>{BN}*"["[^\]]*"]"{BN}*		{  // attribute of a parameter
-					   idlAttr += yytext;
+					   idlAttr = yytext;
+					   idlAttr=idlAttr.stripWhiteSpace();
 					}
 <IDLProp>{ID}				{  // property type
 					   idlProp = yytext;
@@ -2781,7 +2789,7 @@ TYPEDEFPREFIX (("typedef"{BN}+)?)((("volatile"|"const"){BN}+)?)
 					  BEGIN( FindMembers );
 					}
 <IDLProp>.				{ // spaces, *, or other stuff
-  					  idlProp+=yytext;
+  					  //idlProp+=yytext;
  					}
 <Array>"]"		                { current->args += *yytext ;
 					  if (--squareCount<=0)
@@ -4273,11 +4281,31 @@ TYPEDEFPREFIX (("typedef"{BN}+)?)((("volatile"|"const"){BN}+)?)
 					  {
 					    BEGIN( ObjCProtocolList );
 					  }
+					  else if (insideCS) // C# generic class
+					  {
+					    BEGIN( CSGeneric );
+					  }
 					  else // C++ template specialization
 					  {
 					    BEGIN( ClassTemplSpec );
 					  }
 					}
+<CSGeneric>"<"				{
+					  if (current->tArgLists==0)
+					  {
+					    current->tArgLists = new QList<ArgumentList>;
+					    current->tArgLists->setAutoDelete(TRUE);
+					  }
+					  ArgumentList *al = new ArgumentList;
+					  current->spec |= Entry::Template;
+					  current->tArgLists->append(al);
+					  currentArgumentList = al;
+					  templateStr="<";
+					  fullArgString = templateStr;
+					  copyArgString = &templateStr;
+					  currentArgumentContext = CompoundName;
+					  BEGIN( ReadTempArgs );
+  					}
 <ObjCProtocolList>"<"			{
   					  insideProtocolList=TRUE;
   					  BEGIN( Bases );

src/translator_fi.h

@@ -17,7 +17,8 @@
 /*
 ==================================================================================
 Suomenkielinen käännös:
-Olli Korhonen      <olli.korhonen@ccc.fi>
+Olli Korhonen ( -> 0.49-990425)     <olli.korhonen@ccc.fi>
+Antti Laine   (0.49-990425 -> )     <antti.a.laine@tut.fi>
 ==================================================================================
 1999/10/19
 *  Alustava käännös valmis.
@@ -26,28 +27,31 @@ Olli Korhonen      <olli.korhonen@ccc.fi>
          kaikissa tapauksissa hyvä ratkaisu, ja parempikin termi voi 
          olla vakiintuneessa käytössä.
 
+2008/04/08
+* Käännetty versioon 1.5.5 asti.
+
 * Tehtävää: 
         - Termien kokoaminen listaksi ja suomennosten järkevyyden tarkastelu. (lista on jo melko kattava)
                 Author          = Tekijä
                 Class           = Luokka
-                Compound        = Kooste ?
+                Compound        = Kooste
                 Data            = Data
                 Documentation   = Dokumentaatio
-                Defines         = Määrittelyt ?
+                Defines         = Määrittelyt
                 Description     = Selite
                 Detailed        = Yksityiskohtainen
-                diagram         = kaavio
-                Enum            = Enumeraatio ?
+                Diagram         = Kaavio
+                Enum            = Enumeraatio / Luettelotyyppi
                 Exceptions      = Poikkeukset
                 File            = Tiedosto
-                Friends         = Ystävät ?
+                Friends         = Ystävät
                 Functions       = Funktiot
                 Hierarchical    = Hierarkinen
                 Index           = Indeksi
                 Inherits        = Perii
                 Member          = Jäsen
                 Module          = Moduli
-                Namespace       = Nimiavaruus ?
+                Namespace       = Nimiavaruus
                 Parameters      = Parametrit
                 Private         = Yksityinen
                 Protected       = Suojattu
@@ -56,12 +60,12 @@ Olli Korhonen      <olli.korhonen@ccc.fi>
                 Reference Manual= Käsikirja
                 Reimplemented   = Uudelleen toteutettu
                 Related         = Liittyvä
-                Signals         = Signaali
-                Slots           = ? 
+                Signals         = Signaalit
+                Slots           = Vastineet
                 Static          = Staattinen
-                Struct          = ?
+                Struct          = Tietue
                 Typedef         = Tyyppimäärittely
-                Union           = ?
+                Union           = Yhdiste
                 Variables       = Muuttujat
         - Taivutusmuotojen virheettömyyden tarkastelu prepositioiden korvauskohdissa.
         - Sanasta sanaan käännöskohtien mielekkyyden tarkastelu valmiista dokumentista.
@@ -74,443 +78,654 @@ positiiviset kommentit otetaan ilolla vastaan.
 #ifndef TRANSLATOR_FI_H
 #define TRANSLATOR_FI_H
 
-class TranslatorFinnish : public TranslatorEnglish
+class TranslatorFinnish : public Translator
 {
   public:
     /*! This method is used to generate a warning message to signal
      *  the user that the translation of his/her language of choice
      *  needs updating.
      */
-    virtual QCString updateNeededMessage()
+    /*virtual QCString updateNeededMessage()
     {
       return "Warning: The Finnish translator is really obsolete.\n"
              "It was not updated since version 1.0.0.  As a result,\n"
              "some sentences may appear in English.\n\n";
+    }*/
+    
+    // --- 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 "finnish"; }
+
+    /*! 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 "\\usepackage[finnish]{babel}\n";
     }
 
-    QCString idLanguage()
-    { return "finnish"; }
+    /*! return the language charset. This will be used for the HTML output */
+    virtual QCString idLanguageCharset()
+    {
+      return "iso-8859-1";
+    }
+
+    // --- Language translation methods -------------------
 
-    QCString trRelatedFunctions()
-      // used in the compound documentation before a list of related functions.
-    { return "Liittyvät Funktiot"; } // "Related Functions";
+    /*! used in the compound documentation before a list of related functions. */
+    virtual QCString trRelatedFunctions()
+    { return "Liittyvät funktiot"; } // "Related Functions";
 
-    QCString trRelatedSubscript()
-      // subscript for the related functions.
+    /*! subscript for the related functions. */
+    virtual QCString trRelatedSubscript()
     { return "(Huomaa, että nämä eivät ole jäsenfunktioita.)"; } // "(Note that these are not member functions.)"
 
-    QCString trDetailedDescription()
-      // header that is put before the detailed description of files, classes and namespaces.
-    { return "Yksityiskohtainen Selite"; } // "Detailed Description"
+    /*! header that is put before the detailed description of files, classes and namespaces. */
+    virtual QCString trDetailedDescription()
+    { return "Yksityiskohtainen selite"; } // "Detailed Description"
 
-    QCString trMemberTypedefDocumentation()
+    /*! header that is put before the list of typedefs. */
+    virtual QCString trMemberTypedefDocumentation()
       // header that is put before the list of typedefs.
-    { return "Jäsen Tyyppimäärittelyiden Dokumentaatio"; } // "Member Typedef Documentation"
+    { return "Jäsentyyppimäärittelyiden dokumentaatio"; } // "Member Typedef Documentation"
 
-    QCString trMemberEnumerationDocumentation()
-      // header that is put before the list of enumerations.
-    { return "Jäsen Enumeraatioiden Dokumentaatio"; } // "Member Enumeration Documentation"
+    /*! header that is put before the list of enumerations. */
+    virtual QCString trMemberEnumerationDocumentation()
+    { return "Jäsenenumeraatioiden dokumentaatio"; } // "Member Enumeration Documentation"
 
-    QCString trEnumerationValueDocumentation()
-    { return "Enumeraatioarvojen Dokumentaatio"; } 
+    /*! header that is put before the list of member functions. */
+    virtual QCString trMemberFunctionDocumentation()
+    { return "Jäsenfunktioiden dokumentaatio"; } // "Member Function Documentation"
 
-    QCString trMemberFunctionDocumentation()
-      // header that is put before the list of member functions.
-    { return "Jäsen Funktioiden Dokumentaatio"; } // "Member Function Documentation"
-    QCString trMemberDataDocumentation()
-      // header that is put before the list of member attributes.
-    { return "Jäsen Datan Dokumentaatio"; } // "Member Data Documentation"
+    /*! header that is put before the list of member attributes. */
+    virtual QCString trMemberDataDocumentation()
+    { 
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        return "Kenttien dokumentaatio"; // "Field Documentation"; 
+      }
+      else
+      {
+        return "Jäsendatan dokumentaatio"; // "Member Data Documentation"
+      }
+    }
 
-    QCString trMore()
-      // this is the text of a link put after brief descriptions.
+    /*! this is the text of a link put after brief descriptions. */
+    virtual QCString trMore()
     { return "Lisää..."; } // "More..."
 
-    QCString trListOfAllMembers()
-      // put in the class documentation
+     /*! put in the class documentation */
+    virtual QCString trListOfAllMembers()
     { return "Lista kaikista jäsenistä."; } // "List of all members."
-    QCString trMemberList()
+    virtual QCString trMemberList()
 
-      // used as the title of the "list of all members" page of a class
-    { return "Jäsen Lista"; } // "Member List"
+    /*! used as the title of the "list of all members" page of a class */
+    { return "Jäsenlista"; } // "Member List"
 
-    QCString trThisIsTheListOfAllMembers()
-      // 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 "Tämä on lista kaikista jäsenistä"; } // "This is the complete list of members for "
-    QCString trIncludingInheritedMembers()
-      // this is the remainder of the sentence after the class name
-    { return ", sisältää kaikki perityt jäsenet."; } // ", including all inherited members."
-
-    QCString trGeneratedAutomatically(const char *s)
-      // this is put at the author sections at the bottom of man pages.
-      // parameter s is name of the project name.
-    { QCString result="Automaattisesti generoitu Doxygen:lla "; // "Generated automatically by Doxygen"
+
+    /*! this is the remainder of the sentence after the class name */
+    virtual QCString trIncludingInheritedMembers()
+    { return ", sisältäen kaikki perityt jäsenet."; } // ", including all inherited members."
+
+    /*! 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=(QCString)"Automaattisesti generoitu Doxygenilla "
+                      "lähdekoodista projektille "+s; // "Generated automatically by Doxygen" ... "for" ... "from the sourcecode"
       //if (s) result+=(QCString)" voor "+s;
       // tässä on ongelma, kuinka taivuttaa parametria, esim. "Jcad"+"in"; "IFC2VRML konversio"+"n"
       // mutta ratkaistaan ongelma kätevästi kaksoispisteellä -> "Jcad:n" / "IFC2VRML konversio:n"
       // lopputulos on vähemmän kökkö ja täysin luettava, mutta ei kuitenkaan täydellinen.
-      if (s) result+=(QCString)s+":n "; 
-      result+="lähdekoodista."; // " from the source code."
+      //
+      // kierretään ongelma taivuttamalla sanaa projekti :)
       return result;
     }
 
-    QCString trEnumName()
-      // put after an enum name in the list of all members
+    /*! put after an enum name in the list of all members */
+    virtual QCString trEnumName()
     { return "enumeraation nimi"; } // "enum name"
 
-    QCString trEnumValue()
-      // put after an enum value in the list of all members
+    /*! put after an enum value in the list of all members */
+    virtual QCString trEnumValue()
     { return "enumeraation arvo"; } // "enum value"
 
-    QCString trDefinedIn()
-      // put after an undocumented member in the list of all members
+    /*! put after an undocumented member in the list of all members */
+    virtual QCString trDefinedIn()
     { return "määritelty"; } // "defined in"
 
     // quick reference sections
-    QCString trModules()
-      // This is put above each page as a link to the list of all groups of 
-      // compounds or files (see the \group command).
-    { return "Modulit"; } // "Modules"
-    QCString trClassHierarchy()
-      // This is put above each page as a link to the class hierarchy 
-    { return "Luokka Hierarkia"; } // "Class Hierarchy"
-    QCString trCompoundList()
-      // This is put above each page as a link to the list of annotated classes
-    { return "Kooste Lista"; } // "Compound List"
-    QCString trFileList()
-      // This is put above each page as a link to the list of documented files
-    { return "Tiedosto Lista"; } // "File List"
-    QCString trHeaderFiles()
-      // This is put above each page as a link to the list of all verbatim headers
-    { return "Header Tiedostot"; } // "Header Files"
-    QCString trCompoundMembers()
-      // This is put above each page as a link to all members of compounds.
-    { return "Koosteen Jäsenet"; } // "Compound Members"
-    QCString trFileMembers()
-      // This is put above each page as a link to all members of files.
-    { return "Tiedosto Jäsenet"; } // "File Members"
-    QCString trRelatedPages()
-      // This is put above each page as a link to all related pages.
-    { return "Liittyvät Sivut"; } // "Related Pages"
-    QCString trExamples()
-      // This is put above each page as a link to all examples.
+
+    /*! 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 "Moduulit"; } // "Modules"
+    
+    /*! This is put above each page as a link to the class hierarchy */
+    virtual QCString trClassHierarchy()
+    { return "Luokkahierarkia"; } // "Class Hierarchy"
+   
+    /*! 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 "Tietueet"; // "Data Structures"
+      }
+      else
+      {
+        return "Luokkalista"; // "Class List"
+      }
+    }
+
+    /*! This is put above each page as a link to the list of documented files */
+    virtual QCString trFileList()
+    { return "Tiedostolista"; } // "File List"
+   
+    /*! 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 "Tietueen kentät"; // "Data Fields" 
+      }
+      else
+      {
+        return "Luokan jäsenet"; // "Class Members"
+      }
+    }
+    
+    /*! 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 "Globaalit"; // "Globals" 
+      }
+      else
+      {
+        return "Tiedoston jäsenet"; // "File Members"
+      }
+    }
+
+    /*! This is put above each page as a link to all related pages. */
+    virtual QCString trRelatedPages()
+    { return "Liittyvät sivut"; } // "Related Pages"
+   
+    /*! This is put above each page as a link to all examples. */ 
+    virtual QCString trExamples()
     { return "Esimerkit"; } // "Examples"
-    QCString trSearch()
-      // This is put above each page as a link to the search engine.
+   
+    /*! This is put above each page as a link to the search engine. */ 
+    virtual QCString trSearch()
     { return "Etsi"; } // "Search"
-    QCString trClassHierarchyDescription()
-      // This is an introduction to the class hierarchy.
+   
+    /*! This is an introduction to the class hierarchy. */ 
+    virtual QCString trClassHierarchyDescription()
     { return "Tämä periytymislista on päätasoltaan aakkostettu " // "This inheritance list is sorted roughly, "
              "mutta alijäsenet on aakkostettu itsenäisesti:"; // "but not completely, alphabetically:";
     }
-    QCString trFileListDescription(bool extractAll)
-      // This is an introduction to the list with all files.
+
+    /*! This is an introduction to the list with all files. */
+    virtual QCString trFileListDescription(bool extractAll)
     {
-      QCString result="Täällä on lista kaikista ";
+      QCString result="Tässä on lista kaikista ";
       if (!extractAll) result+="dokumentoiduista "; // "documented "
       result+="tiedostoista lyhyen selitteen kera:"; // "files with brief descriptions:"
       return result;
     }
-    QCString trCompoundListDescription()
-      // This is an introduction to the annotated compound list
-    { return "Täällä on luokat, struktuurit ja " // "Here are the classes, structs and "
-             "unionit lyhyen selitteen kera:"; // "unions with brief descriptions:"
+    
+    /*! This is an introduction to the annotated compound list. */
+    virtual QCString trCompoundListDescription()
+    {
+    
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        return "Tällä ovat tietueet lyhyen selitteen kera:"; // "Here are the data structures with brief descriptions:"
+      }
+      else
+      {
+        return "Tässä ovat luokat, tietueet ja " // "Here are the classes, structs and "
+             "yhdisteet lyhyen selitteen kera:"; // "unions with brief descriptions:"
+      }
     }
-    QCString trCompoundMembersDescription(bool extractAll)
-      // This is an introduction to the page with all class members
+    
+    /*! This is an introduction to the page with all class members. */
+    virtual QCString trCompoundMembersDescription(bool extractAll)
     {
-      QCString result="Täällä on lista kaikista "; // "Here is a list of all "
-      if (!extractAll) result+="dokumentoiduista "; // "documented "
-      result+="luokan jäsenistä linkitettynä "; // "class members with links to "
+      QCString result="Tässä on lista kaikista "; // "Here is a list of all "
+      if (!extractAll)
+      {
+        result+="dokumentoiduista "; // "documented "
+      }
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        result+="tietuiden ja yhdisteiden kentistä"; // "struct and union fields"
+      }
+      else
+      {
+        result+="luokkien jäsenistä"; // "class members"
+      }
+      result+=" linkitettyinä "; // " with links to "
       if (!extractAll) 
-        result+="jokaisen jäsenen luokkadokumentaatioon:"; // "the class documentation for each member:"
+      {
+        if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+        {
+          result+="jokaisen kentän tietueen/yhdisteen dokumentaatioon:"; // "the struct/union documentation for each field:"
+        }
+        else
+        {
+          result+="jokaisen jäsenen luokkadokumentaatioon:"; // "the class documentation for each member:"
+        }
+      }
       else 
-        result+="luokkaan johon ne kuuluvat:"; // "the classes they belong to:"
+      {
+        if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+        {
+          result+= "tietueisiin/yhdisteisiin, joihin ne kuuluvat:"; // "the structures/unions they belong to:"
+        }
+        else
+        {
+          result+="luokkiin, joihin ne kuuluvat"; //"the classes they belong to:"
+        }
+      }
       return result;
     }
-    QCString trFileMembersDescription(bool extractAll)
-      // This is an introduction to the page with all file members
+
+    /*! This is an introduction to the page with all file members. */
+    virtual QCString trFileMembersDescription(bool extractAll)
     {
-      QCString result="Täällä on lista kaikista "; // "Here is a list of all "
-      if (!extractAll) result+="dokumentoiduista "; // "documented ";
-      result+="tiedosto jäsenistä linkitettynä "; // "file members with links to "
+      QCString result="Tässä on lista kaikista "; // "Here is a list of all "
+      if (!extractAll) result+="dokumentoiduista "; // "documented "
+      
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        result+="funktioista, muuttujista, määrittelyistä, luetteloista ja tyyppimäärittelyistä"; // "functions, variables, defines, enums, and typedefs"
+      }
+      else
+      {
+        result+="tiedoston jäsenistä"; // "file members"
+      }
+      result+=" linkitettyinä "; // " with links to "
       if (extractAll) 
-        result+="kunkin jäsenen tiedosto dokumentaatioon:"; // "the file documentation for each member:"
+        result+="tiedostoon, johon ne kuuluvat:"; // "the files they belong to:"
       else 
-        result+="tiedostoon johon ne kuuluvat:"; // "the files they belong to:"
+        result+="dokumentaatioon:"; // "the documentation:"
       return result;
     }
-    QCString trHeaderFilesDescription()
-      // This is an introduction to the page with the list of all header files
-    { return "Täällä on kaikki header tiedostot jotka muodostavat API:n:"; } // "Here are the header files that make up the API:"
-    QCString trExamplesDescription()
-      // This is an introduction to the page with the list of all examples
-    { return "Täällä on lista kaikista esimerkeistä:"; } //  "Here is a list of all examples:"
-    QCString trRelatedPagesDescription()
-      // This is an introduction to the page with the list of related pages
-    { return "Täällä on lista kaikista liittyvistä dokumentaatiosivuista:"; } // "Here is a list of all related documentation pages:"
-    QCString trModulesDescription()
-      // This is an introduction to the page with the list of class/file groups
-    { return "Täällä on lista kaikista moduleista:"; } // "Here is a list of all modules:"
-    QCString trNoDescriptionAvailable()
-      // This sentences is used in the annotated class/file lists if no brief
-      // description is given.
-    { return "Selitettä ei ole saatavilla"; } // "No description available"
-
+    
+    /*! This is an introduction to the page with the list of all examples */
+    virtual QCString trExamplesDescription()
+    { return "Tässä on lista kaikista esimerkeistä:"; } //  "Here is a list of all examples:"
+   
+    /*! This is an introduction to the page with the list of related pages */ 
+    virtual QCString trRelatedPagesDescription()
+    { return "Tässä on lista kaikista liittyvistä dokumentaatiosivuista:"; } // "Here is a list of all related documentation pages:"
+   
+    /*! This is an introduction to the page with the list of class/file groups */ 
+    virtual QCString trModulesDescription()
+    { return "Tässä on lista kaikista moduleista:"; } // "Here is a list of all modules:"
+    
     // index titles (the project name is prepended for these) 
-    QCString trDocumentation()
-      // This is used in HTML as the title of index.html. 
+    
+    /*! This is used in HTML as the title of index.html. */
+    virtual QCString trDocumentation()
     { return "Dokumentaatio"; } // "Documentation"
-    QCString trModuleIndex()
-      // This is used in LaTeX as the title of the chapter with the 
-      // index of all groups.
-    { return "Moduli Indeksi"; } // "Module Index"
-    QCString trHierarchicalIndex()
-      // This is used in LaTeX as the title of the chapter with the 
-      // class hierarchy.
-    { return "Hierarkinen Indeksi"; } // "Hierarchical Index"
-    QCString trCompoundIndex()
-      // This is used in LaTeX as the title of the chapter with the 
-      // annotated compound index
-    { return "Koosteiden Indeksi"; } // "Compound Index"
-    QCString trFileIndex() 
-      // This is used in LaTeX as the title of the chapter with the
-      // list of all files.
-    { return "Tiedosto Indeksi"; } // "File Index"
-    QCString trModuleDocumentation()
-      // This is used in LaTeX as the title of the chapter containing
-      // the documentation of all groups.
-    { return "Moduli Dokumentaatio"; } // "Module Documentation"
-    QCString trClassDocumentation()
-      // This is used in LaTeX as the title of the chapter containing
-      // the documentation of all classes, structs and unions.
-    { return "Luokka Dokumentaatio"; } // "Class Documentation"
-    QCString trFileDocumentation()
-      // This is used in LaTeX as the title of the chapter containing
-      // the documentation of all files.
-    { return "Tiedosto Dokumentaatio"; } // "File Documentation"
-    QCString trExampleDocumentation()
-      // This is used in LaTeX as the title of the chapter containing
-      // the documentation of all examples.
-    { return "Esimerkkien Dokumentaatio"; } // "Example Documentation"
-    QCString trPageDocumentation()
-      // This is used in LaTeX as the title of the chapter containing
-      // the documentation of all related pages.
-    { return "Sivujen Dokumentaatio"; } // "Page Documentation"
-    QCString trReferenceManual()
-      // This is used in LaTeX as the title of the document
+    
+    /*! This is used in LaTeX as the title of the chapter with the 
+     * index of all groups.
+     */
+    virtual QCString trModuleIndex()
+    { return "Moduuliluettelo"; } // "Module Index"
+    
+    /*! This is used in LaTeX as the title of the chapter with the 
+     * class hierarchy.
+     */
+    virtual QCString trHierarchicalIndex()
+    { return "Hierarkinen luettelo"; } // "Hierarchical Index"
+    
+    /*! 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 "Tietueluettelo"; // "Data Structure Index"
+      }
+      else
+      {
+        return "Luokkaluettelo"; // "Class Index"
+      }
+    }
+    
+    /*! This is used in LaTeX as the title of the chapter with the
+     * list of all files.
+     */
+    virtual QCString trFileIndex() 
+    { return "Tiedostoluettelo"; } // "File Index"
+    
+    /*! This is used in LaTeX as the title of the chapter containing
+     *  the documentation of all groups.
+     */
+    virtual QCString trModuleDocumentation()
+    { return "Moduulien dokumentaatio"; } // "Module Documentation"
+    
+    /*! 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 "Tietueiden dokumentaatio"; // "Data Structure Documentation"
+      }
+      else
+      {
+        return "Luokkien dokumentaatio"; // "Class Documentation"
+      }
+    }
+
+    /*! This is used in LaTeX as the title of the chapter containing
+     *  the documentation of all files.
+     */
+    virtual QCString trFileDocumentation()
+    { return "Tiedostojen dokumentaatio"; } // "File Documentation"
+    
+    /*! This is used in LaTeX as the title of the chapter containing
+     *  the documentation of all examples.
+     */
+    virtual QCString trExampleDocumentation()
+    { return "Esimerkkien dokumentaatio"; } // "Example Documentation"
+    
+    /*! This is used in LaTeX as the title of the chapter containing
+     *  the documentation of all related pages.
+     */
+    virtual QCString trPageDocumentation()
+    { return "Sivujen dokumentaatio"; } // "Page Documentation"
+    
+    /*! This is used in LaTeX as the title of the document */
+    virtual QCString trReferenceManual()
     { return "Käsikirja"; } // "Reference Manual"
 
-    QCString trDefines()
-      // This is used in the documentation of a file as a header before the 
-      // list of defines
+    /*! This is used in the documentation of a file as a header before the 
+     *  list of defines
+     */
+    virtual QCString trDefines()
     { return "Määrittelyt"; } // "Defines"
-    QCString trFuncProtos()
-      // This is used in the documentation of a file as a header before the 
-      // list of function prototypes
-    { return "Funktioiden Prototyypit"; } // "Function Prototypes"
-    QCString trTypedefs()
-      // This is used in the documentation of a file as a header before the 
-      // list of typedefs
+    
+    /*! This is used in the documentation of a file as a header before the 
+     *  list of function prototypes
+     */
+    virtual QCString trFuncProtos()
+    { return "Funktioiden prototyypit"; } // "Function Prototypes"
+    
+    /*! This is used in the documentation of a file as a header before the 
+     *  list of typedefs
+     */
+    virtual QCString trTypedefs()
     { return "Tyyppimäärittelyt"; } // "Typedefs"
-    QCString trEnumerations()
-      // This is used in the documentation of a file as a header before the 
-      // list of enumerations
-    { return "Enumeraatiot"; } // "Enumerations"
-    QCString trFunctions()
-      // This is used in the documentation of a file as a header before the 
-      // list of (global) functions
+    
+    /*! This is used in the documentation of a file as a header before the 
+     *  list of enumerations
+     */
+    virtual QCString trEnumerations()
+    { return "Luettelotyypit"; } // "Enumerations"
+    
+    /*! This is used in the documentation of a file as a header before the 
+     *  list of (global) functions
+     */
+    virtual QCString trFunctions()
     { return "Funktiot"; } // "Functions"
-    QCString trVariables()
-      // This is used in the documentation of a file as a header before the 
-      // list of (global) variables
+    
+    /*! This is used in the documentation of a file as a header before the 
+     *  list of (global) variables
+     */
+    virtual QCString trVariables()
     { return "Muuttujat"; } // "Variables"
-    QCString trEnumerationValues()
-      // This is used in the documentation of a file as a header before the 
-      // list of (global) variables
-    { return "Enumeraation arvot"; } // "Enumeration values"
-
-    QCString trDefineDocumentation()
-      // This is used in the documentation of a file before the list of
-      // documentation blocks for defines
+    
+    /*! This is used in the documentation of a file as a header before the 
+     *  list of (global) variables
+     */
+    virtual QCString trEnumerationValues()
+    { return "Luettelotyyppien arvot"; } // "Enumerator"
+
+    /*! This is used in the documentation of a file before the list of
+     *  documentation blocks for defines
+     */
+    virtual QCString trDefineDocumentation()
     { return "Määritysten dokumentointi"; } // "Define Documentation"
-    QCString trFunctionPrototypeDocumentation()
-      // This is used in the documentation of a file/namespace before the list 
-      // of documentation blocks for function prototypes
-    { return "Funktio Prototyyppien Dokumentaatio"; } // "Function Prototype Documentation"
-    QCString trTypedefDocumentation()
-      // This is used in the documentation of a file/namespace before the list 
-      // of documentation blocks for typedefs
-    { return "Tyyppimääritysten Dokumentaatio"; } // "Typedef Documentation"
-    QCString trEnumerationTypeDocumentation()
-      // This is used in the documentation of a file/namespace before the list 
-      // of documentation blocks for enumeration types
-    { return "Enumeraatio Tyyppien Dokumentaatio"; } // "Enumeration Type Documentation"
-    QCString trFunctionDocumentation()
-      // This is used in the documentation of a file/namespace before the list 
-      // of documentation blocks for functions
-    { return "Funktioiden Dokumentaatio"; } // "Function Documentation"
-    QCString trVariableDocumentation()
-      // This is used in the documentation of a file/namespace before the list 
-      // of documentation blocks for variables
-    { return "Muuttujien Dokumentaatio"; } // "Variable Documentation"
-    QCString trCompounds()
-      // This is used in the documentation of a file/namespace/group before 
-      // the list of links to documented compounds
-    { return "Koosteet"; } // "Compounds"
-    QCString trFiles()
-      // This is used in the documentation of a group before the list of 
-      // links to documented files
-    { return "Tiedostot"; } // "Files"
-
-    QCString trGeneratedAt(const char *date,const char *projName)
+    
+    /*! This is used in the documentation of a file/namespace before the list 
+     *  of documentation blocks for function prototypes
+     */
+    virtual QCString trFunctionPrototypeDocumentation()
+    { return "Funktioprototyyppien dokumentaatio"; } // "Function Prototype Documentation"
+    
+    /*! This is used in the documentation of a file/namespace before the list 
+     *  of documentation blocks for typedefs
+     */
+    virtual QCString trTypedefDocumentation()
+    { return "Tyyppimääritysten dokumentaatio"; } // "Typedef Documentation"
+    
+    /*! This is used in the documentation of a file/namespace before the list 
+     *  of documentation blocks for enumeration types
+     */
+    virtual QCString trEnumerationTypeDocumentation()
+    { return "Luettelotyyppien dokumentaatio"; } // "Enumeration Type Documentation"
+    
+    /*! This is used in the documentation of a file/namespace before the list 
+     *  of documentation blocks for functions
+     */
+    virtual QCString trFunctionDocumentation()
+    { return "Funktioiden dokumentaatio"; } // "Function Documentation"
+    
+    /*! This is used in the documentation of a file/namespace before the list 
+     *  of documentation blocks for variables
+     */
+    virtual QCString trVariableDocumentation()
+    { return "Muuttujien dokumentaatio"; } // "Variable Documentation"
+    
+    /*! 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 "Tietueet"; // "Data Structures"
+      }
+      else
+      {
+        return "Luokat"; // "Classes"
+      }
+    }
+    
+    /*! 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)
     { 
         // funktio on hiukan vaikea kääntää prepositioihin sidotun rakenteen vuoksi.
-      QCString result=(QCString)"Generoitu "+date; // "Generated at "
-      if (projName) result+=(QCString)" projektille "+projName; // " for "
-      result+=(QCString)" tekijä: "; // " by"
+        // Muutetaan siis lauserakennetta suomalaisemmaksi
+        // Generated on $date for $project by:
+        // -> Generated for $project on $date by:
+      QCString result=(QCString)"Generoinut ";
+      if (projName) result+=(QCString)"projektille "+projName+" ";
+      result+=(QCString)date+" ";
       return result;
     }
-    QCString trWrittenBy()
+    /*! This is part of the sentence used in the standard footer of each page.
+     */
+    virtual QCString trWrittenBy()
     {
       return "kirjoittanut"; // "written by"
     }
-    QCString trClassDiagram(const char *clName)
-      // this text is put before a class diagram
+
+    /*! this text is put before a class diagram */
+    virtual QCString trClassDiagram(const char *clName)
     {
-      return (QCString)clName+":n Luokkakaavio"; // "Class diagram for "
+      return "Luokan "+(QCString)clName+" luokkakaavio"; // "Inheritance diagram for "
     }
 
-    QCString trForInternalUseOnly()
-      // this text is generated when the \internal command is used.
+    /*! this text is generated when the \\internal command is used. */
+    virtual QCString trForInternalUseOnly()
     { return "Vain sisäiseen käyttöön."; } // "For internal use only."
-    QCString trReimplementedForInternalReasons()
-      // this text is generated when the \reimp command is used.
-    { return "Uudelleen toteutettu sisäisistä syistä; API ei ole muuttunut."; } // "Reimplemented for internal reasons; the API is not affected."
-    QCString trWarning()
-      // this text is generated when the \warning command is used.
+    
+    /*! this text is generated when the \\warning command is used. */
+    virtual QCString trWarning()
     { return "Varoitus"; } // "Warning"
-      // this text is generated when the \bug command is used.
-    QCString trBugsAndLimitations()
-    { return "Virheet ja rajoitukset"; } // "Bugs and limitations"
-    QCString trVersion()
-      // this text is generated when the \version command is used.
+    
+    /*! this text is generated when the \\version command is used. */
+    virtual QCString trVersion()
     { return "Versio"; } // "Version"
-    QCString trDate()
-      // this text is generated when the \date command is used.
+    
+    /*! this text is generated when the \\date command is used. */
+    virtual QCString trDate()
     { return "Päiväys"; } // "Date"
-    QCString trAuthors()
-      // this text is generated when the \author command is used.
-    { return "Tekijä(t)"; } // "Author(s)"
-    QCString trReturns()
-      // this text is generated when the \return command is used.
+    
+    /*! this text is generated when the \\return command is used. */
+    virtual QCString trReturns()
     { return "Palauttaa"; } // "Returns"
-    QCString trSeeAlso()
-      // this text is generated when the \sa command is used.
+    
+    /*! this text is generated when the \\sa command is used. */
+    virtual QCString trSeeAlso()
     { return "Katso myös"; } // "See also"
-    QCString trParameters()
-      // this text is generated when the \param command is used.
+    
+    /*! this text is generated when the \\param command is used. */
+    virtual QCString trParameters()
     { return "Parametrit"; } // "Parameters"
-    QCString trExceptions()
-      // this text is generated when the \exception command is used.
+    
+    /*! this text is generated when the \\exception command is used. */
+    virtual QCString trExceptions()
     { return "Poikkeukset"; } // "Exceptions"
-    QCString trGeneratedBy()
-      // this text is used in the title page of a LaTeX document.
+    
+    /*! this text is used in the title page of a LaTeX document. */
+    virtual QCString trGeneratedBy()
     { return "Generoinut"; } // "Generated by"
     
 //////////////////////////////////////////////////////////////////////////
 // new since 0.49-990307 
 //////////////////////////////////////////////////////////////////////////
     
-    QCString trNamespaceList()
-      // 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 "Nimiavaruus Lista"; } // "Namespace List"
-    QCString trNamespaceListDescription(bool extractAll)
-      // used as an introduction to the namespace list
+    
+    /*! used as an introduction to the namespace list */
+    virtual QCString trNamespaceListDescription(bool extractAll)
     {
-      QCString result="Täällä on lista kaikista "; // "Here is a list of all "
-      if (!extractAll) result+="dokumentoiduista "; // "Here is a list of all "
+      QCString result="Tässä on lista kaikista "; // "Here is a list of all "
+      if (!extractAll) result+="dokumentoiduista "; // "documented "
       result+="nimiavaruuksista lyhyen selitteen kera:"; // "namespaces with brief descriptions:"
       return result;
     }
-    QCString trFriends()
-      // used in the class documentation as a header before the list of all
-      // friends of a class
+    
+    /*! used in the class documentation as a header before the list of all
+     *  friends of a class
+     */
+    virtual QCString trFriends()
     { return "Ystävät"; } // "Friends"
 
 //////////////////////////////////////////////////////////////////////////
 // new since 0.49-990405
 //////////////////////////////////////////////////////////////////////////
     
-    QCString trRelatedFunctionDocumentation()
-      // used in the class documentation as a header before the list of all
-      // related classes
-    { return "Ystävät ja niihin Liittyvien Funktioiden Dokumentaatio"; } // "Friends And Related Function Documentation"
+    /*! used in the class documentation as a header before the list of all
+     * related classes 
+     */
+    virtual QCString trRelatedFunctionDocumentation()
+    { return "Ystävät ja niihin liittyvien funktioiden dokumentaatio"; } // "Friends And Related Function Documentation"
     
 //////////////////////////////////////////////////////////////////////////
 // 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*/)
-      // used as the title of the HTML page of a class/struct/union
+                                    bool isTemplate)
     {
-      QCString result=(QCString)clName+" ";
+      QCString result=(QCString)clName;
       switch(compType)
       {
-        case ClassDef::Class:  result+=" Luokka"; break; // "Class"
-        case ClassDef::Struct: result+=" Struct"; break; // "Struct"
-        case ClassDef::Union:  result+=" Union"; break; // "Union"
-        case ClassDef::Interface: result+=" Interface"; break; // "Interface"
-        case ClassDef::Protocol: result+=" Protocol"; break; // translate me!
-        case ClassDef::Category: result+=" Category"; break; // translate me!
-        case ClassDef::Exception: result+=" Exception"; break; // "Interface"
+        case ClassDef::Class:      result+=" Luokka"; break; // " Class"
+        case ClassDef::Struct:     result+=" Tietue"; break; // " Struct"
+        case ClassDef::Union:      result+=" Yhdiste"; break; // " Union"
+        case ClassDef::Interface:  result+=" Rajapinta"; break; // " Interface"
+        case ClassDef::Protocol:   result+=" Protokolla"; break; // " Protocol"
+        case ClassDef::Category:   result+=" Kategoria"; break; // " Category"
+        case ClassDef::Exception:  result+=" Poikkeus"; break; // " Exception"
       }
-      result+=" Referenssi"; // " Reference"
+      if (isTemplate) result+="malli"; // " Template"
+      result+="referenssi"; // " Reference"
       return result;
     }
+
+    /*! used as the title of the HTML page of a file */
     virtual QCString trFileReference(const char *fileName)
-      // used as the title of the HTML page of a file
     {
       QCString result=fileName;
-      result+=" Tiedosto Referenssi"; // " File Reference"
+      result+=" Tiedostoreferenssi"; // " File Reference"
       return result;
     }
+    
+    /*! used as the title of the HTML page of a namespace */
     virtual QCString trNamespaceReference(const char *namespaceName)
-      // used as the title of the HTML page of a namespace
     {
       QCString result=namespaceName;
-      result+=" Nimiavaruus Referenssi"; // " Namespace Reference"
+      result+=" Nimiavaruusreferenssi"; // " Namespace Reference"
       return result;
     }
     
-    // these are for the member sections of a class, struct or union 
     virtual QCString trPublicMembers()
-    { return "Julkiset Jäsenet"; } // "Public Members"
+    { return "Julkiset jäsenfunktiot"; } // "Public Member Functions"
     virtual QCString trPublicSlots()
-    { return "Julkiset Slotit"; } // "Public Slots"
+    { return "Julkiset vastineet"; } // "Public Slots"
     virtual QCString trSignals()
     { return "Signaalit"; } // "Signals"
     virtual QCString trStaticPublicMembers()
-    { return "Staattiset Julkiset Jäsenet"; } // "Static Public Members"
+    { return "Staattiset julkiset jäsenfunktiot"; } // "Static Public Member Functions"
     virtual QCString trProtectedMembers()
-    { return "Suojatut Jäsenet"; } // "Protected Members"
+    { return "Suojatut jäsenfunktiot"; } // "Protected Member Functions"
     virtual QCString trProtectedSlots()
-    { return "Suojatut Slotit"; } // "Protected Slots"
+    { return "Suojatut vastineet"; } // "Protected Slots"
     virtual QCString trStaticProtectedMembers()
-    { return "Staattiset Suojatut Jäsenet"; } // "Static Protected Members"
+    { return "Staattiset suojatut jäsenfunktiot"; } // "Static Protected Member Functions"
     virtual QCString trPrivateMembers()
-    { return "Yksityiset Jäsenet"; } // "Private Members"
+    { return "Yksityiset jäsenfunktiot"; } // "Private Member Functions"
     virtual QCString trPrivateSlots()
-    { return "Yksityiset Slotit"; } // "Private Slots"
+    { return "Yksityiset vastineet"; } // "Private Slots"
     virtual QCString trStaticPrivateMembers()
-    { return "Staattiset Yksityiset Jäsenet"; } // "Static Private Members"
-    // end of member sections 
-    
+    { return "Staattiset yksityiset jäsenfunktiot"; } // "Static Private Member Functions"
+
+    /*! 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)
     {
-      // this function is used to produce a comma-separated list of items.
-      // use generateMarker(i) to indicate where item i should be put.
       QCString result;
       int i;
       // the inherits list contain `numEntries' classes
@@ -531,54 +746,1152 @@ class TranslatorFinnish : public TranslatorEnglish
       return result; 
     }
     
+    /*! used in class documentation to produce a list of base classes,
+     *  if class diagrams are disabled.
+     */
     virtual QCString trInheritsList(int numEntries)
-      // used in class documentation to produce a list of base classes,
-      // if class diagrams are disabled.
     {
       return "Perijät "+trWriteList(numEntries)+"."; // "Inherits "
     }
+    
+    /*! used in class documentation to produce a list of super classes,
+     *  if class diagrams are disabled.
+     */
     virtual QCString trInheritedByList(int numEntries)
-      // used in class documentation to produce a list of super classes,
-      // if class diagrams are disabled.
     {
       return "Periytyy "+trWriteList(numEntries)+"."; // "Inherited by "
     }
+    
+    /*! used in member documentation blocks to produce a list of 
+     *  members that are hidden by this one.
+     */
     virtual QCString trReimplementedFromList(int numEntries)
-      // used in member documentation blocks to produce a list of 
-      // members that are hidden by this one.
     {
-      return "Uudelleen toteutettu "+trWriteList(numEntries)+"."; // "Reimplemented from "
+      return "Uudelleen toteutettaa "+trWriteList(numEntries)+"."; // "Reimplemented from "
     }
+    
+    /*! used in member documentation blocks to produce a list of
+     *  all member that overwrite the implementation of this member.
+     */
     virtual QCString trReimplementedInList(int numEntries)
     {
-      // used in member documentation blocks to produce a list of
-      // all member that overwrite the implementation of this member.
       return "Uudelleen toteutettu "+trWriteList(numEntries)+"."; // "Reimplemented in "
     }
 
+    /*! This is put above each page as a link to all members of namespaces. */
     virtual QCString trNamespaceMembers()
-      // This is put above each page as a link to all members of namespaces.
     { return "Nimiavaruuden jäsenet"; } // "Namespace Members"
+    
+    /*! This is an introduction to the page with all namespace members */
     virtual QCString trNamespaceMemberDescription(bool extractAll)
-      // This is an introduction to the page with all namespace members
     { 
-      QCString result="Täällä on lista kaikista "; // "Here is a list of all "
+      QCString result="Tässä on lista kaikista "; // "Here is a list of all "
       if (!extractAll) result+="dokumentoiduista "; // "documented "
       result+="nimiavaruuden jäsenistä linkitettynä "; // "namespace members with links to "
       if (extractAll) 
         result+="nimiavaruuden dokumentaatioon johon ne kuuluvat:"; // "the namespace documentation for each member:";
       else 
-        result+="nimiavaruuteen johon ne kuuluvat:"; // "the namespaces they belong to:"
+        result+="nimiavaruuksiin joihin ne kuuluvat:"; // "the namespaces they belong to:"
       return result;
     }
+    /*! This is used in LaTeX as the title of the chapter with the 
+     *  index of all namespaces.
+     */ 
     virtual QCString trNamespaceIndex()
-      // This is used in LaTeX as the title of the chapter with the 
-      // index of all namespaces.
-    { return "Nimiavaruuden Indeksi"; } // "Namespace Index"
+    { return "Nimiavaruuksien luettelo"; } // "Namespace Index"
+    
+    /*! This is used in LaTeX as the title of the chapter containing
+     *  the documentation of all namespaces.
+     */
     virtual QCString trNamespaceDocumentation()
-      // This is used in LaTeX as the title of the chapter containing
-      // the documentation of all namespaces.
-    { return "Nimiavaruuden Dokumentaatio"; } // "Namespace Documentation"
+    { return "Nimiavaruuden dokumentaatio"; } // "Namespace Documentation"
+
+//////////////////////////////////////////////////////////////////////////
+// new since 0.49-990522
+//////////////////////////////////////////////////////////////////////////
+
+    /*! This is used in the documentation before the list of all
+     *  namespaces in a file.
+     */
+    virtual QCString trNamespaces()
+    { return "Nimiavaruudet"; } // "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)"Dokumentaatio tälle "; // "The documentation for this "
+      switch(compType)
+      {
+        case ClassDef::Class:      result+="luokalle"; break; // "class"
+        case ClassDef::Struct:     result+="tietueelle"; break; // "struct"
+        case ClassDef::Union:      result+="yhdisteelle"; break; // "union"
+        case ClassDef::Interface:  result+="rajapinnalle"; break; // "interface"
+        case ClassDef::Protocol:   result+="protokollalle"; break; // "protocol"
+        case ClassDef::Category:   result+="kategorialle"; break; // "category"
+        case ClassDef::Exception:  result+="poikkeukselle"; break; // "exception"
+      }
+      if (single) result+=" generoitiin seuraavasta tiedostosta:"; // " was generated from the following file"
+      else result+=" generoitiin seuraavista tiedostoista:"; // ":" or "s:"
+      return result;
+    }
+
+    /*! This is in the (quick) index as a link to the alphabetical compound
+     * list.
+     */
+    virtual QCString trAlphabeticalList()
+    { return "Aakkosellinen lista"; } // "Alphabetical List"
+
+//////////////////////////////////////////////////////////////////////////
+// new since 0.49-990901
+//////////////////////////////////////////////////////////////////////////
+
+    /*! This is used as the heading text for the retval command. */
+    virtual QCString trReturnValues()
+    { return "Paluuarvot"; } // "Return values"
+
+    /*! This is in the (quick) index as a link to the main page (index.html)
+     */
+    virtual QCString trMainPage()
+    { return "Pääsivu"; } // "Main Page"
+
+    /*! 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 "s."; } // "p."
+
+//////////////////////////////////////////////////////////////////////////
+// new since 0.49-991003
+//////////////////////////////////////////////////////////////////////////
+
+    virtual QCString trDefinedAtLineInSourceFile()
+    {
+      return "Määrittely tiedoston @1 rivillä @0."; //  "Definition at line @0 of file @1."
+    }
+    virtual QCString trDefinedInSourceFile()
+    {
+      return "Määrittely tiedostossa @0."; // "Definition in file @0."
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 0.49-991205
+//////////////////////////////////////////////////////////////////////////
+
+    virtual QCString trDeprecated()
+    {
+      return "Vanhentunut"; // "Deprecated"
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.0.0
+//////////////////////////////////////////////////////////////////////////
+
+    /*! this text is put before a collaboration diagram */
+    virtual QCString trCollaborationDiagram(const char *clName)
+    {
+      return (QCString)"Yhteistyökaavio luokalle "+clName+":"; // "Collaboration diagram for "+clName+":"
+    }
+    /*! this text is put before an include dependency graph */
+    virtual QCString trInclDepGraph(const char *fName)
+    {
+      return (QCString)"Sisällytysriippuvuuskaavio tiedostolle "+fName+":"; // "Include dependency graph for "+fName+":"
+    }
+    /*! header that is put before the list of constructor/destructors. */
+    virtual QCString trConstructorDocumentation()
+    {
+      return "Rakentajien & purkajien dokumentaatio"; // "Constructor & Destructor Documentation";
+    }
+    /*! Used in the file documentation to point to the corresponding sources. */
+    virtual QCString trGotoSourceCode()
+    {
+      return "Siirry tämän tiedoston lähdekoodiin."; // "Go to the source code of this file."
+    }
+    /*! Used in the file sources to point to the corresponding documentation. */
+    virtual QCString trGotoDocumentation()
+    {
+      return "Mene tämän tiedoston dokumentaatioon."; // "Go to the documentation of this file."
+    }
+    /*! Text for the \\pre command */
+    virtual QCString trPrecondition()
+    {
+      return "Esiehto"; //"Precondition"
+    }
+    /*! Text for the \\post command */
+    virtual QCString trPostcondition()
+    {
+      return "Jälkiehto"; // "Postcondition"
+    }
+    /*! Text for the \\invariant command */
+    virtual QCString trInvariant()
+    {
+      return "Invariantti"; // vai "Pysyväisväittämä"? "Invariant"
+    }
+    /*! Text shown before a multi-line variable/enum initialization */
+    virtual QCString trInitialValue()
+    {
+      return "Alkuarvo:"; // "Initial value:"
+    }
+    /*! Text used the source code in the file index */
+    virtual QCString trCode()
+    {
+      return "koodi"; // "code"
+    }
+    virtual QCString trGraphicalHierarchy()
+    {
+      return "Graafinen luokkahierarkia"; // "Graphical Class Hierarchy"
+    }
+    virtual QCString trGotoGraphicalHierarchy()
+    {
+      return "Siirry graafiseen luokkahiearkiaan"; // "Go to the graphical class hierarchy"
+    }
+    virtual QCString trGotoTextualHierarchy()
+    {
+      return "Siirry tekstimuotoiseen luokkahierarkiaan"; // "Go to the textual class hierarchy"
+    }
+    virtual QCString trPageIndex()
+    {
+      return "Sivuhakemisto"; // "Page Index"
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.1.0
+//////////////////////////////////////////////////////////////////////////
+    
+    virtual QCString trNote()
+    {
+        // FIXME: Missähän merkityksessä tätä käytetään?
+      return "Huomautus"; // "Note"
+    }
+    virtual QCString trPublicTypes()
+    {
+      return "Julkiset tyypit"; // "Public Types"
+    }
+    virtual QCString trPublicAttribs()
+    {
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        return "Tietueen kentät"; // "Data Fields"
+      }
+      else
+      {
+        return "Julkiset attribuutit"; // "Public Attributes"
+      }
+    }
+    virtual QCString trStaticPublicAttribs()
+    {
+      return "Staattiset julkiset attribuutit"; // "Static Public Attributes"
+    }
+    virtual QCString trProtectedTypes()
+    {
+      return "Suojellut tyypit"; // "Protected Types"
+    }
+    virtual QCString trProtectedAttribs()
+    {
+      return "Suojellut attribuutit"; // "Protected Attributes"
+    }
+    virtual QCString trStaticProtectedAttribs()
+    {
+      return "Stattiset suojellut attribuutit"; // "Static Protected Attributes"
+    }
+    virtual QCString trPrivateTypes()
+    {
+      return "Yksityiset tyypit"; // "Private Types"
+    }
+    virtual QCString trPrivateAttribs()
+    {
+      return "Yksityiset attribuutit"; // "Private Attributes"
+    }
+    virtual QCString trStaticPrivateAttribs()
+    {
+      return "Staattiset yksityiset attribuutit"; // "Static Private Attributes"
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.1.3
+//////////////////////////////////////////////////////////////////////////
+
+    /*! Used as a marker that is put before a \\todo item */
+    virtual QCString trTodo()
+    {
+      return "Vielä tehtävä"; // "Todo"
+    }
+    /*! Used as the header of the todo list */
+    virtual QCString trTodoList()
+    {
+      return "Tehtävälista"; // "Todo List"
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.1.4
+//////////////////////////////////////////////////////////////////////////
+
+    virtual QCString trReferencedBy()
+    {
+      return "Viitattu"; // "Referenced by"
+    }
+    virtual QCString trRemarks()
+    {
+      return "Huomioita"; // "Remarks"
+    }
+    virtual QCString trAttention()
+    {
+      return "Huomio"; // "Attention"
+    }
+    virtual QCString trInclByDepGraph()
+    {
+      return "Tämä kaavio näyttää, mitkä tiedostot suorasti"
+             "tai epäsuorasti sisällyttävät tämän tiedoston";
+             // "This graph shows which files directly or "
+             // "indirectly include this file:"
+    }
+    virtual QCString trSince()
+    {
+        // FIXME: Missä merkityksessä tätä käytetään?
+      return "Lähtien"; // "Since"
+    }
+    
+//////////////////////////////////////////////////////////////////////////
+// new since 1.1.5
+//////////////////////////////////////////////////////////////////////////
+
+    /*! title of the graph legend page */
+    virtual QCString trLegendTitle()
+    {
+      return "Kaavion selite"; // "Graph Legend"
+    }
+    /*! 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 
+        "Tämä sivu selittää, kuinka doxygenin generoimia kaavioita tulkitaan.<p>\n"
+        // "This page explains how to interpret the graphs that are generated "
+        // "by doxygen.<p>\n"
+        "Ajattele seuraavaa esimerkkiä:\n"
+        // "Consider the following example:\n"
+        "\\code\n"
+        "/*! Näkymätön luokka katkaisun vuoksi */\n"
+        // "/*! Invisible class because of truncation */\n"
+        "class Nakymaton { };\n\n"
+        // "class Invisible { };\n\n"
+        "/*! Katkaistu luokka, periytymissuhde on piilotettu */\n"
+        // "/*! Truncated class, inheritance relation is hidden */\n"
+        "class Katkaistu : public Nakymaton { };\n\n"
+        // "class Truncated : public Invisible { };\n\n"
+        "/* Luokkaa ei ole dokumentoitu doxygen-kommenteilla */\n"
+        // "/* Class not documented with doxygen comments */\n"
+        "class Dokumentoimaton { };\n\n"
+        // "class Undocumented { };\n\n"
+        "/*! Julkista periyttämistä käyttäen periytetty luokka */\n"
+        // "/*! Class that is inherited using public inheritance */\n"
+        "class JulkinenKanta : public Katkaistu { };\n\n"
+        // "class PublicBase : public Truncated { };\n\n"
+        "/*! Malliluokka */\n"
+        // "/*! A template class */\n"
+        "template<class T> class Malli { };\n\n"
+        // "template<class T> class Templ { };\n\n"
+        "/*! Suojeltua periytymistä käyttäen periytetty luokka */\n"
+        // "/*! Class that is inherited using protected inheritance */\n"
+        "class SuojeltuKanta { };\n\n"
+        // "class ProtectedBase { };\n\n"
+        "/*! Yksityistä periytymistä käyttäen periytetty luokka */\n"
+        // "/*! Class that is inherited using private inheritance */\n"
+        "class YksityisKanta { };\n\n"
+        // "class PrivateBase { };\n\n"
+        "/*! Luokka jota periytetty luokka käyttää */\n"
+        // "/*! Class that is used by the Inherited class */\n"
+        "class Kaytetty { };\n\n"
+        // "class Used { };\n\n"
+        "/*! Kantaluokka joka periytyy useasta muusta luokasta */\n"
+        // "/*! Super class that inherits a number of other classes */\n"
+        "class Periytetty : public JulkinenKanta,\n"
+        "                 : protected SuojeltuKanta,\n"
+        "                 : private YksityisKanta,\n"
+        "                 : public Dokumentoimaton,\n"
+        "                 : public Malli<int>\n"
+        "{\n"
+        "  private:\n"
+        "    Kaytetty *m_kaytettyLuokka;\n"
+        "}\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"
+        "Jos \\c MAX_DOT_GRAPH_HEIGHT-kenttä asetustiedostossa "
+        // "If the \\c MAX_DOT_GRAPH_HEIGHT tag in the configuration file "
+        "on asetettu arvoon 240, on tuloksena seuraavanlainen kaavio:"
+        // "is set to 240 this will result in the following graph:"
+        "<p><center><img alt=\"\" src=\"graph_legend."+Config_getEnum("DOT_IMAGE_FORMAT")+"\"></center>\n"
+        "<p>\n"
+        "Ylläolevassa kaaviossa laatikoilla on seuraavat merkitykset\n:"
+        // "The boxes in the above graph have the following meaning:\n"
+        "<ul>\n"
+        "<li>Täytetty harmaa laatikko esittää tietuetta tai luokkaa, jolle "
+        // "<li>%A filled gray box represents the struct or class for which the "
+        "kaavio on generoitu.\n"
+        // "graph is generated.\n"
+        "<li>Mustareunainen laatikko merkitsee dokumentoitua tietuetta tai luokkaa.\n"
+        // "<li>%A box with a black border denotes a documented struct or class.\n"
+        "<li>Harmaareunainen laatikko merkitsee dokumentoimatonta tietuetta tai luokkaa.\n"
+        // "<li>%A box with a grey border denotes an undocumented struct or class.\n"
+        "<li>Punareunainen laatikko merkistee dokumentoitua luokkaa tai structia "
+        // "<li>%A box with a red border denotes a documented struct or class for"
+        "jolle ei näytetä kaikkia periytymis-/sisällyssuhteita. Kaavio "
+        // "which not all inheritance/containment relations are shown. %A graph is "
+        "katkaistaan, jos se ei mahdu määriteltyjen rajojen sisään.\n"
+        // "truncated if it does not fit within the specified boundaries.\n"
+        "</ul>\n"
+        "Nuolilla on seuraavat merkitykset:\n"
+        // "The arrows have the following meaning:\n"
+        "<ul>\n"
+        "<li>Tummansinistä nuolta käytetään osoittamaan julkista periytymis"
+        // "<li>%A dark blue arrow is used to visualize a public inheritance "
+        "suhdetta kahden luokan välillä.\n"
+        // "relation between two classes.\n"
+        "<li>Tummanvihreää nuolta käytetään suojellussa periytymisessä.\n"
+        // "<li>%A dark green arrow is used for protected inheritance.\n"
+        "<li>Tummanpunaista nuolta käytetään yksityisessä periytymisessä.\n"
+        // "<li>%A dark red arrow is used for private inheritance.\n"
+        "<li>Purppuranväristä katkoviivaa käytetään, jos luokka sisältyy tai "
+        // "<li>%A purple dashed arrow is used if a class is contained or used "
+        "on toisen luokan käyttämä. Nuoli nimetään sillä muuttujalla/muuttujilla "
+        // "by another class. The arrow is labeled with the variable(s) "
+        "jonka läpi osoitettua luokkaa tai tietuetta käytetään.\n"
+        // "through which the pointed class or struct is accessible.\n"
+        "<li>Keltainen katkoviivalla piirretty nuoli merkitsee suhdetta mallin esiintymän ja "
+        // "<li>%A yellow dashed arrow denotes a relation between a template instance and "
+        "malliluokan välillä. Nuoli nimetään "
+        // "the template class it was instantiated from. The arrow is labeled with "
+        "mallin esiintymän malliparametrilla.\n"
+        // "the template parameters of the instance.\n"
+        "</ul>\n";
+    }
+    /*! text for the link to the legend page */
+    virtual QCString trLegend()
+    {
+      return "selite"; // "legend"
+    }
+    
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.0
+//////////////////////////////////////////////////////////////////////////
+    
+    /*! Used as a marker that is put before a test item */
+    virtual QCString trTest()
+    {
+      return "Testi"; // "Test"
+    }
+    /*! Used as the header of the test list */
+    virtual QCString trTestList()
+    {
+      return "Testilista"; // "Test List"
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.1
+//////////////////////////////////////////////////////////////////////////
+
+    /*! Used as a section header for KDE-2 IDL methods */
+    virtual QCString trDCOPMethods()
+    {
+      return "DCOP-jäsenfunktiot"; // "DCOP Member Functions"
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.2
+//////////////////////////////////////////////////////////////////////////
+
+    /*! Used as a section header for IDL properties */
+    virtual QCString trProperties()
+    {
+      return "Ominaisuudet"; // "Properties"
+    }
+    /*! Used as a section header for IDL property documentation */
+    virtual QCString trPropertyDocumentation()
+    {
+      return "Ominaisuuksien dokumentaatio"; // "Property Documentation"
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.4
+//////////////////////////////////////////////////////////////////////////
+
+    /*! Used for Java classes in the summary section of Java packages */
+    virtual QCString trClasses()
+    {
+      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
+      {
+        return "Tietueet"; // "Data Structures"
+      }
+      else
+      {
+        return "Luokat"; // "Classes"
+      }
+    }
+    /*! Used as the title of a Java package */
+    virtual QCString trPackage(const char *name)
+    {
+      return (QCString)"Paketti "+name; // "Package "
+    }
+    /*! Title of the package index page */
+    virtual QCString trPackageList()
+    {
+      return "Pakettilista"; // "Package List"
+    }
+    /*! The description of the package index page */
+    virtual QCString trPackageListDescription()
+    {
+      return "Tässä ovat paketit lyhyiden selitysten kanssa (jos saatavilla):"; // "Here are the packages with brief descriptions (if available):"
+    }
+    /*! The link name in the Quick links header for each page */
+    virtual QCString trPackages()
+    {
+      return "Paketit"; // "Packages"
+    }
+    /*! Text shown before a multi-line define */
+    virtual QCString trDefineValue()
+    {
+      return "Arvo:"; // "Value:"
+    }
+    
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.5
+//////////////////////////////////////////////////////////////////////////
+    
+    /*! Used as a marker that is put before a \\bug item */
+    virtual QCString trBug()
+    {
+      return "Bugi"; // "Bug"
+    }
+    /*! Used as the header of the bug list */
+    virtual QCString trBugList()
+    {
+      return "Bugilista"; // "Bug List"
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// 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 "1252";
+    }
+    
+
+    /*! Used as ansicpg for RTF fcharset 
+     *  \see trRTFansicp() for a table of possible values.
+     */
+    virtual QCString trRTFCharSet()
+    {
+      return "0";
+    }
+
+    /*! Used as header RTF general index */
+    virtual QCString trRTFGeneralIndex()
+    {
+      return "Hakemisto"; // "Index"
+    }
+   
+    /*! 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)
+    { 
+      QCString result((first_capital ? "Luokka" : "luokka")); // "Class" / "class"
+      if (!singular)  result=(first_capital ? "Luokat" : "luokat"); // "+es" -> "Classes" / "classes"
+      return result; 
+    }
+
+    /*! 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)
+    { 
+      QCString result((first_capital ? "Tiedosto" : "tiedosto")); // "File" / "file"
+      if (!singular)  result+="t"; // "+s" -> "Files" / "files"
+      return result; 
+    }
+
+    /*! 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)
+    { 
+      QCString result((first_capital ? "Nimiavaruus" : "nimiavaruus")); // "Namespace" / "namespace"
+      if (!singular)  result=(first_capital ? "Nimiavaruudet" : "nimiavaruudet"); // "+s"
+      return result; 
+    }
+
+    /*! 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)
+    { 
+      QCString result((first_capital ? "Ryhmä" : "ryhmä")); // "Group" / "group"
+      if (!singular)  result+="t"; // "+s"
+      return result; 
+    }
+
+    /*! 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)
+    { 
+      QCString result((first_capital ? "Sivu" : "sivu")); // "Page" / "page"
+      if (!singular)  result+="t"; // "+s"
+      return result; 
+    }
+
+    /*! 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)
+    { 
+      QCString result((first_capital ? "Jäsen" : "jäsen")); // "Member" / "member"
+      if (!singular)  result+="et"; // "+s"
+      return result; 
+    }
+   
+    /*! 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)
+    { 
+      QCString result((first_capital ? "Globaali" : "globaali")); // "Global" / "global"
+      if (!singular)  result+="t"; // "+s"
+      return result; 
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// 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)
+    {                                                                         
+      QCString result((first_capital ? "Tekijä" : "tekijä")); // "Author" / "author"
+      if (!singular)  result+="t"; // "+s"
+      return result; 
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.11
+//////////////////////////////////////////////////////////////////////////
+
+    /*! This text is put before the list of members referenced by a member
+     */
+    virtual QCString trReferences()
+    {
+      return "Viittaukset"; // "References"
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// 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 "Toteuttaa "+trWriteList(numEntries)+"."; // "Implements "
+    }
+
+    /*! used in member documentation blocks to produce a list of
+     *  all members that implement this abstract member.
+     */
+    virtual QCString trImplementedInList(int numEntries)
+    {
+      return "Toteutettu "+trWriteList(numEntries)+"."; // "Implemented in "
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.16
+//////////////////////////////////////////////////////////////////////////
+
+    /*! used in RTF documentation as a heading for the Table
+     *  of Contents.
+     */
+    virtual QCString trRTFTableOfContents()
+    {
+      return "Sisällysluettelo"; // "Table of Contents"
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.17
+//////////////////////////////////////////////////////////////////////////
+
+    /*! Used as the header of the list of item that have been 
+     *  flagged deprecated 
+     */
+    virtual QCString trDeprecatedList()
+    {
+      return "Vanhentuneiden lista"; // "Deprecated List"
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.2.18
+//////////////////////////////////////////////////////////////////////////
+
+    /*! Used as a header for declaration section of the events found in 
+     * a C# program
+     */
+    virtual QCString trEvents()
+    {
+      return "Tapahtumat"; // "Events"
+    }
+    /*! Header used for the documentation section of a class' events. */
+    virtual QCString trEventDocumentation()
+    {
+      return "Tapahtumien dokumentaatio"; // "Event Documentation"
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.3
+//////////////////////////////////////////////////////////////////////////
+
+    /*! Used as a heading for a list of Java class types with package scope.
+     */
+    virtual QCString trPackageTypes()
+    { 
+      return "Paketin tyypit"; // "Package Types"
+    }
+    /*! Used as a heading for a list of Java class functions with package 
+     * scope. 
+     */
+    virtual QCString trPackageMembers()
+    { 
+      return "Paketin funktiot"; // "Package Functions"
+    }
+    /*! Used as a heading for a list of static Java class functions with 
+     *  package scope.
+     */
+    virtual QCString trStaticPackageMembers()
+    { 
+      return "Paketin staattiset funktiot"; // "Static Package Functions"
+    }
+    /*! Used as a heading for a list of Java class variables with package 
+     * scope.
+     */
+    virtual QCString trPackageAttribs()
+    { 
+      return "Paketin attribuutit"; // "Package Attributes"
+    }
+    /*! Used as a heading for a list of static Java class variables with 
+     * package scope.
+     */
+    virtual QCString trStaticPackageAttribs()
+    { 
+      return "Paketin staattiset attribuutit"; // "Static Package Attributes"
+    }
+    
+//////////////////////////////////////////////////////////////////////////
+// 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 "Kaikki"; // "All"
+    }
+    /*! Put in front of the call graph for a function. */
+    virtual QCString trCallGraph()
+    {
+      return "Tässä on kutsukaavio tälle funktiolle:"; // "Here is the call graph for this function:"
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// 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 "Etsi"; // "Search for"
+    }
+    /*! This string is used as the title for the page listing the search
+     *  results.
+     */
+    virtual QCString trSearchResultsTitle()
+    {
+      return "Hakutulokset"; // "Search Results"
+    }
+    /*! 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 "Valitettavasti yksikään dokumentti ei vastannut hakuasi."; // "Sorry, no documents matching your query."
+      }
+      else if (numDocuments==1)
+      {
+        return "Löytyi <b>1</b> dokumentti, joka vastasi hakuasi."; // "Found <b>1</b> document matching your query.";
+      }
+      else 
+      {
+        return "Löytyi <b>$num dokumenttia, jotka vastasivat hakuasi. " // "Found <b>$num</b> documents matching your query. "
+                "Parhaat tulokset näytetään ensin."; // "Showing best matches first."
+      }
+    }
+    /*! 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 "Osumat:"; // "Matches:"
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.3.8
+//////////////////////////////////////////////////////////////////////////
+
+    /*! This is used in HTML as the title of page with source code for file filename
+     */
+    virtual QCString trSourceFile(QCString& filename)
+    {
+      return filename + " lähdekooditiedosto"; // " Source File"
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.3.9
+//////////////////////////////////////////////////////////////////////////
+
+    /*! This is used as the name of the chapter containing the directory
+     *  hierarchy.
+     */
+    virtual QCString trDirIndex()
+    { return "Hakemistohierarkia"; } // "Directory Hierarchy"
+
+    /*! This is used as the name of the chapter containing the documentation
+     *  of the directories.
+     */
+    virtual QCString trDirDocumentation()
+    { return "Hakemistojen dokumentaatio"; } // "Directory Documentation"
+
+    /*! This is used as the title of the directory index and also in the
+     *  Quick links of an HTML page, to link to the directory hierarchy.
+     */
+    virtual QCString trDirectories()
+    { return "Hakemistot"; } // "Directories"
+
+    /*! This returns a sentences that introduces the directory hierarchy. 
+     *  and the fact that it is sorted alphabetically per level
+     */
+    virtual QCString trDirDescription()
+    { return "Tämä hakemistohierarkia on järjestetty aakkosellisesti tasoittain:";
+             //This directory hierarchy is sorted roughly, "
+             // "but not completely, alphabetically:";
+    }
+
+    /*! This returns the title of a directory page. The name of the
+     *  directory is passed via \a dirName.
+     */
+    virtual QCString trDirReference(const char *dirName)
+    { QCString result=dirName; result+=" Hakemistoreferenssi"; return result; }
+        // " Directory Reference"
+
+    /*! This returns the word directory with or without starting capital
+     *  (\a first_capital) and in sigular or plural form (\a singular).
+     */
+    virtual QCString trDir(bool first_capital, bool singular)
+    { 
+      QCString result((first_capital ? "Hakemisto" : "hakemisto")); // "Director" / "director"
+      if (singular) result+=""; else result+="t"; // "+y" / "+ies"
+      return result; 
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.4.1
+//////////////////////////////////////////////////////////////////////////
+
+    /*! This text is added to the documentation when the \\overload command
+     *  is used for a overloaded function.
+     */
+    virtual QCString trOverloadText()
+    {
+       return "Tämä on ylikuormitettu jäsenfunktio, ja se tarjotaan "
+              "käytön helpottamiseksi. Se eroaa ylläolevasta "
+              "funktiosta ainoastaan hyväksymiltä parametreiltaan.";
+              // "This is an overloaded member function, "
+              // "provided for convenience. It differs from the above "
+              // "function only in what argument(s) it accepts."
+    }
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.4.6
+//////////////////////////////////////////////////////////////////////////
+
+    /*! This is used to introduce a caller (or called-by) graph */
+    virtual QCString trCallerGraph()
+    {
+      return "Tässä on kutsukaavio tälle funktiolle:"; // "Here is the caller graph for this function:"
+    }
+
+    /*! This is used in the documentation of a file/namespace before the list 
+     *  of documentation blocks for enumeration values
+     */
+    virtual QCString trEnumerationValueDocumentation()
+    { return "Luettelotyypin dokumentaatio"; } // "Enumerator Documentation"
+
+//////////////////////////////////////////////////////////////////////////
+// new since 1.5.4 (mainly for Fortran)
+//////////////////////////////////////////////////////////////////////////
+    
+    /*! header that is put before the list of member subprograms (Fortran). */
+    virtual QCString trMemberFunctionDocumentationFortran()
+    { return "Jäsenfunktioiden/aliohjelmien dokumentaatio"; } // "Member Function/Subroutine Documentation"
+
+    /*! This is put above each page as a link to the list of annotated data types (Fortran). */    
+    virtual QCString trCompoundListFortran()
+    { return "Tietotyyppien lista"; } // "Data Types List"
+
+    /*! This is put above each page as a link to all members of compounds (Fortran). */
+    virtual QCString trCompoundMembersFortran()
+    { return "Kentät"; } // "Data Fields";
+
+    /*! This is an introduction to the annotated compound list (Fortran). */
+    virtual QCString trCompoundListDescriptionFortran()
+    { return "Tässä ovat tietotyypit lyhyillä selityksillä:"; } // "Here are the data types with brief descriptions:"
+
+    /*! This is an introduction to the page with all data types (Fortran). */
+    virtual QCString trCompoundMembersDescriptionFortran(bool extractAll)
+    {
+      QCString result="Tässä on lista kaikista "; // "Here is a list of all "
+      if (!extractAll)
+      {
+        result+="dokumentoiduista "; // "documented "
+      }
+      result+="tietotyyppien jäsenistä"; // "data types members"
+      result+=", sekä linkit "; // " with links to "
+      if (!extractAll) 
+      {
+         result+="tietueen dokumentaatioon jokaiselle jäsenelle"; // "the data structure documentation for each member"
+      }
+      else 
+      {
+         result+="tietotyyppeihin, joihin ne kuuluvat:"; // "the data types they belong to:"
+      }
+      return result;
+    }
+
+    /*! This is used in LaTeX as the title of the chapter with the 
+     * annotated compound index (Fortran).
+     */
+    virtual QCString trCompoundIndexFortran()
+    { return "Tietotyyppien hakemisto"; } // "Data Type Index"
+
+    /*! This is used in LaTeX as the title of the chapter containing
+     *  the documentation of all data types (Fortran).
+     */
+    virtual QCString trTypeDocumentation()
+    { return "Tietotyyppien dokumentaatio"; } // "Data Type Documentation"
+
+    /*! This is used in the documentation of a file as a header before the 
+     *  list of (global) subprograms (Fortran).
+     */
+    virtual QCString trSubprograms()
+    { return "Funktiot/aliohjelmat"; } // "Functions/Subroutines"
+
+    /*! This is used in the documentation of a file/namespace before the list 
+     *  of documentation blocks for subprograms (Fortran)
+     */
+    virtual QCString trSubprogramDocumentation()
+    { return "Funktioiden/aliohjelmien dokumentaatio"; } // "Function/Subroutine Documentation"
+
+    /*! This is used in the documentation of a file/namespace/group before 
+     *  the list of links to documented compounds (Fortran)
+     */
+     virtual QCString trDataTypes()
+    { return "Tietotyypit"; } // "Data Types"
+    
+    /*! used as the title of page containing all the index of all modules (Fortran). */
+    virtual QCString trModulesList()
+    { return "Moduulilista"; } // "Modules List"
+
+    /*! used as an introduction to the modules list (Fortran) */
+    virtual QCString trModulesListDescription(bool extractAll)
+    {
+      QCString result="Tässä on lista kaikista "; // "Here is a list of all "
+      if (!extractAll) result+="dokumentoiduista "; // "documented "
+      result+="moduuleista lyhillä selityksillä:"; // "modules with brief descriptions:"
+      return result;
+    }
+
+    /*! used as the title of the HTML page of a module/type (Fortran) */
+    virtual QCString trCompoundReferenceFortran(const char *clName,
+                                    ClassDef::CompoundType compType,
+                                    bool isTemplate)
+    {
+      QCString result=(QCString)clName;
+      switch(compType)
+      {
+        case ClassDef::Class:      result+=" Moduuli"; break; // " Module"
+        case ClassDef::Struct:     result+=" Tyyppi"; break; // " Type"
+        case ClassDef::Union:      result+=" Yhdiste"; break; // " Union"
+        case ClassDef::Interface:  result+=" Rajapinta"; break; // " Interface"
+        case ClassDef::Protocol:   result+=" Protokolla"; break; // " Protocol"
+        case ClassDef::Category:   result+=" Kategoria"; break; // " Category"
+        case ClassDef::Exception:  result+=" Poikkeus"; break; // " Exception"
+      }
+      if (isTemplate) result+="malli"; // " Template"
+      result+="referenssi"; // " Reference"
+      return result;
+    }
+    /*! used as the title of the HTML page of a module (Fortran) */
+    virtual QCString trModuleReference(const char *namespaceName)
+    {
+      QCString result=namespaceName;
+      result+=" Moduulin referenssi"; // " Module Reference"
+      return result;
+    }
+    
+    /*! This is put above each page as a link to all members of modules. (Fortran) */
+    virtual QCString trModulesMembers()
+    { return "Moduulin jäsenet"; } // "Module Members"
+
+    /*! This is an introduction to the page with all modules members (Fortran) */
+    virtual QCString trModulesMemberDescription(bool extractAll)
+    { 
+      QCString result="Tässä on lista moduulin kaikista "; // "Here is a list of all "
+      if (!extractAll) result+="dokumentoiduista"; // "documented "
+      result+="jäsenistä, sekä linkit "; // "module members with links to "
+      if (extractAll) 
+      {
+        result+="moduulin dokumentaatioon jokaiselle jäsenelle:"; // "the module documentation for each member:"
+      }
+      else 
+      {
+        result+="moduuleihin, joihin ne kuuluvat:"; // "the modules they belong to:"
+      }
+      return result;
+    }
+
+    /*! This is used in LaTeX as the title of the chapter with the 
+     *  index of all modules (Fortran).
+     */
+    virtual QCString trModulesIndex()
+    { return "Moduulien hakemisto"; } // "Modules Index"
+    
+    /*! 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 trModule(bool first_capital, bool singular)
+    {       
+      QCString result((first_capital ? "Moduuli" : "moduuli")); // "Module" / "module"
+      if (!singular)  result+="t"; // "+s"
+      return result; 
+    }
+    /*! This is put at the bottom of a module documentation page and is
+     *  followed by a list of files that were used to generate the page.
+     */
+    virtual QCString trGeneratedFromFilesFortran(ClassDef::CompoundType compType,
+        bool single)
+    { // here s is one of " Module", " Struct" or " Union"
+      // single is true implies a single file
+      QCString result=(QCString)"Dokumentaatio tälle "; // "The documentation for this "
+      switch(compType)
+      {
+        case ClassDef::Class:      result+="moduulille"; break; // "module"
+        case ClassDef::Struct:     result+="tyypille"; break; // "type"
+        case ClassDef::Union:      result+="yhdisteelle"; break; // "union"
+        case ClassDef::Interface:  result+="rajapinnalle"; break; // "interface"
+        case ClassDef::Protocol:   result+="protokollalle"; break; // "protocol"
+        case ClassDef::Category:   result+="kategorialle"; break; // "category"
+        case ClassDef::Exception:  result+="poikkeukselle"; break; // "exception"
+      }
+      result+=" generoitiin "; // " was generated from the following file"
+      if (single) result+="seuraavasta tiedostosta:"; else result+="seuraavista tiedostoista:"; // ":" / "s:"
+      return result;
+    }
+    /*! 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 trType(bool first_capital, bool singular)
+    { 
+      QCString result((first_capital ? "Tyyppi" : "tyyppi")); // "Type" / "type"
+      if (!singular)  result=(first_capital ? "Tyypit" : "tyypit"); // "+s"
+      return result; 
+    }
+    /*! 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 trSubprogram(bool first_capital, bool singular)
+    { 
+      QCString result((first_capital ? "Aliohjelma" : "aliohjelma")); // "Subprogram" / "subprogram"
+      if (!singular)  result+="t"; // "+s"
+      return result; 
+    }
+
+    /*! C# Type Constraint list */
+    virtual QCString trTypeConstraints()
+    {
+      return "Tyyppien rajoitteet"; // "Type Constraints"
+    }
+
 };
 
 #endif

src/translator_fr.h

@@ -158,7 +158,7 @@ class TranslatorFrench : public TranslatorAdapter_1_5_4
     /*! header that is put before the list of typedefs. */
        virtual QCString trMemberTypedefDocumentation()
       { 
-         return "Documentation des définition de type membres"; }
+         return "Documentation des définitions de type membres"; }
     
     /*! header that is put before the list of enumerations. */
        virtual QCString trMemberEnumerationDocumentation()

src/util.cpp

@@ -1909,6 +1909,10 @@ QCString tempArgListToString(ArgumentList *al)
       {
         result+=a->type.right(a->type.length()-i-1);
       }
+      else // nothing found -> take whole name
+      {
+        result+=a->type;
+      }
     }
     a=al->next();
     if (a) result+=", ";

src/vhdldocgen.cpp

@@ -1153,7 +1153,7 @@ void VhdlDocGen::getFuncParams(QList<Argument>& ql, const char* str)
       arg->attrib=s1.stripWhiteSpace();
       arg->name=(tt.last()).stripWhiteSpace();
 
-      //     printf("--proto \n [%s] [%s] [%s] [%s] [%s]",ttype.data(),arg->type.data(),arg->attrib.data(),arg->name.data(),s1.data());
+      // printf("--proto \n [%s] [%s] [%s] [%s] [%s]",ttype.data(),arg->type.data(),arg->attrib.data(),arg->name.data(),s1.data());
       ql.append(arg);
     }
     kk--;
@@ -1438,7 +1438,7 @@ void VhdlDocGen::writeProcedureProto(OutputList& ol,const ArgumentList* al,const
   ol.docify(" )");    
 
 
-}// writePorcedure
+}
 
 /*!
  * writes a function prototype to the output

src/vhdlscanner.l

@@ -83,6 +83,7 @@ static int              scantype      = 0;
 static int              g_lastCommentContext = 0;
 static bool             docBlockAutoBrief;
 static char             docBlockTerm;
+static int              iDocLine      = -1;
 
 //#define YY_A_INTERACTIVE 1
 #define YY_NEVER_INTERACTIVE 1
@@ -122,8 +123,7 @@ static void  addText (char *word, int llen)
 {
   while (llen>0)
   {
-    g_buf[iCounter]=*word;
-    *word++;
+    g_buf[iCounter]=*word++;
     iCounter++;
     llen--;
   }    
@@ -384,7 +384,7 @@ static void parseFunctionProto()
     {
       current->args+=",";
     }
-    Argument *arg=new Argument();
+    Argument *arg=new Argument;
     Argument *hh=(Argument*)ql.at(k);
     arg->name=hh->name;
     arg->type=hh->type;
@@ -437,6 +437,7 @@ void parserInit()
   lastEntity=0;
   bropen=0;
   openGroups=0;
+  iDocLine=-1;
   //isPrevDoc=FALSE;
   //prevDocEntry.reset();
   qrl.clear();
@@ -446,10 +447,9 @@ void parserInit()
     VhdlDocGen::init();
   }
 
-
   uint SSIZE=inputFile.size()+1024;
-  if (g_buf==0)  
-    g_buf=(char*)(calloc(SSIZE,sizeof(char)));
+  if (g_buf==0) free(g_buf);
+  g_buf=(char*)(calloc(SSIZE,sizeof(char)));
 
   if (g_buf==0)
   {
@@ -1367,6 +1367,7 @@ ALLID        [^;()\t ]
    */
 
 <*>{BR}*"--!"[^{}\n][^\n]*\n/{B}*"--!" { // multi line comment
+  if (iDocLine==-1) iDocLine=yyLineNr;
   if (YY_START!=Comment) // Start of the comment block
   {
     iTextCounter=iCounter;
@@ -1379,6 +1380,7 @@ ALLID        [^;()\t ]
 }
 
 <Comment>^{B}*"--!"[^\n]* {
+  if (iDocLine==-1) iDocLine=yyLineNr;
   addText(vhdlscanYYtext,vhdlscanYYleng);
   lineCount();
 }
@@ -1395,6 +1397,7 @@ ALLID        [^;()\t ]
 }
 
 <*>^{B}*"--!"[^\n]* { // one line comment
+  if (iDocLine==-1) iDocLine=yyLineNr;
   QCString qcs(yytext);
   int j=qcs.find("--!");
   qcs=qcs.right(qcs.length()-3-j);
@@ -1451,13 +1454,18 @@ static void handleCommentBlock(const QCString &doc,bool brief)
   int position=0;
   bool needsEntry=FALSE;
   Protection protection=Public;
+  if (brief) 
+    current->briefLine = iDocLine; 
+  else 
+    current->docLine = iDocLine;
+
   //printf("parseCommentBlock %p [%s]\n",current,doc.data());
   while (parseCommentBlock(
 	g_thisParser,
 	current,
 	doc,        // text
 	yyFileName, // file
-	brief ? current->briefLine : current->docLine,   // line of block start
+	iDocLine,   // line of block start
 	brief, 
 	docBlockAutoBrief,
 	FALSE,
@@ -1480,6 +1488,7 @@ static void handleCommentBlock(const QCString &doc,bool brief)
     unput(docBlockTerm);
     docBlockTerm=0;
   }
+  iDocLine=-1;
 }
 
 #if 0
@@ -1668,6 +1677,7 @@ void VHDLLanguageScanner::parseInput(const char *fileName,const char *fileBuf,En
   current=0;
 
   groupLeaveFile(yyFileName,yyLineNr);
+  inputFile.close();
 
   //mergeBrief(current_root);
   //mergeGrouping(current_root,0);

src/xmlgen.cpp

@@ -1238,7 +1238,7 @@ static void generateXMLForClass(ClassDef *cd,QTextStream &ti)
       {
         t << convertToXML(
               insertTemplateSpecifierInScope(
-              bcd->classDef->displayName(),bcd->templSpecifiers)
+              bcd->classDef->name(),bcd->templSpecifiers)
            );
       }
       else