diff options
author | Karl Berry <karl@freefriends.org> | 2020-05-16 21:25:43 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2020-05-16 21:25:43 +0000 |
commit | 74dfa355b56ae4ff3cde96e2b636198c15bcf1fc (patch) | |
tree | 35a2f503b35fdc9ad269b3b610ddf9965a260ec1 /Master/texmf-dist/source/latex/hyperref/doc | |
parent | 74237231bc12e187c52de51818182997c2fb3158 (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.tex | 66 |
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% |