Bug#321942: [debiandoc-sgml-pkgs] Bug#321942: Coordinating upload of teTeX-3.0 to unstable

[Jens Seidel]

On Thu, Aug 11, 2005 at 01:05:52PM +0200, Frank Küster wrote:
> Jens Seidel <jensseidel at users.sf.net> wrote:
> > On Wed, Aug 10, 2005 at 08:17:52PM +0200, Frank Küster wrote:
> >> Frank Küster <frank at kuesterei.ch> wrote:
> >> Instead I suggest
> >
> > I can only guess that you mean (I noticed that already in your last
> > mail!)
> 
> Excuse me.

No problem.

> > \usepackage{ifpdf}
> > \ifpdf
> > \usepackage[colorlinks=true]{hyperref}
> > \else
> > \usepackage[hypertex]{hyperref}
> > \fi

OK. I will use this.

> > You assume that hyperref detects pdf mode and enables the pdftex option
> > by default, right? But please note that the documentation
> > (manual.pdf.gz, section 5.3) of hyperref contains that without specified
> > driver option "hypertex" is used.
> 
> The documentation of hyperref is notoriously outdated with respect to
> the package.  In fact it chooses "pdftex" for pdflatex in PDF mode, and
> the "default" driver for DVI mode.  However, it wasn't hyperref's
> author, but Thomas Esser from teTeX who changed the default from
> hypertex to dvips.

I strongly suggest to update the documentation as well. Is it not
possible for you to add at least a patch to the Debian package?
Fixing one or two lines in manual.pdf would avoid a lot of trouble.

> hypertex is useful for DVI files, dvips for PDF files created via
> latex;dvips;distiller/ps2pdf.

The main goal of debiandoc2latexdvi is to produce DVI files for xdvi
(and hyphen_show from package hyphen-show), debiandoc2latexps
creates printable PS files (these should never converted to PDF) and
debiandoc2latexpdf creates ordinary PDF files.

All these scripts use debiandoc2latex to create the .tex file which would
be perfect for dvi and pdf.
Most likely I will change the dvips call to use option -z which creates
valid external links and breaks the lines after applying ps2pdf (which I
still not recommend, but users may call it).

The dvips option is useless without convertion to PDF using ps2pdf,
right? There is no Postscript viewer which supports links?

> I think you should first decide whether you want to always go the
> pdfLaTeX way when you produce PDF files, or whether there is some reason

Yes, always.

> to stick to latex;dvips;ps2pdf.  There is only one reason I can think
> 
> If you have decided that you will create DVI files only for producing PS
> files for printout, not for further processing to PDF, then things are

Yes and for xdvi.

> easy.
> If you ensist on using latex and dvips to produce PDF files, then you
> have to either live with non-broken links (with dvips) or non-working
> links (with hypertex; it seems that the URL links magically do work,
> only the internal links not, in tex files produced by debiandoc-sgml,
> although not in a small example document).

Even using dvi->ps->pdf dvips with option -z enables working links.

dvips option of hyperref is not compatible with a Japanese \chaptername
(I redefined this in combination with using the cjk-latex package):
! Improper alphabetic constant.
<to be read again> 
                   \count 
l.145 \chapter{€Ï€ž€á€Ë}

So will definitively not use dvips option but hypertex.

> - For DVI mode, this would (because of the change in teTeX) choose dvips,
>   which has the effect that links are not broken over the line (because
>   dvips---or even PS---doesn't support this).  This is ugly (and the
>   cause of that old bug #29xxxx).  

Another reason not to use dvips option.

>   Using [hypertex] for DVI output results in line breaking in URL links,
>   I have checked this.  Internal links will not work (because dvips
>   doesn't understand the instructions from the hypertex driver), but

Except using option -z (tested only with external links) and of course
in xdvi.

>   that does not matter if you want to create only PS files for

Right.

>   printout.  Internal links will still not be broken -- this can be
>   changed with the breaklinks option.
> 
> > I checked the DDP and noticed that only counting-potatoes and refcard
> > use ps2pdf.
> 
> We could file bugs against those, requesting them to use
> debiandoc2latexpdf directly.

OK, I will do so.

Jens