Re: Doc: ugly boxes

[Carl Sorensen]

On 6/12/11 6:07 AM, "Phil Holmes" <address@hidden> wrote:

> I'm continuing to look at the build system, and studying the output of make
> doc see lots of the following:
> 
> Overfull \hbox (plus some other  stuff)
> 
> 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 NR - see the PDF page 33
> and 37 for example.  I don't think these should be there (although I had
> previously assumed they were change bars).
> 
> 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
> 
> Could someone from the documentation team confirm that the bars are
> unintended and have a think about what should be done?

I'm not part of the doc team, but I'm sure the bars are unintended, and that
we should use @finalout.

IWBN if we could eliminate the overfull hboxes, but that doesn't seem to me
to be likely in the short run.

Thanks,

Carl