Graphics, Figures & Tables ⇒ DoxyParams Unwanted Page Break

[Michael_590]

I have tried to create a small example, duplicated below. Basically, after writing a line at the top of a page, a table is placed on the next page and does not come directly below the line of text.

Caveat: You might have difficulty using the "doxygen" package:

Code: Select all

\documentclass{book}
\usepackage{doxygen}
\begin{document}
\subsubsection{On any given day, I look to my food cabinet.}

\begin{DoxyParams}[1]{Food}
\mbox{\tt in} & {\em Orange} & fruit\\
\hline
\end{Doxyarams}
\end{document}

Reference:

http://doxygen.10944.n7.nabble.com/Unwa ... d6501.html

Thanks,

[Johannes_B]

I never used Doxygen and i don't think i am going to install it. But a first glanze on your code tells me, you will get an error

Code: Select all

environment x ended by environment y

Please always test your minimal examples before posting.

Please always read some introductory material. Some commands you are using are deprecated for 20 years (since 1994).

EDIT: i just downloaded doxygen.sty [1] and tried to run your code. The first error occured because fancyhdr isn't loaded. If a package uses commands from another package, it should ensure that it is loaded. Please report this to the maintainer of the package.
I fixed this, but then:

Code: Select all

! LaTeX Error: Environment DoxyParams undefined.

...

[1] ftp://ftp.cpc.ncep.noaa.gov

EDIT2: ok, found another file at http://www.semicomplete.com/files/xdoto ... oxygen.sty

Works, but reports an error with the tabular material. Of course it does. Environment doxyParams is a descriptive list.


EDIT3 The implementation of DoxyImage is faulty and produces too much white space in the file mentioned in my second edit. I can't be more specific, as there is no date whatsoever iin neither of those files. The web is littered with different versions of the same file. This should not have happened.


EDIT4 Making your document into a comilable one, i get the following output.

Code: Select all

\documentclass{book}
\usepackage{doxygen}
\begin{document}
\subsubsection{On any given day, I look to my
food cabinet.}

\begin{DoxyParams}{Food}
	\begin{tabular}{ccc}
	\mbox{\texttt{in}} & \emph{Orange} & fruit\\
	\hline
\end{tabular}
\end{DoxyParams}
\end{document}

[Michael_590]

I'm going to try and use the LaTeX table command, E.G.:

Code: Select all

\documentclass{book}
\begin{document}
\subsubsection{On any given day, I look to my food cabinet.}

Food
\begin{tabular*}{0.4\textwidth}{| l | c|}
\hline
Orange & fruit \\ \hline
Cake & desert\\ \hline
Steak & meat \\
\hline
\end{tabular*}
\end{document}

Unless you can help really fast (have improvements or suggestions) I'm going to look-up the following two things on the Internet:

• Changing the length of the table borders without adding to the text in the boxes, and
• making the lines, themselves, to be more heavy.

There are many other tables in my document, so I have to try and make any new ones (that use tabular) like the others (that use DoxyParams).

Again thanks,

[Johannes_B]

Michael, again, i need more information. Do you know the term experienced guessing? Everybody will reach his/her limits at one point.

Code: Select all

\documentclass{book}
\arrayrulewidth=3pt%drastic global changes
%\usepackage{array}
%\newcolumntype{M}[1]{>{\centering\arraybackslash}m{#1}}
\begin{document}
\subsubsection{On any given day, I look to my food cabinet.}

Food
\begin{tabular}{| p{0.3\textwidth} | p{0.6\textwidth}|}%Try changing p to M
\hline
Orange & fruit \\ \hline
Cake & desert\\ \hline
Steak & meat \\
\hline
\end{tabular}
\end{document}

Please have a look at package booktabs. Vertical lines are discouraged to use in general, as they are bad for readability. Horizontal rules should be used economically.


But as we go on guessing around, i want you to explain your workflow in detail. I have the feeling, that you might be on the wrong road.

[Michael_590]

I've found a remedy to "my" problem. All I have to do is place some simple textural information (for example a single word) at the unwanted breakpoint. And, the break disappears!

Reference:

http://doxygen.10944.n7.nabble.com/Unwa ... d6501.html

Thanks,

[Johannes_B]

Can you share your solution showing a minimal working example? It might be of interest for future users.

[Michael_590]

Can you share your solution showing a minimal working example? It might be of interest for future users.

Here is an example. I have combined part of the code you posted with what I think will produce the problem. But, I cannot guarentee it will produce the unwanted break for a small program.

This is completely untested, use it at your own risk!

Code: Select all

\documentclass{book}
\usepackage{doxygen}
\begin{document}
section{Cheeses of the World}
I don't like blue cheese.
\section{Bad Red Wines}
A cheap merlot
\section{Food}
\subsection{Common Foods}

\subsubsection[{Common Meals}]{\setlength{\rightskip}{0pt plus 5cm}CommonMeal --
\newpage
\begin{DoxyParamCaption}
\item[{Flavoids}]{reds }
\item[{Vitamins}]{B12}
\end{DoxyParamCaption}
} {\bfseries Wild} is healthy

The extra line of text to prevent the unwanted newpage command goes here.
\begin{DoxyParams}[1]{Food}
\mbox{\tt in}  & {\em orange} & fruit \\
\hline
\mbox{\tt in}  & {\em cake} & desert message \\
\hline
\end{DoxyParams}
\end{document}

[Michael_590]

This small document will definately not re-create the problem in my larger document. I ran it on my desktop computer. (My larger document almost a 100 figures, just as many tables, lot's of text, etc. It's will over 140 pages long.

Thanks,

Can you share your solution showing a minimal working example? It might be of interest for future users.

Here is an example. I have combined part of the code you posted with what I think will produce the problem. But, I cannot guarentee it will produce the unwanted break for a small program.

This is completely untested, use it at your own risk!

Code: Select all

\documentclass{book}
\usepackage{doxygen}
\begin{document}
section{Cheeses of the World}
I don't like blue cheese.
\section{Bad Red Wines}
A cheap merlot
\section{Food}
\subsection{Common Foods}

\subsubsection[{Common Meals}]{\setlength{\rightskip}{0pt plus 5cm}CommonMeal --
\newpage
\begin{DoxyParamCaption}
\item[{Flavoids}]{reds }
\item[{Vitamins}]{B12}
\end{DoxyParamCaption}
} {\bfseries Wild} is healthy

The extra line of text to prevent the unwanted newpage command goes here.
\begin{DoxyParams}[1]{Food}
\mbox{\tt in}  & {\em orange} & fruit \\
\hline
\mbox{\tt in}  & {\em cake} & desert message \\
\hline
\end{DoxyParams}
\end{document} 

[Johannes_B]

It would be nice of to provide a link to the doxygen.sty you are using. I get undefined commands again.

Also, and this is much more important, you are missusing the subsection command.

But again, i am wondering, what is your workflow? Michael, we need to be serious here. I have the suspicion that you are doing something wrong.

If your doxygen.sty is producing the output you have shown us, you should contact the author/maintainer (if there is any).

If you keep on going, before we worl out the details, you might run into serious trouble very hard to fix later on.

btw: you posted two posts, on containing the other completely. Can we delete the minimal one?

[Michael_590]

It would be nice of to provide a link to the doxygen.sty you are using. I get undefined commands again.

Also, and this is much more important, you are missusing the subsection command.

btw: you posted two posts, on containing the other completely. Can we delete the minimal one?

The Doxygen that I have came from:

http://www.stack.nl/~dimitri/doxygen/download.html

I have modified what I ran on my PC. The code posted was changed to match what you have been working on. Everything between the begin/end document was tested, but did not produce the error that I fixed. So, adding the extra line of text was not required.

I, myself, added the "sections". The "subsubsection" was produced by Doxygen. I removed a "\label" from the "subsubsection".

Thanks,