bug#14790: An issue building Emacs (trunk) manual

bug#14790: An issue building Emacs (trunk) manual

[Angelo Graziosi]

Usually I build Emacs PDF manual applying this patch:

diff -Naur emacs.orig/doc/emacs/emacs.texi emacs/doc/emacs/emacs.texi
--- emacs.orig/doc/emacs/emacs.texi	2012-01-15 18:59:57.942500000 +0100
+++ emacs/doc/emacs/emacs.texi	2012-02-05 21:32:51.656250000 +0100
@@ -1,5 +1,7 @@
  \input texinfo  @c -*- coding: utf-8 -*-

+@afourpaper
+@setchapternewpage odd
  @setfilename ../../info/emacs
  @settitle GNU Emacs Manual

it generates the PDF in A4 format and opens chapters on odd page.

Now, say after r. 113247 (a few days ago), building the PDF produces 
some "harmless" errors (the PDF is created) which one doesn't like to see:

$ make emacs.pdf 2>&1 | tee ~/work/emacs_pdf_a4.log

$ grep -i error ~/work/emacs_pdf_a4.log
@textrm (@texttt compilation-next-error[]@textrm ) and @texttt M-p[] 
@textrm (@
texttt compilation-previous-error[]@textrm ) to move to
@textrm (@texttt compilation-next-error[]@textrm ) and @texttt M-p[] 
@textrm (@
texttt compilation-previous-error[]@textrm ) to move to
@textrm (@texttt compilation-next-error[]@textrm ) and @texttt M-p[] 
@textrm (@
texttt compilation-previous-error[]@textrm ) to move to
@textrm (@texttt compilation-next-error[]@textrm ) and @texttt M-p[] 
@textrm (@
texttt compilation-previous-error[]@textrm ) to move to

Instead without the patch, no error is catched:

$ make emacs.pdf 2>&1 | tee ~/work/emacs_pdf_us.log

$ grep -i error ~/work/emacs_pdf_us.log
EMPTY

Could this be related to the recent changes introduced with rev. 113268? 
(different doc/*.texi files were changed...)

Could you add an option to build emacs.pdf in A4 format etc.?


TIA,
  Angelo.

bug#14790: An issue building Emacs (trunk) manual

[Eli Zaretskii]

> Date: Thu, 04 Jul 2013 18:43:04 +0200
> From: Angelo Graziosi <angelo.graziosi@alice.it>
> 
> Now, say after r. 113247 (a few days ago), building the PDF produces 
> some "harmless" errors (the PDF is created) which one doesn't like to see:
> 
> $ make emacs.pdf 2>&1 | tee ~/work/emacs_pdf_a4.log
> 
> $ grep -i error ~/work/emacs_pdf_a4.log
> @textrm (@texttt compilation-next-error[]@textrm ) and @texttt M-p[] 
> @textrm (@
> texttt compilation-previous-error[]@textrm ) to move to
> @textrm (@texttt compilation-next-error[]@textrm ) and @texttt M-p[] 
> @textrm (@
> texttt compilation-previous-error[]@textrm ) to move to
> @textrm (@texttt compilation-next-error[]@textrm ) and @texttt M-p[] 
> @textrm (@
> texttt compilation-previous-error[]@textrm ) to move to
> @textrm (@texttt compilation-next-error[]@textrm ) and @texttt M-p[] 
> @textrm (@
> texttt compilation-previous-error[]@textrm ) to move to

Please show the full error messages.  They identify the source lines
and also give additional information about the problems.

bug#14790: An issue building Emacs (trunk) manual

[Angelo Graziosi]

Il 04/07/2013 20.12, Eli Zaretskii ha scritto:
>> Date: Thu, 04 Jul 2013 18:43:04 +0200
>> From: Angelo Graziosi <angelo.graziosi@alice.it>
>>
>> Now, say after r. 113247 (a few days ago), building the PDF produces
>> some "harmless" errors (the PDF is created) which one doesn't like to see:
>>
>> $ make emacs.pdf 2>&1 | tee ~/work/emacs_pdf_a4.log
>>
>> $ grep -i error ~/work/emacs_pdf_a4.log
>> @textrm (@texttt compilation-next-error[]@textrm ) and @texttt M-p[]
>> @textrm (@
>> texttt compilation-previous-error[]@textrm ) to move to
>> @textrm (@texttt compilation-next-error[]@textrm ) and @texttt M-p[]
>> @textrm (@
>> texttt compilation-previous-error[]@textrm ) to move to
>> @textrm (@texttt compilation-next-error[]@textrm ) and @texttt M-p[]
>> @textrm (@
>> texttt compilation-previous-error[]@textrm ) to move to
>> @textrm (@texttt compilation-next-error[]@textrm ) and @texttt M-p[]
>> @textrm (@
>> texttt compilation-previous-error[]@textrm ) to move to
>
> Please show the full error messages.  They identify the source lines
> and also give additional information about the problems.
>

Oops... right.. Here they are:

[...]
iso[]@textrm , @texttt M-x iso-iso2gtex[] @textrm and @texttt M-x
[212] [213] [214] [215] [216] [217] [218] [219] [220] [221])
(/work/emacs/doc/emacs/programs.texi Chapter 23 [222] [223]
[224]
Underfull \hbox (badness 10000) in paragraph at lines 328--336
[]@textrm To ei-ther en-able or dis-able Which Func-tion mode, use the 
com-mand
  @texttt M-x
[225] [226] [227] [228] [229] [230] [231] [232] [233] [234] [235] [236]
[237] [238] [239]) (/work/emacs/doc/emacs/building.texi Chapter 24
[240] [241] [242]
Underfull \hbox (badness 10000) in paragraph at lines 243--248
[]@textrm To parse mes-sages from the com-piler, Com-pi-la-tion mode 
uses the v
ari-able

Underfull \hbox (badness 10000) in paragraph at lines 253--259
@textrm (@texttt compilation-next-error[]@textrm ) and @texttt M-p[] 
@textrm (@
texttt compilation-previous-error[]@textrm ) to move to
[243] [244]

Underfull \hbox (badness 10000) in paragraph at lines 432--437
@textrm To dis-play any er-ror mes-sages as-so-ci-ated with the cur-rent 
line,
type @texttt M-x
[245] [246] [247] [248] [249] [250] [251] [252]
Underfull \hbox (badness 10000) in paragraph at lines 1200--1204
[]@textrm If the vari-able @texttt gdb-use-colon-colon-notation[] 
@textrm is no
[...]

the other are a repetition of these.

As you see, they aren't fatal error but until a few day ago they didn't 
appear and, as I wrote, they appear only with my patch for A4+open 
chapter on odd pages.

Ciao
Angelo

bug#14790: An issue building Emacs (trunk) manual

[Glenn Morris]

Angelo Graziosi wrote:

> Underfull \hbox (badness 10000) in paragraph at lines 328--336

This is not a bug. We address issues related to line breaks just before
the release. It is pointless to work on them before, because they change
all the time. And when we do, the manual is typeset for printing as a
book by the FSF on small paper size. In my experience, it is impossible
to make line-breaks look nice on more than one paper size for a 500+
page manual, and pointless to even try. So I for one am not going to
spend any time on this.

bug#14790: An issue building Emacs (trunk) manual

[Angelo Graziosi]

Il 05/07/2013 1.28, Glenn Morris ha scritto:
> Angelo Graziosi wrote:
>
>> Underfull \hbox (badness 10000) in paragraph at lines 328--336
>
> This is not a bug. We address issues related to line breaks just before
> the release. It is pointless to work on them before, because they change
> all the time. And when we do, the manual is typeset for printing as a
> book by the FSF on small paper size. In my experience, it is impossible
> to make line-breaks look nice on more than one paper size for a 500+
> page manual, and pointless to even try. So I for one am not going to
> spend any time on this.
>

My post didn't regard that... but another message.. anyway..

  angelo

bug#14790: An issue building Emacs (trunk) manual

[Eli Zaretskii]

> Date: Fri, 05 Jul 2013 01:38:04 +0200
> From: Angelo Graziosi <angelo.graziosi@alice.it>
> Cc: 14790@debbugs.gnu.org
> 
> My post didn't regard that... but another message.. anyway..

If you mean your request for an option for building on A4 paper, then
I guess it would be better to file a separate bug report.

bug#14790: An issue building Emacs (trunk) manual

[Eli Zaretskii]

> Date: Thu, 04 Jul 2013 22:06:03 +0200
> From: Angelo Graziosi <angelo.graziosi@alice.it>
> CC: bug-emacs <bug-gnu-emacs@gnu.org>
> 
> Underfull \hbox (badness 10000) in paragraph at lines 328--336
> []@textrm To ei-ther en-able or dis-able Which Func-tion mode, use the 
> com-mand
>   @texttt M-x
> [225] [226] [227] [228] [229] [230] [231] [232] [233] [234] [235] [236]
> [237] [238] [239]) (/work/emacs/doc/emacs/building.texi Chapter 24
> [240] [241] [242]
> Underfull \hbox (badness 10000) in paragraph at lines 243--248
> []@textrm To parse mes-sages from the com-piler, Com-pi-la-tion mode 
> uses the v
> ari-able

"Underfull \hbox" means that there's too few characters to typeset a
line of text without making it ugly.  TeX tries to fill lines, but
when the Texinfo sources requests a fixed-width typeface, such as with
names of variables and functions, it cannot do that.

The solution is to rearrange text around the problematic part.  I
agree with Glenn that doing this now is a waste of effort.

Bottom line: ignore those errors.  ("Overfull boxes", OTOH, are more
serious.)

> As you see, they aren't fatal error but until a few day ago they didn't 
> appear and, as I wrote, they appear only with my patch for A4+open 
> chapter on odd pages.

As the Texinfo sources change, these issues can appear and disappear.
It's normal.  Likewise, they can appear with one paper size and not
the other.

bug#14790: An issue building Emacs (trunk) manual

[Angelo Graziosi]

Il 05/07/2013 13.15, Eli Zaretskii ha scritto:
>> Date: Thu, 04 Jul 2013 22:06:03 +0200
>> From: Angelo Graziosi <angelo.graziosi@alice.it>
>> CC: bug-emacs <bug-gnu-emacs@gnu.org>
>>
>> Underfull \hbox (badness 10000) in paragraph at lines 328--336
>> []@textrm To ei-ther en-able or dis-able Which Func-tion mode, use the
>> com-mand
>>    @texttt M-x
>> [225] [226] [227] [228] [229] [230] [231] [232] [233] [234] [235] [236]
>> [237] [238] [239]) (/work/emacs/doc/emacs/building.texi Chapter 24
>> [240] [241] [242]
>> Underfull \hbox (badness 10000) in paragraph at lines 243--248
>> []@textrm To parse mes-sages from the com-piler, Com-pi-la-tion mode
>> uses the v
>> ari-able
>

Eli,
> "Underfull \hbox" means that there's too few characters to typeset a


I know what "Underfull \hbox" means (almost every LaTeX document 
produces that), my observations were for the other "error" messages 
(those catched by grep) that until rev. 113247 didn't appear..

Anyway, no problems. As I wrote, they aren't "fatal"...


Ciao,
  Angelo.