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

[Frank Küster]

Jens Seidel <jensseidel at users.sf.net> wrote:

> On Thu, Aug 11, 2005 at 01:05:52PM +0200, Frank Küster wrote:
>> 
>> 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.

The whole stuff is outdated and user-unfriendly.  It doesn't make much
sense to fix one or two lines - there's more wrong things in there than
just about the default driver.  I once downloaded the documentation
source to help Heiko with a rewrite, but I didn't get far.  And Heiko
says that he doesn't have enough time for hyperref, so the time he has
he rather spends on coding (and supporting users on de.comp.text.tex -
most don't read the docs, anyway).

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

I never used the -z option, but I don't know of a PS viewer that
supports links, either.  Maybe on MacOS.

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

Aha - this is why it worked with debiandoc2ps and ps2pdf, but not with
my own test document.

Okay, fine then.  Can you send me a patch that contains only the changes
you made because of this bug, not other changes from the same upload?
I'm planning to create backports of sarge packages for use with the
teTeX-3.0-for-sarge backports, and would like to keep as close to the
sarge state as possible.

TIA, Frank
-- 
Frank Küster
Inst. f. Biochemie der Univ. Zürich
Debian Developer