hyperref: bug in pagebackref option?

[Gabriel Zachmann]

Consider the following minimal example:

--- pagebackref bug?
\documentclass{book}
% variant 1, works
%\usepackage[colorlinks=true,pagebackref,dvipdfm]{hyperref}
% variant 2, does not work
\usepackage[dvipdfm]{hyperref}
\hypersetup{colorlinks=true,pagebackref}
\begin{document}
\cite{Brooks99}. \cite{McNeely:1999:SDH}
industries \cite{Zach99}.
\bibliographystyle{alpha}
\bibliography{cg}
\end{document}
--- pagebackref bug?

As indicated in the comments, variant 1 of the pagebackref option usage
works, variant 2 does not, i.e., there are no back references in the
bibliography.

I just browsed the documentation of hyperref, and I think there is no
mentioning of this "feature".

It took me a while to track this down ...

So I think this is either a bug in hyperref.sty of in its documentation.

HTH,
Gab.

PS:
Here is the ouput of the latex run, showing variant 2 (which didn't work):

This is TeX, Version 3.14159 (Web2C 7.3.1)
(q.tex
LaTeX2e <1999/12/01> patch level 1
Babel <v3.6Z> and hyphenation patterns for american, french, german,
ngerman, n
ohyphenation, loaded.
(/igd/a4/software/teTeX-1.0.7/share/texmf/tex/latex/base/book.cls
Document Class: book 1999/09/10 v1.4a Standard LaTeX document class
(/igd/a4/software/teTeX-1.0.7/share/texmf/tex/latex/base/bk10.clo))
(/igd/a4/software/teTeX-1.0.7/share/texmf/tex/latex/hyperref/hyperref.sty
(/igd/a4/software/teTeX-1.0.7/share/texmf/tex/latex/graphics/keyval.sty)
(/igd/a4/software/teTeX-1.0.7/share/texmf/tex/latex/hyperref/pd1enc.def)
Implicit mode ON; LaTeX internals redefined
(/igd/a4/software/teTeX-1.0.7/share/texmf/tex/latex/misc/url.sty))
*hyperref using driver hdvipdfm*
(/igd/a4/software/teTeX-1.0.7/share/texmf/tex/latex/hyperref/hdvipdfm.def)

Package hyperref Warning: Option `pagebackref' has already been used,
(hyperref) setting the option has no effect on input line 9.

(q.aux)
(/igd/a4/software/teTeX-1.0.7/share/texmf/tex/latex/graphics/color.sty
(/igd/a4/software/teTeX-1.0.7/share/texmf/tex/latex/config/color.cfg)
(/igd/a4/software/teTeX-1.0.7/share/texmf/tex/latex/graphics/dvips.def)
(/igd/a4/software/teTeX-1.0.7/share/texmf/tex/latex/graphics/dvipsnam.def))
(/igd/a4/software/teTeX-1.0.7/share/texmf/tex/latex/hyperref/nameref.sty)
(q.out) (q.out)
[...]

Yes, I know there is a "warning" in the output,
but how should I have known what caused it?

--
/---------------------------------------------------------------------\
| Where is the wisdom we have lost in knowledge? |
| Where is the knowledge that we have lost in information? |
| (T.S. Eliot, The Rock (1934) pt.1) |
| |
| za...@igd.fhg.de g...@gab.cx Gabriel....@gmx.net |
| www.igd.fhg.de/~zach/ www.gab.cx __@/' |
\---------------------------------------------------------------------/

[Heiko Oberdiek]

On 24 Jan 2001 20:42:12 GMT, za...@igd.fhg.de (Gabriel Zachmann) wrote:

>--- pagebackref bug?
>\documentclass{book}
>% variant 1, works
>%\usepackage[colorlinks=true,pagebackref,dvipdfm]{hyperref}
>% variant 2, does not work
>\usepackage[dvipdfm]{hyperref}
>\hypersetup{colorlinks=true,pagebackref}
>\begin{document}
>\cite{Brooks99}. \cite{McNeely:1999:SDH}
>industries \cite{Zach99}.
>\bibliographystyle{alpha}
>\bibliography{cg}
>\end{document}
>--- pagebackref bug?

No, look at the Warning:

>Package hyperref Warning: Option `pagebackref' has already been used,
>(hyperref) setting the option has no effect on input line 9.

And look at your variants and compare, the setting of pagebackref
in the second variant is too late. hyperref loads package
backref and have to know the options for this package.
After hyperref and backref are loaded it is too late for
options.

Yours sincerely
Heiko <ober...@ruf.uni-freiburg.de>