diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/commands.doc | 4 | ||||
| -rw-r--r-- | doc/formulas.doc | 34 | ||||
| -rw-r--r-- | doc/language.doc | 2 | ||||
| -rw-r--r-- | doc/translator_report.txt | 2 |
4 files changed, 32 insertions, 10 deletions
diff --git a/doc/commands.doc b/doc/commands.doc index 9544ad9..e52ad74 100644 --- a/doc/commands.doc +++ b/doc/commands.doc @@ -1882,8 +1882,8 @@ class C {}; The third argument is optional and can be used to specify the caption that is displayed below the image. This argument has to be specified - between quotes even if it does not contain any spaces. The quotes are - stripped before the caption is displayed. + on a single line and between quotes even if it does not contain any + spaces. The quotes are stripped before the caption is displayed. The fourth argument is also optional and can be used to specify the width or height of the image. This is only useful diff --git a/doc/formulas.doc b/doc/formulas.doc index db52c3f..c62d6cf 100644 --- a/doc/formulas.doc +++ b/doc/formulas.doc @@ -23,14 +23,14 @@ formulas (as images) in the HTML documentation, you will also need to have the following tools installed <ul> <li>\c latex: the \f$\mbox{\LaTeX}\f$ compiler, needed to parse the formulas. - To test I have used the teTeX 0.9 distribution. + To test I have used the teTeX 1.0 distribution. <li>\c dvips: a tool to convert DVI files to PostScript files - I have used version 5.86 from Radical Eye software for testing. + I have used version 5.92b from Radical Eye software for testing. <li>\c gs: the GhostScript interpreter for converting PostScript files - to bitmaps. I have used Aladdin GhostScript 5.10 for testing. + to bitmaps. I have used Aladdin GhostScript 8.0 for testing. </ul> -There are two ways to include formulas in the documentation. +There are three ways to include formulas in the documentation. <ol> <li>Using in-text formulas that appear in the running text. These formulas should be put between a pair of \\f\$ @@ -69,12 +69,34 @@ There are two ways to include formulas in the documentation. \right\} dt \right| \f] +<li>Formulas or other latex elements that are not in a math + environment can be specified using \\f{environment}, where + \c environment is the name of the \f$\mbox{\LaTeX}\f$ environment, + the corresponding end command is \\f}. Here is an example for an + equation array +\verbatim + \f{eqnarray*} + g &=& \frac{Gm_2}{r^2} \\ + &=& \frac{(6.673 \times 10^{-11}\,\mbox{m}^3\,\mbox{kg}^{-1}\, + \mbox{s}^{-2})(5.9736 \times 10^{24}\,\mbox{kg})}{(6371.01\,\mbox{km})^2} \\ + &=& 9.82066032\,\mbox{m/s}^2 + \f} +\endverbatim + which results in: + \f{eqnarray*} + g &=& \frac{Gm_2}{r^2} \\ + &=& \frac{(6.673 \times 10^{-11}\,\mbox{m}^3\,\mbox{kg}^{-1}\, + \mbox{s}^{-2})(5.9736 \times 10^{24}\,\mbox{kg})}{(6371.01\,\mbox{km})^2} \\ + &=& 9.82066032\,\mbox{m/s}^2 + \f} </ol> -Formulas should be valid commands in \f$\mbox{\LaTeX}\f$'s math-mode. +For the first two commands one should make sure formulas contain +valid commands in \f$\mbox{\LaTeX}\f$'s math-mode. For the third command +the section should contain valid command for the specific environment. \warning Currently, doxygen is not very fault tolerant in recovering from typos in formulas. It may have to be necessary to remove the -file <code>formula.repository</code> that is written in the html directory to +file <code>formula.repository</code> that is written to the html directory to a rid of an incorrect formula \htmlonly diff --git a/doc/language.doc b/doc/language.doc index ba92211..38e629d 100644 --- a/doc/language.doc +++ b/doc/language.doc @@ -23,7 +23,7 @@ text fragments, generated by doxygen, can be produced in languages other than English (the default). The output language is chosen through the configuration file (with default name and known as Doxyfile). -Currently (version 1.3.9.1), 30 languages +Currently (version 1.3.9.1-20041129), 30 languages are supported (sorted alphabetically): Afrikaans, Brazilian Portuguese, Catalan, Chinese, Chinese Traditional, Croatian, Czech, Danish, Dutch, English, Finnish, French, diff --git a/doc/translator_report.txt b/doc/translator_report.txt index ab1718b..41cb44f 100644 --- a/doc/translator_report.txt +++ b/doc/translator_report.txt @@ -1,4 +1,4 @@ -(1.3.9.1) +(1.3.9.1-20041129) Doxygen supports the following 30 languages (sorted alphabetically): |