Hi John,
On 12 Feb 2014, at 16:38 , John C. Martin
<john.mar...@smallbeartechnologies.com> wrote:
> Hello,
>
> I have been using Doxygen to generate a reference manual for some C++ code
> using the Latex output to generate a pdf. In the class documentation section
> down in the member function documentation I am getting an unwanted page break
> in the middle of the documentation for a function in some few cases and I
> can't figure out what to adjust to make it work.
>
> Specifically, when the sub section header for the function documentation
> happens to fall on the top of a page, if there is no text or only a line or
> two of text before starting the parameter table (I have listed all the
> parameters using the \param commands) a page break is thrown and the
> parameter
> table starts on the next page. The parameter table in each case is only a
> few
> entries long, so the table is not in need of a new page. Originally I was
> putting the parameter list after the brief description in the documentation
> and this was occurring more frequently. I rearranged the docs to move longer
> description text up above the parameter table (which I would rather not do)
> and it seems to have helped, but it still occurs if the longer description
> text does not result in enough lines in the output. I am guessing that there
> is some threshold in the style for the parameter table that could be adjusted
> to keep the page break from occurring.
>
> I do not know enough about Latex to figure out how to adjust the output to
> keep
> this from happening. Google has not turned up anything useful so far, nor
> has
> StackOverflow. Can anyone give me some pointers on how to keep this from
> happening?
If you are not using the latest doxygen release, try that first.
If that doesn't help you could see if emptying the content of the ensurespace
command in doxygen.sty helps, i.e. try:
\newcommand{\ensurespace}[1]{}
In general it is pretty hard to make LaTeX generate the right output
automatically.
It has the tendency to either leave too much whitespace or to put the content
into
the page margin :-(
Regards,
Dimitri
------------------------------------------------------------------------------
Android apps run on BlackBerry 10
Introducing the new BlackBerry 10.2.1 Runtime for Android apps.
Now with support for Jelly Bean, Bluetooth, Mapview and more.
Get your Android app in front of a whole new audience. Start now.
http://pubads.g.doubleclick.net/gampad/clk?id=124407151&iu=/4140/ostg.clktrk
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
