[Top][All Lists]

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

Re: overfull hboxes in pdf manual

From: Rik
Subject: Re: overfull hboxes in pdf manual
Date: Mon, 21 Jan 2019 11:23:36 -0800

On 01/21/2019 10:29 AM, John W. Eaton wrote:
On 1/21/19 12:16 PM, Rik wrote:

In Octave's own code base we only use two spaces. Theoretically this is controllable by issuing an @exampleindent N command at the beginning of the Octave documentation, but I have not gotten it to work.  Maybe we need a Texinfo wizard to help us set that up.

I see some changes in the PDF output when using different values of N for "@exampleindent N", but the spacing seems wider than the documented N ems.  Nothing seems to change for Info output.  This looks like a bug in texinfo to me.


I did some experimentation.  The spacing used in the PDF is measured in ems, a typographical unit that used to be the width of a capital 'M', but is now the width of an em-dash by definition.  While the default value of @exampleindent is 5, in TeX this is rendered as 0.4 inches.  However, if you specify the value as 5 then TeX renders 5 em-dashes which is actually larger than 0.4".  In the figure below, the first indent is "asis" which is 0.4".  Then there is a cascade of 0, 1, 2, 3, 4, 5.  I propose setting the example indent to 2.  The value of 3 produces an indent which is already larger than the default which itself I consider too big.  Unfortunately, fractional values are not allowed.

We could also consider changing @paragraphindent for improved readability.


reply via email to

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