bug#14799: Request for building PDF manuals in A4 format

bug#14799: Request for building PDF manuals in A4 format

[Angelo Graziosi]

Could you add an option to build emacs.pdf etc. in A4 format and the 
PDFs open chapters on odd page?

For example, in the case of emacs.pdf I often use 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 -*-

address@hidden
address@hidden odd
  @setfilename ../../info/emacs
  @settitle GNU Emacs Manual


Ciao,
  Angelo.

bug#14799: Request for building PDF manuals in A4 format

[Lars Ingebrigtsen]

Angelo Graziosi <angelo.graziosi@alice.it> writes:

> Could you add an option to build emacs.pdf etc. in A4 format and the
> PDFs open chapters on odd page?
>
> For example, in the case of emacs.pdf I often use 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 -*-
>
> address@hidden
> address@hidden odd
>  @setfilename ../../info/emacs
>  @settitle GNU Emacs Manual

(I'm going through old bug reports that have unfortunately gotten no
responses yet.)

It seems like your patch was mangled during transportation -- could you
resend it if you still have it?

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

bug#14799: Request for building PDF manuals in A4 format

[Angelo Graziosi via Bug reports for GNU Emacs, the Swiss army knife of text editors]

I am afraid, but also retrieving the the mail from my archive, the patch is corrupted as you have described.

BTW this search has shown an issue with RMAIL on Windows build!

Let's see what developers think about it.

Thanks,
 Angelo.

bug#14799: Request for building PDF manuals in A4 format

[Lars Ingebrigtsen]

Angelo Graziosi <angelo.g0@libero.it> writes:

> I am afraid, but also retrieving the the mail from my archive, the
> patch is corrupted as you have described.

You don't have the change stored anywhere else?  

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

bug#14799: Request for building PDF manuals in A4 format

[Angelo Graziosi via Bug reports for GNU Emacs, the Swiss army knife of text editors]

[-- Attachment #1: Type: text/plain, Size: 630 bytes --]


> Il 29 settembre 2019 alle 14.12 Lars Ingebrigtsen ha scritto:
>
> You don't have the change stored anywhere else? 

We may be lucky...

Could it be this:

$ cat /media/angelo/cygxp-20140209/home/angelo/cygwinports/emacs/emacs-dev.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

?
I have attached it too!

[-- Attachment #2: Lars-emacs-dev.patch --]
[-- Type: text/x-patch, Size: 367 bytes --]

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
 

bug#14799: Request for building PDF manuals in A4 format

[Lars Ingebrigtsen]

Angelo Graziosi <angelo.g0@libero.it> writes:

> @@ -1,5 +1,7 @@
>  \input texinfo  @c -*- coding: utf-8 -*-
>
> +@afourpaper
> +@setchapternewpage odd
>  @setfilename ../../info/emacs
>  @settitle GNU Emacs Manual
>

Thanks; that was a simple enough patch.  :-)

But I don't think it's something we can apply in general -- the
officially printed Emacs manuals are on US paper sizes, and I don't
think that's going to change.

I had a look at somehow making a new Makefile target for A4 pages, but
it doesn't seem like texi2pdf takes paper size as a parameter either, so
all the texi files would need to have

@ifset A4
...
@endif

or something, and then a Makefile target could set that variable.  But
that seems like a lot of verbiage to add to the .texi files, so I don't
know...

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

bug#14799: Request for building PDF manuals in A4 format

[Robert Pluim]

>>>>> On Tue, 01 Oct 2019 14:22:53 +0200, Lars Ingebrigtsen <larsi@gnus.org> said:

    Lars> Angelo Graziosi <angelo.g0@libero.it> writes:
    >> @@ -1,5 +1,7 @@
    >> \input texinfo  @c -*- coding: utf-8 -*-
    >> 
    >> +@afourpaper
    >> +@setchapternewpage odd
    >> @setfilename ../../info/emacs
    >> @settitle GNU Emacs Manual
    >> 

    Lars> Thanks; that was a simple enough patch.  :-)

    Lars> But I don't think it's something we can apply in general -- the
    Lars> officially printed Emacs manuals are on US paper sizes, and I don't
    Lars> think that's going to change.

    Lars> I had a look at somehow making a new Makefile target for A4 pages, but
    Lars> it doesn't seem like texi2pdf takes paper size as a parameter either, so
    Lars> all the texi files would need to have

    Lars> @ifset A4
    Lars> ...
    Lars> @endif

    Lars> or something, and then a Makefile target could set that variable.  But
    Lars> that seems like a lot of verbiage to add to the .texi files, so I don't
    Lars> know...

Donʼt they all include emacs/docstyle.texi?

Robert

bug#14799: Request for building PDF manuals in A4 format

[Lars Ingebrigtsen]

Robert Pluim <rpluim@gmail.com> writes:

> Donʼt they all include emacs/docstyle.texi?

Yes, that's true.

So would it makes sense to include the @ifdef there?  Then people could
say "A4=t make emacs.pdf" (or whatever manual they want) to get an A4
manual.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

bug#14799: Request for building PDF manuals in A4 format

[Eli Zaretskii]

> From: Lars Ingebrigtsen <larsi@gnus.org>
> Date: Tue, 01 Oct 2019 14:22:53 +0200
> Cc: 14799@debbugs.gnu.org
> 
> > +@afourpaper
> > +@setchapternewpage odd
> >  @setfilename ../../info/emacs
> >  @settitle GNU Emacs Manual
> >
> 
> Thanks; that was a simple enough patch.  :-)
> 
> But I don't think it's something we can apply in general -- the
> officially printed Emacs manuals are on US paper sizes, and I don't
> think that's going to change.
> 
> I had a look at somehow making a new Makefile target for A4 pages, but
> it doesn't seem like texi2pdf takes paper size as a parameter either

Could you perhaps use the -t switch to texi2pdf?

bug#14799: Request for building PDF manuals in A4 format

[Lars Ingebrigtsen]

Eli Zaretskii <eliz@gnu.org> writes:

> Could you perhaps use the -t switch to texi2pdf?

I hoped we could get away with adding this functionality without adding
new Makefile targets.  So being able to say

PAGE_SIZE_A4=t make emacs.pdf

(or something) would allow skipping actually making new rules, I think?

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

bug#14799: Request for building PDF manuals in A4 format

[Eli Zaretskii]

> From: Lars Ingebrigtsen <larsi@gnus.org>
> Cc: angelo.g0@libero.it,  14799@debbugs.gnu.org
> Date: Wed, 02 Oct 2019 13:44:46 +0200
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
> > Could you perhaps use the -t switch to texi2pdf?
> 
> I hoped we could get away with adding this functionality without adding
> new Makefile targets.

Why is it a virtue to avoid new Makefile targets?

bug#14799: Request for building PDF manuals in A4 format

[Lars Ingebrigtsen]

Eli Zaretskii <eliz@gnu.org> writes:

> Why is it a virtue to avoid new Makefile targets?

It seems like a combinatorial explosion of rules.
bovine-a4-odd-page-open/bovine-letter-odd-page-open/bovine-a4-non-odd-page-open/bovine-letter-non-odd-page-open etc.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

bug#14799: Request for building PDF manuals in A4 format

[Eli Zaretskii]

> From: Lars Ingebrigtsen <larsi@gnus.org>
> Cc: angelo.g0@libero.it,  14799@debbugs.gnu.org
> Date: Thu, 03 Oct 2019 16:29:15 +0200
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
> > Why is it a virtue to avoid new Makefile targets?
> 
> It seems like a combinatorial explosion of rules.
> bovine-a4-odd-page-open/bovine-letter-odd-page-open/bovine-a4-non-odd-page-open/bovine-letter-non-odd-page-open etc.

Did anyone ask for all those additional options?

And you can always make the addition targets just set a value of a
Make variable, which will then be picked up by -t.

Anyway, just an idea.  If no one likes it, I'm okay.

bug#14799: Request for building PDF manuals in A4 format

[Lars Ingebrigtsen]

Eli Zaretskii <eliz@gnu.org> writes:

>> > Why is it a virtue to avoid new Makefile targets?
>> 
>> It seems like a combinatorial explosion of rules.
>> bovine-a4-odd-page-open/bovine-letter-odd-page-open/bovine-a4-non-odd-page-open/bovine-letter-non-odd-page-open
>> etc.
>
> Did anyone ask for all those additional options?

Yup.  The request was for A4 and odd page opens, which should be
independent options, I think...

> And you can always make the addition targets just set a value of a
> Make variable, which will then be picked up by -t.
>
> Anyway, just an idea.  If no one likes it, I'm okay.

And in any case, I had misunderstood the documentation -- I thought
@ifset was about environment variables, but they aren't.  They're about
flags, so you're right: The only way to inject the flags are via -t
switches.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

bug#14799: Request for building PDF manuals in A4 format

[Angelo Graziosi via Bug reports for GNU Emacs, the Swiss army knife of text editors]

> Il 1 ottobre 2019 alle 14.22 Lars Ingebrigtsen ha scritto:
> 
> But I don't think it's something we can apply in general -- the
> officially printed Emacs manuals are on US paper sizes, and I don't
> think that's going to change.


Really, in my OP, I asked for an option:

> Could you add an option to build emacs.pdf etc. in A4 format and the 
> PDFs open chapters on odd page?