diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/docblocks.doc | 72 | ||||
| -rw-r--r-- | doc/doxygen_manual.tex | 4 | ||||
| -rw-r--r-- | doc/features.doc | 2 | ||||
| -rw-r--r-- | doc/starting.doc | 1 |
4 files changed, 4 insertions, 75 deletions
diff --git a/doc/docblocks.doc b/doc/docblocks.doc index 23933c7..6c1edae 100644 --- a/doc/docblocks.doc +++ b/doc/docblocks.doc @@ -31,9 +31,9 @@ additional markings, so doxygen knows it is a piece of structured text that needs to end up in the generated documentation. The \ref cppblock "next" section presents the various styles supported by doxygen. -For Python, VHDL, Fortran, and Tcl code there are different commenting -conventions, which can be found in sections \ref pythonblocks, \ref vhdlblocks, -\ref fortranblocks, and \ref tclblocks respectively. +For Python, VHDL, and Fortran code there are different commenting +conventions, which can be found in sections \ref pythonblocks, \ref vhdlblocks, and +\ref fortranblocks respectively. \subsection cppblock Comment blocks for C-like languages (C/C++/C#/Objective-C/PHP/Java) @@ -564,72 +564,6 @@ C> input parameter end function A \endcode -\subsection tclblocks Comment blocks in Tcl - -Doxygen documentation can be included in normal Tcl comments. - -To start a new documentation block start a line with \c ## (two hashes). -All following comment lines and continuation lines will be added to this -block. The block ends with a line not starting with a \c # (hash sign). - -A brief documentation can be added with \c ;#< (semicolon, hash and -less-than sign). The brief documentation also ends at a line not starting -with a \c # (hash sign). - -Inside doxygen comment blocks all normal doxygen markings are supported. -The only exceptions are described in the following two paragraphs. - -If a doxygen comment block ends with a line containing only -\c #\\code or \c #\@code all code until a line only containing \c #\\endcode -or \c #\@endcode is added to the generated documentation as code block. - -If a doxygen comment block ends with a line containing only -\c #\\verbatim or \c #\@verbatim all code until a line only containing -\c #\\endverbatim or \c #\@endverbatim is added verbatim to the generated -documentation. - -To detect namespaces, classes, functions and variables the following -Tcl commands are recognized. Documentation blocks can be put on the lines -before the command. - -<ul> -<li><tt>namespace eval ..</tt> Namespace -<li><tt>proc ..</tt> Function -<li><tt>variable ..</tt> Variable -<li><tt>common ..</tt> Common variable -<li><tt>itcl::class ..</tt> Class -<li><tt>itcl::body ..</tt> Class method body definition -<li><tt>oo::class create ..</tt> Class -<li><tt>oo::define ..</tt> OO Class definition -<li><tt>method ..</tt> Class method definitions -<li><tt>constructor ..</tt> Class constructor -<li><tt>destructor ..</tt> Class destructor -<li><tt>public ..</tt> Set protection level -<li><tt>protected ..</tt> Set protection level -<li><tt>private ..</tt> Set protection level -</ul> - -<!-- -To use your own keywords you an map these keyword to the recognized commands -using the \ref cfg_tcl_subs "TCL_SUBST" entry in the configuration file. -The entry contain a list of word-keyword mappings. To use the itcl::* -commands without the leading namespace use p.e.: - -\verbatim TCL_SUBST = class itcl:class body itcl:body \endverbatim ---> - -Following is an example using doxygen style comments: - -\include tclexample.tcl - \htmlonly - Click <a href="examples/tclexample/html/index.html">here</a> - for the corresponding HTML documentation that is generated by doxygen. - \endhtmlonly - \latexonly - See \hyperlink{tcl_example}{TCL example} - for the corresponding \mbox{\LaTeX} documentation that is generated by doxygen. - \endlatexonly - \section docstructure Anatomy of a comment block diff --git a/doc/doxygen_manual.tex b/doc/doxygen_manual.tex index e350013..0148379 100644 --- a/doc/doxygen_manual.tex +++ b/doc/doxygen_manual.tex @@ -221,10 +221,6 @@ Written by Dimitri van Heesch\\[2ex] \begin{DoxygenSubAppendix} \subinputfrom{../html/examples/mux/latex/}{refman_doc} \end{DoxygenSubAppendix} - \doxysection{Tcl Example}\label{tcl_example}\hypertarget{tcl_example}{} - \begin{DoxygenSubAppendix} - \subinputfrom{../html/examples/tclexample/latex/}{refman_doc} - \end{DoxygenSubAppendix} \chapter{Class Example}\label{class_example}\hypertarget{class_example}{} \subinputfrom{../html/examples/class/latex/}{refman_doc} diff --git a/doc/features.doc b/doc/features.doc index 65fc343..461caef 100644 --- a/doc/features.doc +++ b/doc/features.doc @@ -29,7 +29,7 @@ <li>Generates structured XML output for parsed sources, which can be used by external tools. <li>Supports C/C++, Java, (Corba and Microsoft) Java, Python, VHDL, PHP - IDL, C#, Fortran, TCL, Objective-C 2.0, and to some extent D sources. + IDL, C#, Fortran, Objective-C 2.0, and to some extent D sources. <li>Supports documentation of files, namespaces, packages, classes, structs, unions, templates, variables, functions, typedefs, enums and defines. diff --git a/doc/starting.doc b/doc/starting.doc index d419e92..ceb4cfc 100644 --- a/doc/starting.doc +++ b/doc/starting.doc @@ -119,7 +119,6 @@ Extension | Language | Extension | Language | Extension | Language .ixx |C / C++ | .php5 |PHP | .vhdl |VHDL .ipp |C / C++ | .inc |PHP | .ucf |VHDL .i++ |C / C++ | .phtml |PHP | .qsf |VHDL -.inl |C / C++ | .m |Objective-C | .tcl |TCL .h |C / C++ | .M |Objective-C | .md |Markdown .H |C / C++ | .py |Python | .markdown |Markdown .hh |C / C++ | .pyw |Python | .ice |Slice |