|
Packit |
1c1d7e |
/******************************************************************************
|
|
Packit |
1c1d7e |
*
|
|
Packit |
1c1d7e |
*
|
|
Packit |
1c1d7e |
*
|
|
Packit |
1c1d7e |
* Copyright (C) 1997-2015 by Dimitri van Heesch.
|
|
Packit |
1c1d7e |
*
|
|
Packit |
1c1d7e |
* Permission to use, copy, modify, and distribute this software and its
|
|
Packit |
1c1d7e |
* documentation under the terms of the GNU General Public License is hereby
|
|
Packit |
1c1d7e |
* granted. No representations are made about the suitability of this software
|
|
Packit |
1c1d7e |
* for any purpose. It is provided "as is" without express or implied warranty.
|
|
Packit |
1c1d7e |
* See the GNU General Public License for more details.
|
|
Packit |
1c1d7e |
*
|
|
Packit |
1c1d7e |
* Documents produced by Doxygen are derivative works derived from the
|
|
Packit |
1c1d7e |
* input used in their production; they are not affected by this license.
|
|
Packit |
1c1d7e |
*
|
|
Packit |
1c1d7e |
*/
|
|
Packit |
1c1d7e |
/*! \page tables Including tables
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
Doxygen supports two ways to put tables in the documentation.
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
The easiest is to use the Markdown format as shown in @ref markdown_extra section @ref md_tables.
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
Although this format is easy to use and read, it is also rather limited.
|
|
Packit |
1c1d7e |
It supports only a simple grid of cells, while each cell is a
|
|
Packit |
1c1d7e |
single line of plain text.
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
For more complex tables the HTML syntax can be used. Doxygen
|
|
Packit |
1c1d7e |
will process such tables and translate them to the various output formats
|
|
Packit |
1c1d7e |
(at least for the formats that do support tables such as HTML and \LaTeX).
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
Here is an example of a complex table:
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
\verbatim
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
<caption id="multi_row">Complex table</caption>
|
|
Packit |
1c1d7e |
Column 1 Column 2 Column 3
|
|
Packit |
1c1d7e |
cell row=1+2,col=1cell row=1,col=2cell row=1,col=3
|
|
Packit |
1c1d7e |
cell row=2+3,col=2 cell row=2,col=3
|
|
Packit |
1c1d7e |
cell row=3,col=1 cell row=3+4,col=3
|
|
Packit |
1c1d7e |
cell row=4,col=1+2
|
|
Packit |
1c1d7e |
cell row=5,col=1 cell row=5,col=2+3
|
|
Packit |
1c1d7e |
cell row=6+7,col=1+2 cell row=6,col=3
|
|
Packit |
1c1d7e |
cell row=7,col=3
|
|
Packit |
1c1d7e |
cell row=8,col=1 cell row=8,col=2\n
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
Inner cell row=1,col=1Inner cell row=1,col=2
|
|
Packit |
1c1d7e |
Inner cell row=2,col=1Inner cell row=2,col=2
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
cell row=8,col=3
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
Item 1
|
|
Packit |
1c1d7e |
Item 2
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
\endverbatim
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
It has a caption, table heading, various row and column spans,
|
|
Packit |
1c1d7e |
a nested table as one of the cells, and a item list in another cell.
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
Note that the end tags (like ``) are left out in the example above.
|
|
Packit |
1c1d7e |
This is allowed, and in the HTML output doxygen will add the end tags again.
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
The output will look as follows:
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
<caption id="multi_row">Complex table</caption>
|
|
Packit |
1c1d7e |
Column 1 Column 2 Column 3
|
|
Packit |
1c1d7e |
cell row=1+2,col=1cell row=1,col=2cell row=1,col=3
|
|
Packit |
1c1d7e |
cell row=2+3,col=2 cell row=2,col=3
|
|
Packit |
1c1d7e |
cell row=3,col=1 cell row=3+4,col=3
|
|
Packit |
1c1d7e |
cell row=4,col=1+2
|
|
Packit |
1c1d7e |
cell row=5,col=1 cell row=5,col=2+3
|
|
Packit |
1c1d7e |
cell row=6+7,col=1+2 cell row=6,col=3
|
|
Packit |
1c1d7e |
cell row=7,col=3
|
|
Packit |
1c1d7e |
cell row=8,col=1 cell row=8,col=2\n
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
Inner cell row=1,col=1Inner cell row=1,col=2
|
|
Packit |
1c1d7e |
Inner cell row=2,col=1Inner cell row=2,col=2
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
cell row=8,col=3
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
Item 1
|
|
Packit |
1c1d7e |
Item 2
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
One can refer to the caption of the table using \ref cmdref "\\ref" using the caption's
|
|
Packit |
1c1d7e |
id as the label.
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
\htmlonly
|
|
Packit |
1c1d7e |
Go to the next section or return to the
|
|
Packit |
1c1d7e |
index.
|
|
Packit |
1c1d7e |
\endhtmlonly
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
*/
|