summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/hyper
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-03-07 17:03:54 +0000
committerKarl Berry <karl@freefriends.org>2010-03-07 17:03:54 +0000
commit499ad42b864ca45a40902239d8373c545598ee59 (patch)
treeba5cfb3b5e304f6a9fb3d88a2d2e4f15a119ebb6 /Master/texmf-dist/doc/latex/hyper
parentc3fa84757f6c17ec077afc3577a9e7efd332390f (diff)
hyper doc update (6mar10)
git-svn-id: svn://tug.org/texlive/trunk@17357 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/hyper')
-rw-r--r--Master/texmf-dist/doc/latex/hyper/README49
-rw-r--r--Master/texmf-dist/doc/latex/hyper/TODO34
-rw-r--r--Master/texmf-dist/doc/latex/hyper/contrib/README9
-rw-r--r--Master/texmf-dist/doc/latex/hyper/contrib/harvard-to.hyp21
-rw-r--r--Master/texmf-dist/doc/latex/hyper/defpattern.sty64
-rw-r--r--Master/texmf-dist/doc/latex/hyper/hyper.pdfbin0 -> 319761 bytes
-rw-r--r--Master/texmf-dist/doc/latex/hyper/scontrib/README6
-rw-r--r--Master/texmf-dist/doc/latex/hyper/scontrib/harvard.hyp21
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
Binary files differ
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%
+ }
+