all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* bug#14790: An issue building Emacs (trunk) manual
@ 2013-07-04 16:43 Angelo Graziosi
  2013-07-04 18:12 ` Eli Zaretskii
  0 siblings, 1 reply; 8+ messages in thread
From: Angelo Graziosi @ 2013-07-04 16:43 UTC (permalink / raw)
  To: 14790

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.





^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#14790: An issue building Emacs (trunk) manual
  2013-07-04 16:43 bug#14790: An issue building Emacs (trunk) manual Angelo Graziosi
@ 2013-07-04 18:12 ` Eli Zaretskii
  2013-07-04 20:06   ` Angelo Graziosi
  0 siblings, 1 reply; 8+ messages in thread
From: Eli Zaretskii @ 2013-07-04 18:12 UTC (permalink / raw)
  To: Angelo Graziosi; +Cc: 14790

> 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.





^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#14790: An issue building Emacs (trunk) manual
  2013-07-04 18:12 ` Eli Zaretskii
@ 2013-07-04 20:06   ` Angelo Graziosi
  2013-07-04 23:28     ` Glenn Morris
  2013-07-05 11:15     ` Eli Zaretskii
  0 siblings, 2 replies; 8+ messages in thread
From: Angelo Graziosi @ 2013-07-04 20:06 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 14790

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





^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#14790: An issue building Emacs (trunk) manual
  2013-07-04 20:06   ` Angelo Graziosi
@ 2013-07-04 23:28     ` Glenn Morris
  2013-07-04 23:38       ` Angelo Graziosi
  2013-07-05 11:15     ` Eli Zaretskii
  1 sibling, 1 reply; 8+ messages in thread
From: Glenn Morris @ 2013-07-04 23:28 UTC (permalink / raw)
  To: Angelo Graziosi; +Cc: 14790

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.





^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#14790: An issue building Emacs (trunk) manual
  2013-07-04 23:28     ` Glenn Morris
@ 2013-07-04 23:38       ` Angelo Graziosi
  2013-07-05  6:34         ` Eli Zaretskii
  0 siblings, 1 reply; 8+ messages in thread
From: Angelo Graziosi @ 2013-07-04 23:38 UTC (permalink / raw)
  To: Glenn Morris; +Cc: 14790

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





^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#14790: An issue building Emacs (trunk) manual
  2013-07-04 23:38       ` Angelo Graziosi
@ 2013-07-05  6:34         ` Eli Zaretskii
  0 siblings, 0 replies; 8+ messages in thread
From: Eli Zaretskii @ 2013-07-05  6:34 UTC (permalink / raw)
  To: Angelo Graziosi; +Cc: 14790

> 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.





^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#14790: An issue building Emacs (trunk) manual
  2013-07-04 20:06   ` Angelo Graziosi
  2013-07-04 23:28     ` Glenn Morris
@ 2013-07-05 11:15     ` Eli Zaretskii
  2013-07-05 11:40       ` Angelo Graziosi
  1 sibling, 1 reply; 8+ messages in thread
From: Eli Zaretskii @ 2013-07-05 11:15 UTC (permalink / raw)
  To: Angelo Graziosi; +Cc: 14790

> 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.





^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#14790: An issue building Emacs (trunk) manual
  2013-07-05 11:15     ` Eli Zaretskii
@ 2013-07-05 11:40       ` Angelo Graziosi
  0 siblings, 0 replies; 8+ messages in thread
From: Angelo Graziosi @ 2013-07-05 11:40 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 14790

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.





^ permalink raw reply	[flat|nested] 8+ messages in thread

end of thread, other threads:[~2013-07-05 11:40 UTC | newest]

Thread overview: 8+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2013-07-04 16:43 bug#14790: An issue building Emacs (trunk) manual Angelo Graziosi
2013-07-04 18:12 ` Eli Zaretskii
2013-07-04 20:06   ` Angelo Graziosi
2013-07-04 23:28     ` Glenn Morris
2013-07-04 23:38       ` Angelo Graziosi
2013-07-05  6:34         ` Eli Zaretskii
2013-07-05 11:15     ` Eli Zaretskii
2013-07-05 11:40       ` Angelo Graziosi

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.