summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html')
-rw-r--r--Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html19
1 files changed, 11 insertions, 8 deletions
diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html
index 79570cdffa0..de28ce75cc0 100644
--- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html
+++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html
@@ -4,26 +4,29 @@
<h3><i>Hyperref</i> and repeated page numbers</h3>
<p/>The <i>book</i> 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
-<i>hyperref</i> since there are pages which seem (to
-<i>hyperref</i>) to have the same page number. Fortunately, there are
+to lower-case roman. This is fine for human readers, but if
+<i>hyperref</i> has been misconfigured, the existence of pages have
+the same page number can cause problems. Fortunately, the
configuration options to make <i>hyperref</i> &ldquo;do the right
-thing&rdquo;.
+thing&rdquo; are (by default) set up to avoid problems.
<p/>The two options in question are:
<dl>
<dt><code>plainpages=false</code><dd> Make page anchors using the
formatted form of the page number. With this option,
<i>hyperref</i> writes different anchors for pages &lsquo;ii&rsquo; and &lsquo;2&rsquo;.
- (If the option is set &lsquo;<code>true</code>&rsquo; &mdash; the default &mdash;
- <i>hyperref</i> 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
+ <em>good thing</em>\dots)
+ If the option is set &lsquo;<code>true</code>&rsquo; <i>hyperref</i> writes page
+ anchors as the arabic form of the page number, rather than the
+ formatted form that gets printed; this is not usually appropriate.
<dt><code>pdfpagelabels</code><dd> Set PDF page labels; i.e.,
write the value of <code>\</code><code>thepage</code> to the PDF file so that
<i>Acrobat Reader</i> can display the page number as (say) &lsquo;ii (4
of 40)&rsquo; rather than simply &lsquo;4 of 40&rsquo;.
</dl>
The two should be used whenever page numbering is not just
-&lsquo;1<code>..</code>n&rsquo;; they may be used independently, but usually are not.
+&lsquo;1<code>..</code>n&rsquo;; they may be used independently, but
+usually are not.
<p/>The recipe isn&rsquo;t perfect: it relies on <code>\</code><code>thepage</code> being different
for every page in the document. A common problem arises when there is
an unnumbered title page, after which page numbers are reset: the