summaryrefslogtreecommitdiff
path: root/texmf-dist/source/latex/aeb-mlink/doc/aebmlink_man.tex
blob: 4295fd8de12d974bd9270b4d733446fde19dc985 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
% makeindex < aebpro_man.idx > aebpro_man.ind
\documentclass{article}
%\usepackage[fleqn]{amsmath}
\usepackage[
    web={centertitlepage,designv,forcolorpaper,
        tight*,latextoc,pro,usetemplates},
    eforms={useui},
    aebxmp
]{aeb_pro}
\usepackage{aeb_mlink}

%\usepackage{myriadpro}
\usepackage[altbullet]{lucidbry}

\usepackage{acroman}

\usepackage[active]{srcltx}

\DeclareDocInfo
{
    university={\AcroTeX.Net},
    title={The \textsf{aeb\_mlink} Package\texorpdfstring{\\[1em]}{: }AeB Pro Family},
    author={D. P. Story},
    email={dpstory@acrotex.net},
    subject={Wrapping links around to the next line},
    keywords={XMP, E4X, Adobe Acrobat, JavaScript},
    talksite={\url{www.acrotex.net}},
    version={2.0},
    copyrightStatus={True},
    copyrightNotice={Copyright (C) 2006-\the\year, D. P. Story},
    copyrightInfoURL={http://www.acrotex.net}
}
\nocopyright
\DeclareInitView{windowoptions=showtitle}

\def\dps{$\hbox{$\mathfrak D$\kern-.3em\hbox{$\mathfrak P$}%
   \kern-.6em \hbox{$\mathcal S$}}$}


\def\AcroTeX{Acro\negthinspace\TeX}

\def\unskipparskip{\vskip-\parskip}
\renewenvironment{sverbatim}
{\parskip0pt\noindent\small\verbatim}{\endverbatim\par\aftergroup\unskipparskip}
\renewenvironment{ssverbatim}
{\parskip0pt\noindent\footnotesize\verbatim}{\endverbatim\par\aftergroup\unskipparskip}

\def\anglemeta#1{$\langle\textit{\texttt{#1}}\rangle$}
\def\meta#1{\textit{\texttt{#1}}}
\def\darg#1{\texttt{\{#1\}}}
\def\takeMeasure{\bgroup\obeyspaces\takeMeasurei}
\def\takeMeasurei#1{\global\setbox\webtempboxi\hbox{\ttfamily#1}\egroup}
\def\bxSize{\wd\webtempboxi+2\fboxsep+2\fboxrule}
\let\pkg\textsf
\let\env\texttt
\let\opt\texttt
\let\app\textsf

\let\amtIndent\leftmargini
\def\SUB#1{${}_{\text{#1}}$}

\newdimen\aebdimen \aebdimen 0pt %\advance\aebdimen\partopsep
\newcommand\bVerb[1][]{\begingroup#1\vskip\aebdimen\parindent0pt}%
\def\eVerb{\vskip\aebdimen\endgroup\noindent}

\def\cmdtitle#1{\texorpdfstring{\protect\cs{#1}}{\textbackslash{#1}}}

\renewcommand\hproportionwebauthor{.5}
\universityLayout{fontsize=Large}
\titleLayout{fontsize=LARGE}
\authorLayout{fontsize=Large}
\tocLayout{fontsize=Large,color=aeb}
\sectionLayout{indent=-62.5pt,fontsize=large,color=aeb}
\subsectionLayout{indent=-31.25pt,color=aeb}
\subsubsectionLayout{indent=0pt,color=aeb}
\subsubDefaultDing{\texorpdfstring{$\bullet$}{\textrm\textbullet}}

\makeatletter
\renewcommand{\paragraph}
    {\@startsection{paragraph}{4}{0pt}{6pt}{-3pt}{\bfseries}}
\makeatother

%\parindent0pt\parskip\medskipamount


\definePath\bgPath{"C:/Users/Public/Documents/%
    ManualBGs/Manual_BG_Print_AeB.pdf"}
\begin{docassembly}
\addWatermarkFromFile({%
    bOnTop: false,
    cDIPath: \bgPath
})
\executeSave()
\end{docassembly}

\begin{document}

\maketitle

\selectColors{linkColor=black}

\tableofcontents

\selectColors{linkColor=webgreen}

\section{Introduction}

This package creates \underbar{m}ulti-line \underbar{link}s, a dream
that I have had for a number of years. The package \pkg{hyperref}
does create links, but generally these links cannot be broken across
lines, unless the application \app{pdflatex} is used to create a
PDF; however, since my workflow is primarily through \app{Acrobat
Distiller}, this does me little good.

This package uses the \texttt{QuadPoints} entry of the link
annotation dictionary to create a bounding region; consequently,
\textbf{this package requires \app{Acrobat Distiller}} to create a PDF. The
\texttt{QuadPoints} entry in the link annotation is a PDF 1.6
feature, so these multi-line links will work in Adobe Reader 7.0 or
later. If viewed in a version of Adobe Reader previous to 7.0, the
viewer will use the underlying bounding box, which in the case of
this package, is the entire page. \emph{Because the multi-line links don't
work for versions of Adobe Reader prior to 7.0, this package should
be used only when the reading audience has the required version}.


\section{Requirements}

The following {\LaTeX} packages are the major ones required by \texttt{aeb\_mlink}.
\begin{itemize}
    \item \pkg{eforms} provides form and link support, \`a la
        {Acro\negthinspace\TeX} (\url{ctan.org/pkg/acrotex}).
    \item \pkg{hyperref} provides link support, including the
        commands \cs{hyperref}, \cs{hyperlink}, \cs{href}, \cs{nameref},
        \cs{Nameref}, and \cs{href}.
    \item \pkg{soul} a very nice package by Melchior FRANZ, used by
        \pkg{aeb\_mlink} to hyphenate links (\url{ctan.org/pkg/soul}).
%        \nolinkurl{CTAN: tex-archive/macros/latex/contrib/soul/}}

\end{itemize}

\section{Package options}

There are only two package options---the name of the dvi-to-ps converter application to be used---,
these are \opt{dvips} and \opt{dvipsone}.\footnote{\app{dvipsone.exe} is the dvi-to-ps converter
of the Y\&Y {\TeX} System, no longer available, but is used by this author.} The default is \opt{dvips}.

%\Hy@colorlinksfalse

\bVerb[\aebdimen=6pt]
\begin{minipage}[t]{.5\linewidth}
\begin{Verbatim}[xleftmargin=\amtIndent,commandchars=!(),fontsize=\small]
\documentclass{article}
\usepackage{xcolor}
\usepackage[colorlinks]{hyperref}
\usepackage[!anglemeta(driver)]{aeb_mlink}
\end{Verbatim}
\end{minipage}\quad\begin{minipage}[t]{.4\linewidth}
\begin{Verbatim}[commandchars=!(),fontsize=\small]
\documentclass{article}
\usepackage[designi]{web}
\usepackage[!anglemeta(driver)]{aeb_mlink}
\end{Verbatim}
\end{minipage}
\eVerb Above are two typical preambles for the use of \pkg{aeb\_mlink}:
\begin{itemize}
    \item The one on the left inputs \pkg{xcolor} (recommended) and
        \pkg{hyperref} explicitly. The \opt{colorlinks} option is
        recommended for \pkg{hyperref}. These two are followed by
        \pkg{aeb\_mlink}.
    \item The preamble representation on the right uses the \pkg{web}
        package, which internally inputs both \pkg{xcolor} (if available) and
        \pkg{hyperref} (with \opt{colorlinks} option). Again, \pkg{aeb\_mlink}
        comes last.
\end{itemize}

Since \pkg{eforms} is a required package, the \pkg{acrotex} bundle
(\pkg{AeB}) is installed; consequently, if you've set up the \texttt{web.cfg}
configuration file (that accompanies \pkg{AeB}) with either
\cs{ExecuteOptions\darg{dvips}} or \cs{ExecuteOptions\darg{dvipsone}}, the
specification of the \anglemeta{driver} is not normally needed.

\section{Multi-line link commands}

We define seven multi-line hypertext link commands: \cs{mlhypertext},
\cs{mlhyperlink}, \cs{mlhyperref}, \cs{mlnameref}, \cs{mlNameref},
\cs{href}, and \cs{mlurl}. The first is a basic command that is used in the definitions of
the other six.

\newtopic\noindent\textbf{Note:} Because of the way the bounding boxes are
constructed, it is best that the bounding rectangle is set on invisible, that
is, the line width of the boundary line is zero. The \opt{colorlinks} option
of \app{hyperref} should be taken.

\exSrc{mlink_tst}The demo file is \texttt{mlink\_tst.tex}, it illustrates all
the commands -- with the exception of \cs{mlurl} -- of this package. The
demo file for \cs{mlurl} is a separate file and is mentioned in
\hyperref[ss:mlrul]{Section~\ref*{ss:mlrul}}.

\subsection{\cmdtitle{mlhypertext} (\cmdtitle{mlsetLink})} A general purpose multi-line link command.

\bVerb[\aebdimen=8pt]\takeMeasure{\string\mlhypertext[\#1]\darg{\#2}}%
\begin{minipage}{\bxSize}
\begin{Verbatim}[frame=single,rulecolor=\color{webblue}]
\mlhypertext[#1]{#2}
\end{Verbatim}
\end{minipage}\quad\takeMeasure{\string\mlsetLink[\#1]\darg{\#2}}%
\begin{minipage}{\bxSize}
\begin{Verbatim}[frame=single,rulecolor=\color{webblue}]
\mlsetLink[#1]{#2}
\end{Verbatim}
\end{minipage}
\endgroup


\PD The first parameter is optional, and is used to set the appearance and the actions of the link.
The second parameter is the text around which the link is constructed.

\CmdDescription The \pkg{eforms} package defines \cs{mlsetLink} to
\cs{mlhypertext} (this is to conform to the naming conventions of
\pkg{eforms}). Either command sets a hypertext link having a default
appearance, and no action. The default appearance is the same as that of
\cs{hyperlink}, the command from \pkg{hyperref}. If \opt{colorlinks}
option was taken in the hyperref package, the text is colored \cs{@linkcolor}
(usually red); otherwise, the text is the default color at the time, and a
boundary rectangle is created by AcroForms with color \cs{@linkbordercolor}
(usually red).\footnote{The \pkg{web} package changes the default coloring of \pkg{hyperref}.}

\newtopic
For example, the following link is constructed using
\cs{mlhypertext}: \mlhypertext[\A{\JS{app.alert("AcroTeX rocks!")}}]%
{Acrobat Distiller, version~7.0 or greater} was used to
create this PDF document.

\bVerb\takeMeasure{\string\mlhypertext[\string\A\darg{\string\JS\darg{app.alert("AcroTeX rocks!")}}]\%}%
\begin{dCmd*}{\bxSize}
\mlhypertext[\A{\JS{app.alert("AcroTeX rocks!")}}]%
    {Acrobat Distiller, version~7.0 or greater}
\end{dCmd*}
\eVerb In the above example, the link, shown in \textcolor{webgreen}{green}
is broken across lines. Though is is not shown in this example, these links
can break a line at a hyphenation point as well. The optional argument is
used to create an alert box that appears when the link is clicked.

\subsection{\cmdtitle{mlhyperlink}} A multi-line version of the \cs{hyperlink} command.

\bVerb\takeMeasure{\string\mlhyperlink[\#1]\darg{\#2}\darg{\#3}}%
\begin{dCmd}{\bxSize}
\mlhyperlink[#1]{#2}{#3}
\end{dCmd}
\endgroup

\PD The first parameter is optional, and is used to set the appearance, but \textit{not the actions} of the  link.
The second parameter is a named destination, perhaps created by the \cs{hypertarget} command of
\pkg{hyperref}. The third parameter is the text around which the link is constructed.

\CmdDescription This command is the multi-line version of the \pkg{hyperref} command \cs{hyperlink}.
The default appearance is the same as \cs{hyperlink}, as described above in \cs{mlhypertext}.
The action of this link is to jump to a named destination; the action cannot be changed by defining
a different action through the first parameter.

This link uses the \cs{mlhyperlink} command:
\so{Welcome!} \mlhyperlink{retire}{Welcome, $\dots$ to my humble retirement residence, such as  it is!}
\bVerb\takeMeasure{\string\mlhyperlink\darg{retire}\{Welcome, \$\string\dots\$ to my humble}%
\begin{dCmd*}{\bxSize}
\mlhyperlink{retire}{Welcome, $\dots$ to my humble
retirement residence, such as it is!}
\end{dCmd*}
\eVerb In this example, the line is broken at a hyphenation, cool! We jump to
the named destination, \texttt{retire}. On the last page,
the following text appears
\begin{quote}
\verb!My humble retirement \hypertarget{retire}{home}.!
\end{quote}
creating the named destination of \texttt{retire}.

\subsection{\cmdtitle{mlhyperref}} A multi-line version of the \cs{hyperref} command.

\bVerb\takeMeasure{\string\mlhyperref[\#1]\darg{\#2}\darg{\#3}}%
\begin{dCmd}{\bxSize}
\mlhyperref[#1]{#2}{#3}
\end{dCmd}
\endgroup
\PD The first parameter is optional, and is used to set the
appearance, but \textit{not the actions} of the  link. The second
parameter is a label name created by the \cs{label} command of
\LaTeX. The third parameter is the text around which the link is
constructed.

\CmdDescription This is the multi-line version of \cs{hyperref}, the command
defined by the \pkg{hyperref} package. The default appearance is the same
as \cs{hyperref}. The action of this link is to jump to a destination created
by the \cs{label} command of the cross-referencing system of \LaTeX; the
action cannot be changed by defining a different action through the first
parameter.

\newtopic
This link uses the \cs{mlhyperref} command: \mlhyperref[\ui{linktxtcolor=red}]{retirement}
{Welcome! Welcome to my humble retirement residence, such as  it is!}

\bVerb\takeMeasure{\string\mlhyperref[\string\ui\darg{linktxtcolor=red}]\darg{retirement}}%
\begin{dCmd*}{\bxSize}
\mlhyperref[\ui{linktxtcolor=red}]{retirement}
{Welcome! Welcome to my humble retirement
residence, such as it is!}
\end{dCmd*}
\eVerb The user-friendly interface is used to change the appearance of the
color of the link text. The second argument is \texttt{retirement}, which is
the label
affixed to the last section of this document,
\begin{quote}
\verb!\section{My \textbf{Retirement} Home}\label{retirement}!
\end{quote}
See \mlNameref{retirement}.


\subsection{\cmdtitle{mlnameref}} A multi-line version of the \cs{nameref} command.

\bVerb\takeMeasure{\string\mlnameref[\#1]\darg{\#2}}%
\begin{dCmd}{\bxSize}
\mlnameref[#1]{#2}
\end{dCmd}
\endgroup

\PD The first parameter is optional, and is used to set the appearance, but
    \textit{not the actions} of the  link. The second parameter is a name of
    a {\LaTeX} label.

\CmdDescription This is the multi-line version of the
\pkg{hyperref} (\pkg{nameref}) command, \cs{nameref}. The default appearance is
the same as \cs{hyperref}. The action of this link is to jump to a
destination created by the \cs{label} command of the
cross-referencing system of \LaTeX; the action cannot be changed by
defining a different action through the first parameter.

\newtopic
This link uses the \cs{mlnameref} command: Click the link to witness \mlnameref{retirement}.
The code for this link is seen below:
\bVerb\takeMeasure{\string\mlnameref\darg{retirement}}%
\begin{dCmd*}{\bxSize}
\mlnameref{retirement}
\end{dCmd*}
\endgroup

\subsection{\cmdtitle{mlNameref}} A multi-line version of the
\pkg{hyperref} command, \cs{Nameref}.

\bVerb\takeMeasure{\string\mlNameref[\#1]\darg{\#2}}%
\begin{dCmd}{\bxSize}
\mlNameref[#1]{#2}
\end{dCmd}
\endgroup
\PD The first parameter is optional, and is used to set the
    appearance, but \textit{not the actions} of the  link. The second
    parameter is a name of a {\LaTeX} label.

\CmdDescription This is the multi-line version of the \pkg{hyperref}
(\pkg{nameref}) command, \cs{Nameref}. The default appearance is the same as
\cs{hyperref}. The action of this link is to jump to a destination created by
the \cs{label} command of the cross-referencing system of \LaTeX; the action
cannot be changed by defining a different action through the first parameter.

\newtopic
This link uses the \cs{mlNameref} command: Click the link or go to
the page, \mlNameref{retirement}. The code for the link is seen below:
\bVerb\takeMeasure{\string\mlNameref\darg{retirement}}%
\begin{dCmd*}{\bxSize}
\mlNameref{retirement}
\end{dCmd*}
\endgroup

\subsection{\cmdtitle{mlhref}} A multi-line version of the
\pkg{hyperref} command, \cs{href}.
\bVerb\takeMeasure{\string\mlhref[\#1]\darg{\#2}\darg{\#3}}%
\begin{dCmd}{\bxSize}
\mlhref[#1]{#2}{#3}
\end{dCmd}
\endgroup

\PD The first parameter is optional, and is used to set the
    appearance, but \textit{not the actions} of the  link. The
    second parameter is a URL, while the third parameter is the link text.

\CmdDescription This is the multi-line version of the
\pkg{hyperref} command, \cs{href}. The default appearance is
the same as \cs{hyperref}. There is one of three actions, depending on the
third argument, just as with \cs{href}. The action cannot be changed by
defining a different action through the first parameter.

%\begingroup
%\makeatletter
%\def\Hy@temp#1{\expandafter\Hy@@temp\csname @#1color\endcsname{#1}}
%\Hy@temp{link}{red}
%\Hy@temp{anchor}{black}
%\Hy@temp{cite}{green}
%\Hy@temp{file}{cyan}
%\Hy@temp{url}{magenta}
%\Hy@temp{menu}{red}
%\makeatother

\newtopic
The next link uses the \cs{mlhref} command with URL: \mlhref{%
http://www.math.uakron.edu/~dpstory/acrotex.html#educational}
{See the educational offerings of the {Acro\negthinspace{\TeX}} Web
Site at the University of Akron}
\bVerb\takeMeasure{\{See the educational offerings of the \darg{Acro\string\negthinspace\darg{\string\TeX}} Web}%
\begin{dCmd*}{\bxSize}
\mlhref{%
http://www.math.uakron.edu/~dpstory/acrotex.html#educational}
{See the educational offerings of the {Acro\negthinspace{\TeX}} Web
Site at the University of Akron}
\end{dCmd*}
\eVerb
Use the \cs{mlhref} command with mailto URL: My email address at Acro\negthinspace\TeX.Net,
\mlhref{mailto:dpstory@acrotex.net}{dpstory at acrotex dot net}.
\bVerb\takeMeasure{\string\mlhref\darg{mailto:dpstory@acrotex.net}\darg{dpstory at acrotex dot net}}%
\begin{dCmd*}{\bxSize}
\mlhref{mailto:dpstory@acrotex.net}{dpstory at acrotex dot net}
\end{dCmd*}
\eVerb
If the second argument is a PDF file, the PDF viewer will open it from your local file system,
or if you are in a browser, will open it from the web, provided it can find the relative path
\bVerb\takeMeasure{shameless advertisement for Acro\string\negthinspace\string\TeX\}.}%
\begin{dCmd*}{\bxSize}
\mlhref{shameless_ad.pdf}{Here is a
shameless advertisement for Acro\negthinspace\TeX}.
\end{dCmd*}
\eVerb If the key word `\texttt{run:}' is used, the link is set up to launch
an application. The PDF viewer will attempt to open the file with the
application associated with the extension of the file provided.
\bVerb\takeMeasure{\string\mlhref\darg{run:\string\jobname.tex}\darg{This is the source file of this document}.}%
\begin{dCmd*}{\bxSize}
\mlhref{run:\jobname.tex}{This is the source file of this document}.
\end{dCmd*}
\endgroup

\subsection{\cmdtitle{mlurl}}\label{ss:mlrul}

A multi-line version of the \cs{url} command of the \pkg{url} package.
The \pkg{hyperref} modifies this command to make it into an unbreakable link (at least for those
using \app{Distiller}).
\bVerb\takeMeasure{\string\mlurl[\#1]\darg{\#2}}%
\begin{dCmd}{\bxSize}
\mlurl[#1]{#2}
\end{dCmd}
\endgroup

\PD The first parameter is optional, and is used to set the
    appearance, but \textit{not the actions} of the  link. The
    second parameter is a URL, the text of the link is the same as the URL.

\CmdDescription This is the multi-line version of the
\pkg{url}/\pkg{hyperref} command, \cs{hurl}. The default appearance is
the same as set by \cs{hyperref}.

\newtopic
The next link is an example of \cs{mlurl}:
\mlurl{http://www.math.uakron.edu/~dpstory/acrotex.html#educational}. The code for this link is found below:
\bVerb\takeMeasure{\string\mlurl\darg{http://www.math.uakron.edu/\string~dpstory/acrotex.html\#educational}}%
\begin{dCmd*}{\bxSize}
\mlurl{http://www.math.uakron.edu/~dpstory/acrotex.html#educational}
\end{dCmd*}
\eVerb The \pkg{url} package typesets the URL in math mode, which makes it
very difficult to wrap it to the next line with a hypertext link around it.
In math mode, spaces are ignored; consequently, if the URL contains spaces,
use \verb!\%20! (with backslash), the URL encoding for the space character.
See the Internet reference
\mlurl{http://www.w3schools.com/tags/ref_urlencode.asp} for a discussion of
the \textbf{\caps{HTML URL Encoding Reference}}.


\exSrc{mlink_tst_url}The demo file that illustrate all the commands to
follow is \texttt{mlink\_tst\_url.tex}. Additional details and examples are found in this
example file.

\section{Setting the appearance and action}

The appearance and the action (at least for \cs{mlhypertex}) can be set through the first
optional parameter. The optional parameter takes key-value pairs of two types:
\paragraph*{Key-value Pairs.} The optional first parameter of each of the form and link commands take
two styles of key-values:
\begin{enumerate}
    \item eForms KVP: This is the key-value system originally developed, where each KVP has the form
        \cs{\anglemeta{key}\darg{\anglemeta{val}}}. Through these keys, the appearance
        and action of a link---if otherwise not restricted---may be set.
        For example, \mlhypertext[\S{U}\W{1}\Color{0 0.6 0}
        \linktxtcolor{webgreen} \A{\JS{app.alert("AcroTeX
        rocks!")}}]{AcroTeX can be found at
        \texttt{www.acrotex.net}, as close as your nearest web
        browser.}
\begin{Verbatim}[xleftmargin=\amtIndent,fontsize=\small]
\mlhypertext[\S{U}\W{1}\Color{0 0.6 0}\linktxtcolor{webgreen}
\A{\JS{app.alert("AcroTeX rocks!")}}]{AcroTeX...browser.}
\end{Verbatim}

    The eForms KVP system is explained in the eforms manual,
    \textsl{\mlhref{http://www.math.uakron.edu/~dpstory/acrotex/eformman.pdf}{Support for AcroForms and Links, and for Document JavaScript and Open Page Events}},\footnote
    {\url{http://www.math.uakron.edu/~dpstory/acrotex/eformman.pdf}}
    where a complete listing of all supported KVPs is found in the appendices.

    \item \pkg{xkeyval} KVP: When the \opt{useui} option is taken of the eforms package, key-value pairs are
        defined of the form \texttt{\anglemeta{key}[\,=\,\anglemeta{value}]}. The key-value pairs are actually a value of
        a special eForms key, \cs{ui}. The value of \cs{ui} consists of a comma-delimited list of
        \pkg{xkeyval} key-value pairs. For example,
        \mlsetLink[\ui{%
            border=visible,
            linestyle=underlined,
            bordercolor={0 0.6 0},
            linktxtcolor=webgreen,
            js={app.alert("AcroTeX rocks!")}}]{AcroTeX
            can be found at \texttt{www.acrotex.net}, as
            close as your nearest web browser.}
\begin{Verbatim}[xleftmargin=\amtIndent,fontsize=\small]
\mlsetLink[\ui{%
    border=visible,
    linestyle=underlined,
    bordercolor={0 0.6 0},
    linktxtcolor=webgreen,
    js={app.alert("AcroTeX rocks!")}}]{AcroTeX...browser.}
\end{Verbatim}


    \item[] The \pkg{xkeyval} KVP system is described in the document
    \textsl{\mlhref{http://www.math.uakron.edu/~dpstory/acrotex/eformman.pdf}{Support for AcroForms and Links, and for Document JavaScript and Open Page Events}}.\footnote
    {ibid.}

\end{enumerate}

\newpage

\section{My \textbf{Retirement} Home}\label{retirement}

My humble retirement \hypertarget{retire}{home}.
\begin{flushleft}
\setLink[\H{N}\A{\Named{GoBack}}]{\includegraphics[scale=.5]{DSC01404}}\quad \raisebox{75pt}{\textbf{Click image to return from jump}}
\end{flushleft}


\newtopic\noindent
Now, I simply must get back to my retirement. \dps



\end{document}