octave-maintainers
[Top][All Lists]

## Re: Overfull hboxes in pdf manual

 From: Andrew Janke Subject: Re: Overfull hboxes in pdf manual Date: Sat, 19 Jan 2019 06:36:26 -0500 User-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.13; rv:60.0) Gecko/20100101 Thunderbird/60.4.0



On 1/19/19 6:09 AM, "Markus Mützel" wrote:

Scrolling through the PDF manual, I can see a couple of overfull hboxes. E.g.
on:
- page 83 in one of the examples for strsplit
- page 87 in two of the examples for erase
- page 118 in one of the examples for num2cell
- page 119 in the examples for mat2cell
- page 213 in the description for the warning "Octave:singular-matrix"

After these, I stopped scrolling further. I also might have skipped a few.

In all of these occurrences, one of our (custom?) macros seems to be involved.
Can we do something to improve the line wrapping in the PDF with those?

Markus




I'm also seeing this in the PDF manual I'm generating for my Chrono package. I can get a listing from the "make" output; maybe you can too.

$PATH="/usr/local/opt/texinfo/bin:$PATH" make doc | grep Overfull
Overfull \hbox (43.6852pt too wide) in paragraph at lines 109--109
Overfull \hbox (141.4129pt too wide) in paragraph at lines 173--173
Overfull \hbox (14.94176pt too wide) in paragraph at lines 229--229
Overfull \hbox (43.6852pt too wide) in paragraph at lines 109--109
Overfull \hbox (141.4129pt too wide) in paragraph at lines 173--173
Overfull \hbox (14.94176pt too wide) in paragraph at lines 229--229
$PATH="/usr/local/opt/texinfo/bin:$PATH" texi2pdf --version | head -1
texi2pdf (GNU Texinfo 6.5) 7842


By examining the combined .texi file, one could map those lines back to the files the texinfo help was originally extracted from.


I'm using a customized set of doco generation scripts based on those from the Octave Forge communications package.