[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Doc: ugly boxes
From: |
Carl Sorensen |
Subject: |
Re: Doc: ugly boxes |
Date: |
Sun, 12 Jun 2011 06:48:58 -0600 |
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