Issue 1691 in lilypond: Ugly bars in PDF documents

[lilypond]

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

New issue 1691 by address@hidden: Ugly bars in PDF documents
http://code.google.com/p/lilypond/issues/detail?id=1691

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.