bug-lilypond
[Top][All Lists]

## Issue 1691 in lilypond: Ugly bars in PDF documents

 From: lilypond Subject: Issue 1691 in lilypond: Ugly bars in PDF documents Date: Mon, 13 Jun 2011 14:42:43 +0000

Status: Accepted
Owner: ----
Labels: Type-Documentation Priority-Medium

New issue 1691 by address@hidden: Ugly bars in PDF documents


In the documentation build it's common to see an error message beginning "Overfull \hbox".

Looking on the web for what this means, I found

http://docs.freebsd.org/info/texinfo/texinfo.info.Overfull_hboxes.html which says:

"TeX is sometimes unable to typeset a line without extending it into the
right margin."... "unless told otherwise, TeX will print a large, ugly,
black rectangle beside the line that contains the overfull hbox."


There are quite a few of these in, say, the 2.14.0 NR - see the PDF page 33 and 37 for example.

It would seem there are 2 options: either fix the text/diagram sizes, or
compile as suggested in the page above:


"To prevent such a monstrosity from marring your final printout, write the following in the beginning of the Texinfo file on a line of its own, before the address@hidden' command:"

@finalout


The current consensus is that it would be better to start by looking at correcting the documentation to get the text correctly sized.

Issue 1015 is related to this.