Question

How can I set the column width in comments for doxygen?

For the following table I would like to have the first column as small as possible in my LaTeX (PDF) output.

/*!
@brief
blablabla

Name | Description
---- | -----------
AB   | asdf asdf asdf asdf asdf 
*/

Answer 1

Latex has two ways to make tables (at least as far as I know):

• with minimal width, but no text wrapping or protection that prevents the table from becoming too wide. You simple get an overfull warning and the table will run off of the page.
• with a fixed column width; then the text will nicely wrap but one has to select an appropiate width for each column in advance.

Since doxygen cannot guess the table’s width, it uses a fixed column width, and currently that is based on \textwidth divided by the number of columns.

I’m thinking about a putting that width in a TeX length variable, so you can overrule it with a special doxygen command, but this has not been implemented yet.