Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Class documentation beyond footer (Origin: bugzilla #699731) #5163

Open
doxygen opened this Issue Jul 2, 2018 · 0 comments

Comments

Projects
None yet
1 participant
@doxygen
Copy link
Owner

doxygen commented Jul 2, 2018

status REOPENED severity normal in component build for ---
Reported in version 1.8.3.1 on platform Other
Assigned to: Dimitri van Heesch

Original attachment names and IDs:

On 2013-05-05 23:54:12 +0000, Leo Carreon wrote:

I am building my documentation on Fedora 18 which generates a PDF file.  I
have noticed that one of the classes in the resulting PDF file have gone
beyond the footer.  (Please see page 65 in the attached PDF file.)

On 2013-05-06 18:15:30 +0000, albert wrote:

Thank you for reporting this problem, but can you please attach the promised
attachment as well as the used configuration file (Doxyfile).
When possible please make a small self contained example and add this as an
attachment so it is possible to reproduce the problem.

On 2013-05-06 20:52:41 +0000, Leo Carreon wrote:

Sorry, my original attachment was rejected due to its size.  I will try to
reproduce the problem with a smaller set of files and will supply the
attachments then.

On 2013-05-06 21:56:57 +0000, Leo Carreon wrote:

Created attachment 243435
Doxygen config file

On 2013-05-06 21:59:42 +0000, Leo Carreon wrote:

Sorry, I was unable to reproduce the same problem with a smaller set of
files.  I'm also unable to attach the original PDF file because of its size.

On 2013-05-08 17:52:47 +0000, albert wrote:

What is the size of the (compressed) files
Is it possible to make the files available on a ftp server?

On 2013-05-08 22:07:32 +0000, Leo Carreon wrote:

The size of the zipped up PDF file is 1.81 MB.  I can make the file
available on an ftp server if you have one.  Sorry, I don't have a publicly
available ftp server.

BTW, I have recently made some minor changes to the documentation in the
source and the problem has moved to different pages in the resulting PDF
file.  Another observation is that the problem always happens on a parameter
box.  It happened on 7 pages of the most recent PDF file.

The problem may still happen on a smaller set of my source files but I have
to experiment which combination of source files I can make it happen on.

On 2013-05-08 22:28:25 +0000, Leo Carreon wrote:

OK, I was finally able to reproduce the problem with a smaller set of my
source files and I am attaching them now.

On 2013-05-08 22:29:48 +0000, Leo Carreon wrote:

Created attachment 243636
ZIP file containing doxygen config file and resulting PDF file

On 2013-05-08 22:31:00 +0000, Leo Carreon wrote:

Created attachment 243637
Archive containing source files used

On 2013-05-09 07:52:33 +0000, albert wrote:

The example shows the problem on (a.o.) page 28 (routine mvSetDate), page 47
(routine smvPutNumber), page 73 (routine smvPutTzName).

Problem still occurs in SVN version 846 (1.8.3.1-20130402)

On 2013-05-10 12:56:31 +0000, Dimitri van Heesch wrote:

Looks like the \vspace{-40pt}'s in doxygen.sty were causing this. Reducing
this to \vspace{-25pt} keeps the tables above the margin.

On 2013-05-12 17:59:30 +0000, albert wrote:

Looked at the results with SVN version 848 (Doxygen 1.8.3.1 20130512) and
found
on page 75 still a problem.

At the same time I think that the extra space between the word Parameters
and
the top of the table is a bit large, especially when we compare it with
other
table items (like Exceptions, Template parameters, return values).

On 2013-05-12 18:49:34 +0000, Dimitri van Heesch wrote:

Yes, I see that my change doesn't really work and causes the extra spacing,
so I'll revert it.

So far I haven't found a generic way to prevent LaTeX from occasionally
overflowing the footer :-(

On 2013-05-13 20:50:50 +0000, Dimitri van Heesch wrote:

I have better luck using the supertabular package instead of the longtable
package, so I'll use that instead.

On 2013-05-13 20:52:29 +0000, Dimitri van Heesch wrote:

Created attachment 244105
Replacement stylesheet using supertabular package

Please try this replace style file and let me know if it solves the problem.

On 2013-05-14 17:35:39 +0000, albert wrote:

I've tested the new doxygen.sty.
- I've not seen that a table is going into the footer
- a number of small tables are split over pages (e.g. page 36/37, 55/56,
70/71, 71/72, 96/97, 99/100, 138/139, 142/143, 154/155)
- the word parameters is separated from the actual table (e.g. page 38/39)
- the words "Parameters", "Template parameters", "Return values" and
"Exceptions" are now boxed as well. I'm personally not in favor of it.
- the text inside the boxes is quite close to the top of the box, nearly
hitting the line on top. The spacing above the text is smaller that the
spacing below the text
- on page 51, 73, 85, 87, 134, 151 there is quite a bit of white space on
the top of the page before the paragraph starts
- quite a bit of white space on page 57, 69, 101, 129, 140

On 2013-05-19 12:36:48 +0000, Dimitri van Heesch wrote:

This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.8.4. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional
information
that you think can be relevant.

On 2013-05-20 12:15:11 +0000, albert wrote:

Tested with 1.8.4, some problems are still present (just listing an
occurrence once):
- page 13/14: header "Template Parameters" separated from the table (box is
gone from header)
- page 17/18 lot of white space, table fits on page 17
- page 107/108 table split over pages
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.