octave-maintainers
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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 30 in the "See also" list of history_control
- 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 128 in the "See also" list of makeValidName
- 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.

[~/local/repos/octave-addons-chrono]
$ 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
[~/local/repos/octave-addons-chrono]
$ 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.

https://github.com/apjanke/octave-addons-chrono/tree/master/doc

I'm interested in getting this cleared up too, but I haven't had time to dig down into the PDF generation code.

Cheers,
Andrew



reply via email to

[Prev in Thread] Current Thread [Next in Thread]