hyperref update (11sep10)

git-svn-id: svn://tug.org/texlive/trunk@19658 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 21 insertions, 5 deletions

diff --git a/Master/texmf-dist/source/latex/hyperref/doc/manual.tex b/Master/texmf-dist/source/latex/hyperref/doc/manual.tex
index b758085e2f4..956606fcf4f 100644
--- a/Master/texmf-dist/source/latex/hyperref/doc/manual.tex
+++ b/Master/texmf-dist/source/latex/hyperref/doc/manual.tex
@@ -14,7 +14,7 @@
 % * Heiko Oberdiek, 2006-2010.
 %
 
-\def\mydate{January 2010}
+\def\mydate{September 2010}
 
 \RequirePackage{ifpdf}
 \ifpdf % We are running pdfTeX in pdf mode
@@ -517,6 +517,7 @@ pdfinfo            & key value list & empty & Alternative interface for setting
 pdfview            & text    & XYZ   & Sets the default PDF `view' for each link \\
 pdfstartpage       & text    & 1     & Determines on which page the PDF file is opened. \\
 pdfstartview       & text    & Fit   & Set the startup page view \\
+pdfremotestartview & text    & 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 \\
 pdfcenterwindow    & boolean & false & position the document window in the center of the screen \\
 pdfdirection       & text    & empty & direction setting \\
@@ -561,8 +562,8 @@ works by supplying default values for \texttt{XYZ} (horizontal $\times$
 vertical $\times$ zoom) and \texttt{FitBH}. However, drivers using
 \texttt{pdfmark} do not supply defaults, so \textsf{hyperref} passes in
 a value of -32768, which causes Acrobat to set (usually) sensible
-defaults. The following are possible values for the \texttt{pdfview} and
-\texttt{pdfstartview} parameters.
+defaults. The following are possible values for the \texttt{pdfview},
+\texttt{pdfstartview} and \texttt{pdfremotestartview} parameters.
 
 \noindent\begin{longtable}{>{\ttfamily}l>{\itshape}lp{7cm}}
 XYZ   & left top zoom         & Sets a coordinate and a zoom factor. If any one is null, the source link value is used.
@@ -717,6 +718,7 @@ pdfprintclip       & \textit{empty}         & set /PrintClip of viewer preferenc
 pdfprintpagerange  & \textit{empty}         & set /PrintPageRange of viewer preferences \\
 pdfprintscaling    & \textit{empty}         & page scaling option for print dialog \\
 pdfproducer        & \textit{empty}         & text for PDF Producer field \\
+pdfremotestartview & \textit{Fit}           & starting view of remote PDF documents \\
 pdfstartpage       & \textit{1}             & page at which PDF document opens \\
 pdfstartview       & \textit{Fit}           & starting view of PDF document \\
 pdfsubject         & \textit{empty}         & text for PDF Subject field \\
@@ -752,7 +754,7 @@ If you need to make references to URLs, or write explicit links, the
 following low-level user macros are provided:
 
 \begin{cmdsyntax}
-\ci{href}\verb|{|\emph{URL}\verb|}{|\emph{text}\verb|}|
+\ci{href}\verb|[|\emph{options}\verb|]|\verb|{|\emph{URL}\verb|}{|\emph{text}\verb|}|
 \end{cmdsyntax}
 
 \noindent The \emph{text} is made a hyperlink to the \emph{URL}; this
@@ -760,6 +762,19 @@ must be a full URL (relative to the base URL, if that is defined). The
 special characters \# and \~{} do \emph{not} need to be escaped in any
 way.
 
+The optional argument \emph{options} recognizes the hyperref options
+\texttt{pdfremotestartview}, \texttt{pdfnewwindow} and the following
+key value options:
+\begin{description}
+\item[\texttt{page}:] Specifies the start page number of remote
+PDF documents. First page is \verb|1|.
+\item[\texttt{ismap}:] Boolean key, if set to |true|, the
+URL should appended by the coordinates as query parameters by
+the PDF viewer.
+\item[\texttt{nextactionraw}:] The value of key |/Next| of
+action dictionaries, see PDF specification.
+\end{description}
+
 \begin{cmdsyntax}
 \ci{url}\verb|{|\emph{URL}\verb|}|
 \end{cmdsyntax}
@@ -1099,7 +1114,8 @@ command names):
 \noindent
 \verb|\hypercalcbp| takes a \TeX\ dimen specification and
 converts it to bp and returns the number without the unit.
-This is useful for options \verb|pdfstartview| and \verb|pdfview|.
+This is useful for options \verb|pdfview|, \verb|pdfstartview|
+and \verb|pdfremotestartview|.
 Example:
 \begin{quote}
 \begin{verbatim}