From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 10465 invoked by alias); 4 Mar 2016 03:33:58 -0000 Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm Precedence: bulk X-No-Archive: yes List-Id: Zsh Workers List List-Post: List-Help: X-Seq: 38087 Received: (qmail 10790 invoked from network); 4 Mar 2016 03:33:56 -0000 X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on f.primenet.com.au X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=ham autolearn_force=no version=3.4.1 X-Biglobe-Sender: Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Mac OS X Mail 6.6 \(1510\)) Subject: Re: zsh manual - missing bookmarks in pdf file? From: "Jun T." In-Reply-To: <87si07lj6s.fsf@lwm.klanderman.net> Date: Fri, 4 Mar 2016 12:33:18 +0900 Content-Transfer-Encoding: 7bit Message-Id: <36FD86DF-3BA9-4277-B587-38EC212BDDEB@kba.biglobe.ne.jp> References: <22229.42616.86422.222557@lwm.klanderman.net> <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> To: "zsh-workers@zsh.org" X-Mailer: Apple Mail (2.1510) X-Biglobe-Spnum: 49580 On 2016/03/03, at 23:39, Greg Klanderman 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 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? diff --git a/Doc/Makefile.in b/Doc/Makefile.in index d589991..e61777b 100644 --- a/Doc/Makefile.in +++ b/Doc/Makefile.in @@ -93,16 +93,24 @@ dvi: zsh.dvi .PHONY: dvi zsh.dvi: $(sdir)/zsh.texi - $(TEXI2DVI) $(sdir)/zsh.texi + $(TEXI2DVI) -t '@afourpaper' $(sdir)/zsh.texi -pdf: zsh.pdf intro.a4.pdf intro.us.pdf +pdf: zsh_a4.pdf zsh_us.pdf intro.a4.pdf intro.us.pdf .PHONY: pdf -zsh.pdf: $(sdir)/zsh.texi +zsh_a4.pdf: $(sdir)/zsh.texi if [ x$(TEXI2PDF) != x ]; then \ - $(TEXI2PDF) $(sdir)/zsh.texi; \ + $(TEXI2PDF) -t '@afourpaper' -o $@ $(sdir)/zsh.texi; \ else \ - PDFTEX=$(PDFETEX) $(TEXI2DVI) --pdf $(sdir)/zsh.texi; \ + PDFTEX=$(PDFETEX) \ + $(TEXI2DVI) --pdf -t '@afourpaper' -o $@ $(sdir)/zsh.texi; \ + fi + +zsh_us.pdf: $(sdir)/zsh.texi + if [ x$(TEXI2PDF) != x ]; then \ + $(TEXI2PDF) -o $@ $(sdir)/zsh.texi; \ + else \ + PDFTEX=$(PDFETEX) $(TEXI2DVI) --pdf -o $@ $(sdir)/zsh.texi; \ fi # Use roff2ps / ps2pdf because pdfroff produces doubled output. diff --git a/Doc/ztexi.yo b/Doc/ztexi.yo index e878345..7d52e6e 100644 --- a/Doc/ztexi.yo +++ b/Doc/ztexi.yo @@ -53,7 +53,6 @@ def(texinfo)(2)(\ NOTRANS(\input texinfo.tex)+NL()\ NOTRANS(@c %**start of header)+NL()\ NOTRANS(@iftex)+NL()\ - NOTRANS(@afourpaper)+NL()\ NOTRANS(@setchapternewpage off)+NL()\ NOTRANS(@end iftex)+NL()\ NOTRANS(@setfilename )ARG1+NL()\