Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm
Precedence: bulk
MIME-Version: 1.0
In-Reply-To: <36FD86DF-3BA9-4277-B587-38EC212BDDEB@kba.biglobe.ne.jp>
References: <22229.42616.86422.222557@lwm.klanderman.net>
	<DE24867B-712C-46A4-85B4-BDD290E91154@kba.biglobe.ne.jp>
	<87vb55leop.fsf@lwm.klanderman.net>
	<194AAF32-4EB5-412D-A200-27AE7832EF86@kba.biglobe.ne.jp>
	<87egbs7usn.fsf@lwm.klanderman.net>
	<1850B214-73A8-4373-A9AE-0C533702A6CD@kba.biglobe.ne.jp>
	<87si07lj6s.fsf@lwm.klanderman.net>
	<36FD86DF-3BA9-4277-B587-38EC212BDDEB@kba.biglobe.ne.jp>
Date: Fri, 4 Mar 2016 05:16:17 +0100
Message-ID: <CAHYJk3Tp0i4xFYrM0OsTNGE8vBEbFgPAaS9J9q6EpW7obSkq-Q@mail.gmail.com>
Subject: Re: zsh manual - missing bookmarks in pdf file?
From: Mikael Magnusson <mikachu@gmail.com>
To: "Jun T." <takimoto-j@kba.biglobe.ne.jp>
Cc: "zsh-workers@zsh.org" <zsh-workers@zsh.org>
Content-Type: text/plain; charset=UTF-8

On Fri, Mar 4, 2016 at 4:33 AM, Jun T. <takimoto-j@kba.biglobe.ne.jp> wrote:
>
> On 2016/03/03, at 23:39, Greg Klanderman <gak@klanderman.net> wrote:
>
>> Looking at the Makefile, maybe pdfetex vs texi2pdf?
>
> No, texi2pdf is just a simple wrapper script which calls
> 'texi2dvi --pdf', which in tern calls pdfetex.
>
>>>>>>> On March 3, 2016 Jun T <takimoto-j@kba.biglobe.ne.jp> wrote:
>>> I don't know how the US version was created.
>
> It seems zsh_us.pdf was created from zsh.dvi (so it is not
> surprising that it has no bookmarks).
>
> In order to create a US-sized PDF with bookmarks, we need to modify
> zsh.texi because a command @afourpaper is embedded in it and
> it seems there is no texinfo command to cancel it (or to change the
> paper size to US letter).
>
> The patch below removes the @afourpaper from zsh.texi, and
> add it by "-t @afourpaper" when A4 output is required.
>
> A few minor points to discuss:
> (1) A4 and US versions are named zsh_a4.pdf and zsh_us.pdf,
>     as in the download page. Other possibility is
>     zsh.a4.pdf and zsh.us.pdf (as intro.{a4,us}.pdf).
>     Also we can use zsh.pdf for A4 version.
> (2) 'make pdf' creates both zsh_a4.pdf and zsh_us.pdf.
>     Is it better to create just on of them by default?
> (3) zsh.dvi is for A4 paper, as before.
> (4) Is it really necessary to have both A4 and US?
>     Or just A4 is enough?

We could somehow use LC_PAPER to determine which to build, and allow
overriding/building both with a configure option?

-- 
Mikael Magnusson