hyper doc update (6mar10)

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

8 files changed, 204 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/hyper/README b/Master/texmf-dist/doc/latex/hyper/README
new file mode 100644
index 00000000000..fac47d3ea6a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/hyper/README
@@ -0,0 +1,49 @@
+hyper-package V4.2d of 1999/03/09
+
+This package is used to produce hypertext documents with LaTeX.
+
+Currently supported are:
+  * the LaTeX2e base
+  * the following packages:
+      + amslatex
+      + cweb
+      + fancyheadings
+      + ftnright
+      + longtable
+      + natbib
+      + subeqnarray
+      + theorem
+      + xr
+
+Current extensions are:
+  * backcite
+
+Many other packages will run with the hyper-package without modifying
+anything. Just try it.
+
+Documentation:
+  Process hyper.dtx three times with latex
+  If the hyper-package is already installed this will produce a hypertext
+  document. Otherwise you will get a classical document without hypertext
+  marks.
+
+Installation on Unix-platforms:
+  Configure the variables of Makefile-Unix to Your needs and execute 
+  "make -f Makefile-Unix install". Follow the instructions.
+
+Installation on MSDos-platforms:
+  Configure the variables of Makefile-MSDos to Your needs and execute 
+  "nmake -f Makefile-MSDos install". Follow the instructions.
+
+Installation on other platforms:
+  Process hyper.ins with latex and move the files ending with .hyp or .sty
+  into a directory searched by TeX.
+  Move the files from the subdirectories contrib and scontrib into a
+  directory searched by TeX.
+
+Addons (not part of the installation directives above):
+  There is a perl script called dvi2pdf.pl that generates a pdf file from 
+  a dvi file using a dvips capable of transforming hyper dvi files to
+  hyper ps files and ghostscripts pdfwriter capability.
+  This file has three variables that have to be configured.
+
diff --git a/Master/texmf-dist/doc/latex/hyper/TODO b/Master/texmf-dist/doc/latex/hyper/TODO
new file mode 100644
index 00000000000..be8e2cd9a78
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/hyper/TODO
@@ -0,0 +1,34 @@
+- Introduce \DefineHyperURL and \UseHyperUrl to 
+  allow definition of external URLs in the document
+  preamble and usage at any position in the document
+  so that redefinition of URLs become easier
+  Add names \...ExternalURL?
+
+- after reference text for ref pageref noref as optional parameter surrounded by (,)?
+  (to be passed as 5th parameter to hyper@setref)
+
+- Introduce Base Reference for External Links
+    base_name: html:<base href = "href_string">
+
+- Introduce corresponding Macro(s) for inserting
+  relative links
+
+- Introduce Other Link/Referencing mechanism
+  that uses "type of stuff.number of stuff"
+  instead of an internal code as an alternative.
+
+- Consider the following part from html.sty (and allow additional optional parameter):
+    %%% HYPERREF 
+    % Suggested by Eric M. Carol <eric@ca.utoronto.utcc.enfm>
+    % Similar to \ref but accepts conditional text. 
+    % The first argument is HTML text which will become ``hyperized''
+    % (underlined).
+    % The second and third arguments are text which will appear only in the paper
+    % version (DVI file), enclosing the fourth argument which is a reference to a label.
+    %
+    %e.g. \hyperref{using the tracer}{using the tracer (see Section}{)}{trace}
+    % where there is a corresponding \label{trace}
+    %
+    \newcommand{\hyperref}[4]{#2\ref{#4}#3}
+
+- Is it worth to develop a native PDF support?
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/hyper/contrib/README b/Master/texmf-dist/doc/latex/hyper/contrib/README
new file mode 100644
index 00000000000..5668e5d43a0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/hyper/contrib/README
@@ -0,0 +1,9 @@
+This area is for downloading stuff that authors have
+written for adding hypertex capability to other packages 
+that are not supported by the hyper package.
+
+They can be included by giving the name <file> for
+including <file>.hyp as an optional parameter when
+including the hyper package.
+If a file does not end with .hyp include it afterwards
+instead.
diff --git a/Master/texmf-dist/doc/latex/hyper/contrib/harvard-to.hyp b/Master/texmf-dist/doc/latex/hyper/contrib/harvard-to.hyp
new file mode 100644
index 00000000000..c4cfce13771
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/hyper/contrib/harvard-to.hyp
@@ -0,0 +1,21 @@
+%% harvard.hyp - Amendments to harvard bibliography style Version 2.0.5
+%%               to be used together with the hyper package
+%% Author: Renate Schmidt (schmidt@mpi-sb.mpg.de)
+%% Copyright: Renate Schmidt, May 1995
+\NeedsTeXFormat{LaTeX2e}[1994/12/01]
+\ProvidesFile{harvard-to.hyp}[95/05/15]
+
+%% An apaptation of the original \harvarditem command that inserts a
+%  \blindhyperanchor for each item in the biliography and \hyperreference
+%  links around the citation-year.
+\renewcommand{\harvarditem}[4][\null]{%
+  \hyper@setcurrent%
+  \item[\blindhyperanchor{\@currenthyper}]%
+  \if@filesw{ \def\protect##1{\string ##1\space}%
+      \ifthenelse{\equal{#1}{\null}}
+        {\def\next{{#4}{#2}{#2}{\hyperreference{\@currenthyper}{#3}}}}
+        {\def\next{{#4}{#2}{#1}{\hyperreference{\@currenthyper}{#3}}}}
+      \immediate\write\@auxout{\string\harvardcite\next}%
+  }\fi%
+  \protect\hspace*{-\labelwidth}\protect\hspace*{-\labelsep}\ignorespaces%
+  }
diff --git a/Master/texmf-dist/doc/latex/hyper/defpattern.sty b/Master/texmf-dist/doc/latex/hyper/defpattern.sty
new file mode 100644
index 00000000000..0169d4a21d3
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/hyper/defpattern.sty
@@ -0,0 +1,64 @@
+%%
+%% This is file `defpattern.sty',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% hyper.dtx  (with options: `defpattern')
+%% 
+%% File: hyper.dtx Copyright (C) 1995--1999 Michael Mehlich
+%% This program can be redistributed and/or modified under the terms
+%% of the LaTeX Project Public License Distributed from CTAN
+%% archives in directory macros/latex/base/lppl.txt; either
+%% version 1 of the License, or any later version.
+\def\fileversion{V4.2d}
+\def\filedate{1999/03/09}
+\def\docdate{1999/03/09}
+%%
+%% \CharacterTable
+%% {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+%%  Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+%%  Digits        \0\1\2\3\4\5\6\7\8\9
+%%  Exclamation   \!     Double quote  \"     Hash (number) \#
+%%  Dollar        \$     Percent       \%     Ampersand     \&
+%%  Acute accent  \'     Left paren    \(     Right paren   \)
+%%  Asterisk      \*     Plus          \+     Comma         \,
+%%  Minus         \-     Point         \.     Solidus       \/
+%%  Colon         \:     Semicolon     \;     Less than     \<
+%%  Equals        \=     Greater than  \>     Question mark \?
+%%  Commercial at \@     Left bracket  \[     Backslash     \\
+%%  Right bracket \]     Circumflex    \^     Underscore    \_
+%%  Grave accent  \`     Left brace    \{     Vertical bar  \|
+%%  Right brace   \}     Tilde         \~}
+%%
+\ProvidesPackage{defpattern}
+\message{%
+  `\string\defpattern-macro %
+   (adapted from \string\howto\space%
+    (Alan Jeffrey in TeX and TUG NEWS 2(2))%
+   )%
+  '%
+}
+\def\xcs#1#2{\expandafter#1\csname#2\endcsname}
+\newcount\actioncount
+\def\defpattern#1[#2]#3{%
+  \xcs\ifx{\expandafter\gobble\string#1}\relax
+  \def#1{\erroraction#1}\fi
+  \advance\actioncount by 1\relax
+  \expandafter\defaction\expandafter{#1}{#3}{#2}%
+  \def\temp##1##2##3##4##5##6##7##8##9{\def\temp{[#2]}}%
+  \temp\empty\empty\empty\empty\empty\empty\empty\empty\empty
+  \edef#1{\noexpand\doaction\xcs\noexpand
+    {action-\the\actioncount}\temp}}
+\def\defaction#1#2#3{%
+  \xcs\def{action-\the\actioncount}##1[#3]{\applyto{#1}{#2}}}
+\def\gobble#1{}
+\def\applyto#1#2#3{#3{#1}{#2}}
+\def\doaction#1[#2][#3]{#1[#3]\success[#2]\failure[#3]}
+\def\success#1#2[#3]\failure[#4]{#2}
+\def\failure#1#2{#1}
+\def\erroraction#1[#2]{%
+   \PackageError{defpattern}{I don't know how to \string#1[#2]}{}}
+\endinput
+%%
+%% End of file `defpattern.sty'.
diff --git a/Master/texmf-dist/doc/latex/hyper/hyper.pdf b/Master/texmf-dist/doc/latex/hyper/hyper.pdf
new file mode 100644
index 00000000000..6d84bbce2d5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/hyper/hyper.pdf
diff --git a/Master/texmf-dist/doc/latex/hyper/scontrib/README b/Master/texmf-dist/doc/latex/hyper/scontrib/README
new file mode 100644
index 00000000000..68eb8e64eb6
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/hyper/scontrib/README
@@ -0,0 +1,6 @@
+This area contains some stuff that authors have written for 
+adding hypertex capability to other packages that are not
+supported by the hyper package.
+Some files from the contrib directory may be moved into this 
+directory when the hyper package has been prepared for 
+automatically loading them.
diff --git a/Master/texmf-dist/doc/latex/hyper/scontrib/harvard.hyp b/Master/texmf-dist/doc/latex/hyper/scontrib/harvard.hyp
new file mode 100644
index 00000000000..53fd4fc98c3
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/hyper/scontrib/harvard.hyp
@@ -0,0 +1,21 @@
+%% harvardfull.hyp - Amendments to harvard bibliography style Version 2.0.5
+%%               to be used together with the hyper package
+%% Author: Renate Schmidt (schmidt@mpi-sb.mpg.de)
+%% Copyright: Renate Schmidt, May 1995
+\NeedsTeXFormat{LaTeX2e}[1994/12/01]
+\ProvidesFile{harvard.hyp}[95/05/15]
+
+%% The following defines anchors not just for the year but also for the
+%% abbr-citation, the full-citation and the name.
+\renewcommand{\harvarditem}[4][\null]{%
+  \hyper@setcurrent%
+  \item[\blindhyperanchor{\@currenthyper}]%
+  \if@filesw{ \def\protect##1{\string ##1\space}%
+      \ifthenelse{\equal{#1}{\null}}
+        {\def\next{{#4}{\hyperreference{\@currenthyper}{#2}}{\hyperreference{\@currenthyper}{#2}}{\hyperreference{\@currenthyper}{#3}}}}
+        {\def\next{{#4}{\hyperreference{\@currenthyper}{#2}}{\hyperreference{\@currenthyper}{#1}}{\hyperreference{\@currenthyper}{#3}}}}
+      \immediate\write\@auxout{\string\harvardcite\next}%
+  }\fi%
+  \protect\hspace*{-\labelwidth}\protect\hspace*{-\labelsep}\ignorespaces%
+  }
+