GNU bug report logs - #14790
An issue building Emacs (trunk) manual

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 14790 in the body.
You can then email your comments to 14790 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Angelo Graziosi <angelo.graziosi <at> alice.it>
To: bug-emacs <bug-gnu-emacs <at> gnu.org>
Subject: An issue building Emacs (trunk) manual
Date: Thu, 04 Jul 2013 18:43:04 +0200

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.

Message #8 received at 14790 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Angelo Graziosi <angelo.graziosi <at> alice.it>
Cc: 14790 <at> debbugs.gnu.org
Subject: Re: bug#14790: An issue building Emacs (trunk) manual
Date: Thu, 04 Jul 2013 21:12:17 +0300

> Date: Thu, 04 Jul 2013 18:43:04 +0200
> From: Angelo Graziosi <angelo.graziosi <at> 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.

Message #11 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Angelo Graziosi <angelo.graziosi <at> alice.it>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: bug-emacs <bug-gnu-emacs <at> gnu.org>
Subject: Re: bug#14790: An issue building Emacs (trunk) manual
Date: Thu, 04 Jul 2013 22:06:03 +0200

Il 04/07/2013 20.12, Eli Zaretskii ha scritto:
>> Date: Thu, 04 Jul 2013 18:43:04 +0200
>> From: Angelo Graziosi <angelo.graziosi <at> 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

Message #14 received at 14790 <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: Angelo Graziosi <angelo.graziosi <at> alice.it>
Cc: Eli Zaretskii <eliz <at> gnu.org>, 14790 <at> debbugs.gnu.org
Subject: Re: bug#14790: An issue building Emacs (trunk) manual
Date: Thu, 04 Jul 2013 19:28:18 -0400

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.

Message #21 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Angelo Graziosi <angelo.graziosi <at> alice.it>
To: Glenn Morris <rgm <at> gnu.org>
Cc: bug-emacs <bug-gnu-emacs <at> gnu.org>
Subject: Re: bug#14790: An issue building Emacs (trunk) manual
Date: Fri, 05 Jul 2013 01:38:04 +0200

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

Message #24 received at 14790 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Angelo Graziosi <angelo.graziosi <at> alice.it>
Cc: rgm <at> gnu.org, 14790 <at> debbugs.gnu.org
Subject: Re: bug#14790: An issue building Emacs (trunk) manual
Date: Fri, 05 Jul 2013 09:34:45 +0300

> Date: Fri, 05 Jul 2013 01:38:04 +0200
> From: Angelo Graziosi <angelo.graziosi <at> alice.it>
> Cc: 14790 <at> 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.

Message #27 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Angelo Graziosi <angelo.graziosi <at> alice.it>
Cc: bug-gnu-emacs <at> gnu.org
Subject: Re: bug#14790: An issue building Emacs (trunk) manual
Date: Fri, 05 Jul 2013 14:15:08 +0300

> Date: Thu, 04 Jul 2013 22:06:03 +0200
> From: Angelo Graziosi <angelo.graziosi <at> alice.it>
> CC: bug-emacs <bug-gnu-emacs <at> 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.

Message #30 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Angelo Graziosi <angelo.graziosi <at> alice.it>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: bug-gnu-emacs <at> gnu.org
Subject: Re: bug#14790: An issue building Emacs (trunk) manual
Date: Fri, 05 Jul 2013 13:40:56 +0200

Il 05/07/2013 13.15, Eli Zaretskii ha scritto:
>> Date: Thu, 04 Jul 2013 22:06:03 +0200
>> From: Angelo Graziosi <angelo.graziosi <at> alice.it>
>> CC: bug-emacs <bug-gnu-emacs <at> 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.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.