Re: [Doxygen-users] Long tables in LaTeX/PDF don't span pages

[Clemens F. <c....@os...>]

On 10 Oct 2006 at 11:49, Clemens Feige wrote:

> In LaTeX normal tables do not wrap around at the end of the page.
> Of course you can create such tables in LaTeX, including features 
> like repeated headrows on each page and so on. There is a package 
> called LONGTABLE that does those things, it is more or less a 
> standard package. 
> 
> Unfortunately the syntax for this package in LaTeX is a little 
> different than for standard tables. Because you do not want to change 
> 
> the generated LaTeX code nor to "patch" Doxygen, you will have to 
> edit the <doxygen.sty> file. This is where the special made 
> "TabularC" enviroment is defined with "\newenviroment". I have not 
> yet used tables in Doxygen, but it should be possible to tweak the 
> "TabularC" enviroment to use the Longtable-package. 
> If you want to do this, I hope I can provide further help. 

Hi Kevin!

I want to continue my explanation about the LaTeX Longtable 
enviroment. I have tested it for you. It works well. This is what you 
have to do:

1.
First you need the longtable package. At the following line to the 
top of your doxygen.sty, where the other \RequirePackage commands 
are. This includes the package:

\RequirePackage{longtable}

2.
In the doxygen.sty replace the old TabularC enviroment with a new 
one. What I have is to replace the <tabular> enviroment with the 
<longtable> enviroment.

..................................................
OLD:
\newenvironment{TabularC}[1]
{
\setlength{\tmplength}
     {\linewidth/(#1)-\tabcolsep*2-\arrayrulewidth*(#1+1)/(#1)}
      \par\begin{tabular*}{\linewidth}
             
{*{#1}{|>{\PBS\raggedright\hspace{0pt}}p{\the\tmplength}}|}
}
{\end{tabular*}\par}
..................................................
NEW:
\newenvironment{TabularC}[1]
{
 \setlength{\tmplength}{\linewidth/(#1)-\tabcolsep*2-
\arrayrulewidth*(#1+1)/(#1)}
 \par\begin{longtable}{*{#1}{|p{\the\tmplength}}|}
}
{
 \end{longtable}\par
}
..................................................


3.
That's it. Run LaTeX as usual. You do not need to modify the doxygen 
generated LaTeX code. 

4.
Don't forget to save your doxygen.sty file. You will have to rewrite 
it each time, because doxygen always creates a new one, but it has 
always the same contents. So you can modify it once and keep your 
copy.
At this points things can be made even better e.g. with an external 
sty-file that is being included. I have not tested about this.

Good luck

Clemens


-----------------------------------
Dipl. Ing. Clemens Feige
Osypka Medical GmbH
c....@os...
www.osypkamed.com