summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/hyperref/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-05-16 21:25:43 +0000
committerKarl Berry <karl@freefriends.org>2020-05-16 21:25:43 +0000
commit74dfa355b56ae4ff3cde96e2b636198c15bcf1fc (patch)
tree35a2f503b35fdc9ad269b3b610ddf9965a260ec1 /Master/texmf-dist/source/latex/hyperref/doc
parent74237231bc12e187c52de51818182997c2fb3158 (diff)
hyperref (16may20)
git-svn-id: svn://tug.org/texlive/trunk@55161 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/hyperref/doc')
-rw-r--r--Master/texmf-dist/source/latex/hyperref/doc/manual.tex66
1 files changed, 18 insertions, 48 deletions
diff --git a/Master/texmf-dist/source/latex/hyperref/doc/manual.tex b/Master/texmf-dist/source/latex/hyperref/doc/manual.tex
index 242388fef93..ded7aeb799a 100644
--- a/Master/texmf-dist/source/latex/hyperref/doc/manual.tex
+++ b/Master/texmf-dist/source/latex/hyperref/doc/manual.tex
@@ -177,7 +177,7 @@
}
\makeatother
\title{Hypertext marks in \hologo{LaTeX}: a manual for \xpackage{hyperref}}
-\date{\mydate}
+\date{2020-05-15 v7.00e}
\begin{document}
@@ -747,7 +747,7 @@ pdftrapped & name & empty & Sets the document information Trapped ent
pdfinfo & key value list & empty & Alternative interface for setting the
document information.\\
pdfview & name & XYZ & Sets the default PDF `view' for each link \\
-pdfstartpage & integer & 1 & Determines on which page the PDF file is opened. \\
+pdfstartpage & integer & 1 & Determines on which page the PDF file is opened. An empty value means, the entry is not set.\\
pdfstartview & name & Fit & Set the startup page view \\
pdfremotestartview & name & Fit & Set the startup page view of remote PDF files \\
pdfpagescrop & n n n n & & Sets the default PDF crop box for pages. This should be a set of four numbers \\
@@ -867,7 +867,7 @@ Fly & /Di /M & Changes are flown out or in (as specified by /M), in the dir
offscreen except when /Di is None. \\
Push & /Di & The old page slides off the screen while the new page slides in,
pushing the old page out in the direction
- specified by /Di. \\
+ specified by /Di. \\
Cover & /Di & The new page slides on to the screen in the direction specified
by /Di, covering the old page. \\
Uncover & /Di & The old page slides off the screen in the direction specified by
@@ -1245,7 +1245,7 @@ the page reference. First \ci{pageautorefname} is checked before
\ci{pagename}.
For instances where you want a reference to use the correct counter, but
-not to create a link, there are starred forms (these starred forms exist even if
+not to create a link, there are starred forms (these starred forms exist even if
hyperref has been loaded with \verb|implicit=false|):
\begin{cmdsyntax}
@@ -1678,7 +1678,7 @@ sequence error would arise.
\subsection{Customizing index style file with \textbackslash nohyperpage}
- Since version 2008/08/14 v6.78f.
+ Since version 2008/08/14~v6.78f.
@@ -2051,7 +2051,7 @@ sequence error would arise.
require the protection of some characters, e.g. unmatched
left or right parentheses need escaping or the escape
character itself (backslash).
- Since 2006/02/12 v6.75a the PS/PDF driver should do
+ Since 2006/02/12~v6.75a the PS/PDF driver should do
this automatically. However I assume a problem with
compatibility, especially regarding the form part where
larger amounts of JavaScript code can be present.
@@ -2979,50 +2979,20 @@ For equations the following might work:
\subsubsection{XeTeX}
Default for the encoding of bookmarks is `pdfencoding=auto'.
- That means the strings are always treated as unicode strings.
- Only if the string restricts to the printable ASCII set,
+ That means the strings are always treated as unicode strings.
+ Only if the string restricts to the printable ASCII set,
it is written as ASCII string. The reason is that the
\verb|\special| does not support PDFDocEncoding.
-
-
- XeTeX uses the program xdvipdfmx for PDF output generation.
- This program behaves a little different from dvipdfm, because
- of the supported Unicode characters. Strings for bookmarks
- or information entries can be output directly. The
- big chars (char code > 255) are written in UTF-8 and
- xdvipdfmx tries to convert them to UTF-16BE. However
- hyperref already provides PDF strings encoded in UTF-16BE,
- thus the result is a warning
-
- \verb"Failed to convert input string to UTF16..."
-
- The best way would be, if xdvipdfm could detect the
- byte order marker (\verb|\376\377|) and skips the conversion
- if that marker is present.
-
- For the time being I added the following to hyperref,
- when option `pdfencoding=auto' is set (default for XeTeX):
- The string is converted back to big characters thus that the
- string is written as UTF-8. But I am very unhappy with this
- solution. Main disadvantage:
- Two versions of \verb|\pdfstringdef| are needed:
-
- a) The string is converted back to big characters for
- the ``tainted key'' of xdvipdfmx (\verb|spc_pdfm.c: default_taintkeys|).
- The subset hyperref uses is /Title, /Author, /Subject,
- /Keywords, /Creator, /Producer, /T. Any changes of this
- set in xdvipdfmx cannot be detected by hyperref.
-
- b) Without conversion for the other strings , providing UTF16be
- directly. Examples: Prefix of page labels, some elements
- of formulars.
-
- Thus \textbf{each} application that uses \verb|\pdfstringdef| now must
- check, if it defines a string for some of the tained keys.
- If yes, then the call of \verb|\pdfstringdef| should be preceded
- by \verb|\csname HyPsd@XeTeXBigCharstrue\endcsname|.
- Example: package bookmark.
+ In older versions hyperref contained special conversion code from
+ UTF-16BE back to UTF-8 in a number of places for
+ xetex to avoid the xdvipdfmx warning
+
+ \verb"Failed to convert input string to UTF16..."
+
+ This is no longer needed with a current xdvipdfmx, so this code has
+ been removed. \verb|\csname HyPsd@XeTeXBigCharstrue\endcsname| should no
+ longer be used.
\section[Limitations]{Limitations%
@@ -3072,7 +3042,7 @@ For equations the following might work:
Therefore it is not clear in general which \verb|\footnotemark| references
which \verb|\footnotetext|. But that is necessary to implement hyperlinking.
Thus the implementation of hyperref does not support the optional
- argument of \verb|\footnotemark\verb| and \verb|\footnotetext|.
+ argument of \verb|\footnotemark| and \verb|\footnotetext|.
\section[Hints]{Hints%