diff options
author | Karl Berry <karl@freefriends.org> | 2010-01-30 00:23:18 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2010-01-30 00:23:18 +0000 |
commit | a6eeaf899a64dcd37c685f4d6225be65e5577f79 (patch) | |
tree | 10d2e849f7c5f3e58cc50f528b55b1c6f63af375 /Master/texmf-dist/doc/generic/FAQ-en/faq-hyp+pdf.tex | |
parent | 5cf448717d5bd535646efd1290abb0237b239f41 (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.tex | 21 |
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 |