[Doxygen-users] Invalid LaTex output when mixing table formats

[Vega, L. A <lui...@lm...>]

Since Doxygen only support the basic/simple version of markdown tables, the only way to add a caption to a markdown table is by wrapping it around with an HTML table.

This "workaround" works well for HTML output, but fails to output valid LaTeX text.

The following is a simple example that can be used to duplicate the error:

/*!
@page PAGE1   Some Page

@section SEC_1_1   Section 1.1

<table border="0">
<caption>The Table Caption</caption>
<tr><td>

| Document Number        | Document Title                                |
| :--------------------- | :-------------------------------------------- |
| &nbsp;                 | &nbsp;                                        |
| &nbsp;                 | &nbsp;                                        |
| &nbsp;                 | &nbsp;                                        |

</td></tr>
</table>
 */