summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/faq-hyp+pdf.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-01-30 00:23:18 +0000
committerKarl Berry <karl@freefriends.org>2010-01-30 00:23:18 +0000
commita6eeaf899a64dcd37c685f4d6225be65e5577f79 (patch)
tree10d2e849f7c5f3e58cc50f528b55b1c6f63af375 /Master/texmf-dist/doc/generic/FAQ-en/faq-hyp+pdf.tex
parent5cf448717d5bd535646efd1290abb0237b239f41 (diff)
FAQ_en 3.19c (29jan10)
git-svn-id: svn://tug.org/texlive/trunk@16865 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/FAQ-en/faq-hyp+pdf.tex')
-rw-r--r--Master/texmf-dist/doc/generic/FAQ-en/faq-hyp+pdf.tex21
1 files changed, 12 insertions, 9 deletions
diff --git a/Master/texmf-dist/doc/generic/FAQ-en/faq-hyp+pdf.tex b/Master/texmf-dist/doc/generic/FAQ-en/faq-hyp+pdf.tex
index 018157e04bf..398cb0883be 100644
--- a/Master/texmf-dist/doc/generic/FAQ-en/faq-hyp+pdf.tex
+++ b/Master/texmf-dist/doc/generic/FAQ-en/faq-hyp+pdf.tex
@@ -1,4 +1,4 @@
-% $Id: faq-hyp+pdf.tex,v 1.1 2009/06/13 20:56:41 rf10 Exp rf10 $
+% $Id: faq-hyp+pdf.tex,v 1.2 2009/11/21 14:13:02 rf10 Exp $
\section{Hypertext and \acro{PDF}}
@@ -497,27 +497,30 @@ in the file with Type~1 versions.
The \Class{book} class (and its friends and relations) automatically
changes the display of page numbers in the frontmatter of the document
-to lower-case roman. This is fine for human readers, but it confuses
-\Package{hyperref} since there are pages which seem (to
-\Package{hyperref}) to have the same page number. Fortunately, there are
+to lower-case roman. This is fine for human readers, but if
+\Package{hyperref} has been misconfigured, the existence of pages have
+the same page number can cause problems. Fortunately, the
configuration options to make \Package{hyperref} ``do the right
-thing''.
+thing'' are (by default) set up to avoid problems.
The two options in question are:
\begin{description}
\item[\pkgoption{plainpages=false}] Make page anchors using the
formatted form of the page number. With this option,
\Package{hyperref} writes different anchors for pages `ii' and `2'.
- (If the option is set `\texttt{true}'~--- the default~---
- \Package{hyperref} writes page anchors as the arabic form of the
- absolute page number, rather than the formatted form.)
+ (This is the default value for the option, which is a % ! line break
+ \emph{good thing}\dots)
+ If the option is set `\texttt{true}' \Package{hyperref} writes page
+ anchors as the arabic form of the page number, rather than the
+ formatted form that gets printed; this is not usually appropriate.
\item[\pkgoption{pdfpagelabels}] Set \acro{PDF} page labels; i.e.,
write the value of \csx{thepage} to the \acro{PDF} file so that
\Package{Acrobat Reader} can display the page number as (say) `ii (4
of 40)' rather than simply `4 of 40'.
\end{description}
The two should be used whenever page numbering is not just
-`1\texttt{..}\ensuremath{n}'; they may be used independently, but usually are not.
+`1\texttt{..}\ensuremath{n}'; they may be used independently, but
+usually are not.
The recipe isn't perfect: it relies on \csx{thepage} being different
for every page in the document. A common problem arises when there is