From 95b070aee1a6351879af117f723c84d50b48338d Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Tue, 27 Apr 2021 03:00:54 +0000
Subject: CTAN sync 202104270300

---
 macros/latex/contrib/acrotex/web.dtx | 156 +++++++++++++++++++----------------
 1 file changed, 87 insertions(+), 69 deletions(-)

(limited to 'macros/latex/contrib/acrotex/web.dtx')

diff --git a/macros/latex/contrib/acrotex/web.dtx b/macros/latex/contrib/acrotex/web.dtx
index d423a0681a..76375a62d5 100644
--- a/macros/latex/contrib/acrotex/web.dtx
+++ b/macros/latex/contrib/acrotex/web.dtx
@@ -36,6 +36,8 @@
 \let\env\texttt
 \let\app\textsf
 \let\uif\textsf
+\def\STRUT{\rule{0pt}{14pt}}
+\def\negSTRUT{\rule[-8pt]{0pt}{0pt}}
 \def\nmpsep#1{\hskip-\marginparsep\texttt{#1}}
 \def\visispace{\symbol{32}}
 \def\ameta#1{\ensuremath{\langle\textit{\texttt{#1}}\rangle}}
@@ -88,7 +90,7 @@
 % \texttt{dvipdfm}, \texttt{dvipdfmx}, \texttt{xetex}, and \texttt{textures}.
 %\par\medskip\noindent
 % We introduce these two packages early. We use them to automatically
-% detect pdftex and xetex.
+% detect \app{pdf(la)tex} and \app{xe(la)tex}.
 %\changes{v4.2k}{2012/06/18}{New requirement \string\textsf{ifpdf}}%
 %    \begin{macrocode}
 \RequirePackage{ifpdf}[2006/02/20]
@@ -131,10 +133,10 @@
 % Below is the original definition of \cs{web@set@paper}, this has now
 % changed with \texttt{v4.2j} to accommodate \cs{addtoWebHeight} and
 % \cs{addtoWebWidth}.
-%\begin{verbatim}
-%   \def\web@set@paper{%
-%     \special{papersize=\the\paperwidth,\the\paperheight}}%
-%\end{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
+%\def\web@set@paper{\special{papersize=\the\paperwidth,\the\paperheight}}%
+%\end{Verbatim}
 % \changes{v4.2j}{2012/05/11}{In support of \string\cs{addtoWebHeight}, we introduce
 % the pagesize special at the beginning of the document. Changes are in the
 % \string\texttt{dvipsone} and \string\texttt{dvips} options only.}
@@ -182,10 +184,11 @@
   \def\i@web@ddtoHyOpts{setpagesize=false}%
 %    \end{macrocode}
 % The old definition of \cs{web@set@paper}
-%\begin{verbatim}
-%    \def\web@set@paper{%
-%        \special{papersize=\the\paperwidth,\the\paperheight}}
-%\end{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
+%\def\web@set@paper{!%
+%!quad\special{papersize=\the\paperwidth,\the\paperheight}}
+%\end{Verbatim}
 % New definitions (\texttt{v4.2j}). See comments for the \texttt{dvipsone} option.
 %    \begin{macrocode}
   \let\web@set@paper\@empty
@@ -880,9 +883,10 @@
 %    \end{macrocode}
 % \subsection{Load Configuration File: web.cfg}
 % Look for configuration file, \texttt{web.cfg}, for example
-%\begin{verbatim}
-%    \ExecuteOptionsX{dvips}
-%\end{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
+%\ExecuteOptionsX{dvips}
+%\end{Verbatim}
 % sets \texttt{dvips} as the default driver.
 %    \begin{macro}{\minPanelWidth}
 % This definition is moved here so a user can set the minimal
@@ -1122,11 +1126,12 @@
     \addtolength{\textheight}{-\@Topmargin}
     \addtolength{\textheight}{-\@Bottommargin}
 %    \end{macrocode}
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!~$},codes={\catcode`\%=9}]
 %\topmargin = \web@Topmargin - 1in
 %\@Topmargin = \web@Topmargin + \headheight + \headsep
-% so \headsep = \@Topmargin - \headheight - \web@Topmargin (\topmargin)
-%\end{verbatim}
+%!textsf~so $\headsep = \@Topmargin - \headheight - \web@Topmargin (\topmargin)
+%\end{Verbatim}
 %    \begin{macrocode}
     \setlength{\headsep}{\@Topmargin}
     \addtolength\headsep{-\headheight}
@@ -1192,13 +1197,12 @@
 % press quality have this parameter at 2400. The second and third parameters are the
 % width and height, respectively, of the \textbf{/PageSize}. For greatest accuracy, the values of
 % width and height should be entered in printers points (without dimensions). For example,
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
 %\setPageDevice{1400}{1400}
-%\end{verbatim}
-% is preferred to
-%\begin{verbatim}
+%!STRUT!negSTRUT!textsf(is preferred to)
 %\setPageDevice{20in}{20in}
-%\end{verbatim}
+%\end{Verbatim}
 % \texttt{20in} gets converted to \texttt{1439.9965}. The conversion, if necessary, is done
 % by \cs{@convLtoP}
 %
@@ -1238,11 +1242,12 @@
 % and \cs{paperheight} will be the default values set by the class, but take \cs{textwidth} to be
 % the value of \#2. The second and third parameters are the width and height, respectively, as measured
 % in printer points ($72\,\mbox{points} = 1\,\mbox{inch}$, or measures in the \texttt{bp} points of \TeX.)
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
 %Parameters:
-%   #1 = \paperheight (height of the display screen to be created)
-%   #2 = \paperwidth (width of the display screen to be created)
-%\end{verbatim}
+%!quad#1 = \paperheight (height of the display screen to be created)
+%!quad#2 = \paperwidth (width of the display screen to be created)
+%\end{Verbatim}
 %    \begin{macrocode}
 \def\screensize#1#2{%
   \def\webSaveSSDim{{#1}{#2}}%
@@ -1281,22 +1286,24 @@
 % cannot be deformed to fit one of the standard designs. The solution is to
 % create a screen size matching the graphic, then using that graphic as a template.
 % Example usage,
-%\begin{verbatim}
-%    \margins{1in}{1in}{24pt}{.25in}
-%    \setScreensizeFromGraphic{acro_30}
-%    \template{acro_30}
-%\end{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
+%!quad\margins{1in}{1in}{24pt}{.25in}
+%!quad\setScreensizeFromGraphic{acro_30}
+%!quad\template{acro_30}
+%\end{Verbatim}
 % This command takes two arguments, the first is optional and is passed
 % to the \cs{includegraphics} command, the second it the path to the file.
 %
 % It may become necessary with some graphics to use the
 % \texttt{hiresbb} option for \cs{includegraphics}, both in
 % \cs{setScreensizeFromGraphic} and \cs{template} like so,
-%\begin{verbatim}
-%    \margins{1in}{1in}{24pt}{.25in}
-%    \setScreensizeFromGraphic[hiresbb]{acro_30}
-%    \template[hiresbb]{acro_30}
-%\end{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
+%!quad\margins{1in}{1in}{24pt}{.25in}
+%!quad\setScreensizeFromGraphic[hiresbb]{acro_30}
+%!quad\template[hiresbb]{acro_30}
+%\end{Verbatim}
 % \changes{v4.0f}{2007/06/11}
 % {
 %   This command measures the dimensions of an EPS file, and sets the
@@ -1387,7 +1394,8 @@
 %    \subsubsection{\texorpdfstring{\protect\cs{margins}}{\CMD{margins}}}
 %    \begin{macro}{\margins}
 % Sets the left, right, top and bottom margins.
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
 %Parameters:
 % [#1] = width of panel to be used if a panel option
 %        is specified (default is 1in)
@@ -1395,7 +1403,7 @@
 %   #3 = right margin
 %   #4 = top margin
 %   #5 = bottom margin
-%\end{verbatim}
+%\end{Verbatim}
 %    \begin{macrocode}
 \newcommand{\@margins}[5][\web@minpanelwidth]{%
   \def\webSaveMargDim{[#1]{#2}{#3}{#4}{#5}}%
@@ -1422,9 +1430,10 @@
 % |\addtoWebWidth| and |\addtoWebHeight|, this command readjusts
 % the margins. Within the arguments \cs{incby}
 % refer to the current dimension.
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
 %\resetsmargins{\incby+.25in}{\incby+.25in}{}{}
-%\end{verbatim}
+%\end{Verbatim}
 % This line adds .25in to each of the side margins.
 %    \begin{macrocode}
 \newcommand\get@MargDim[5][]{%
@@ -1955,7 +1964,7 @@
         \@ifundefined{aeb@talksite}{\webversion}
           {\ifx\aeb@talksite\@empty\webversion
            \else\aeb@talksite\fi}%
-      }%
+      }% 
     }%
   }%
   \bigskip
@@ -2161,7 +2170,8 @@
 %    \begin{macro}{\@newNaviIconMenu}
 % This command uses the hyperref command \cs{Acrobatmenu} to create navigation link button. The
 % action for this type is restricted to named menu actions.
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
 %Parameters
 %  [#1] = optional parameter for setting the highlight, N (none),
 %         I (invert, the default), O (outline), P (push, also called Inset)
@@ -2170,7 +2180,7 @@
 %   #4 = height of icon
 %   #5 = text to appear in the center of the icon.
 %   #6 = named menu action, e.g., NextPage, PrevPage, etc.
-%\end{verbatim}
+%\end{Verbatim}
 % The color of the text is controlled by \cs{navibarTextColor}, and the background color
 % is determined by \cs{@menuBgColor}.
 %    \begin{macrocode}
@@ -2188,7 +2198,8 @@
 %    \end{macro}
 %    \begin{macro}{\@newNaviIconJS}
 % Another navigation icon/button, but this one allows for arbitrary JavaScript actions.
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
 %Parameters
 %  [#1] = optional parameter for setting the highlight, N (none),
 %         I (invert, the default) O (outline), P (push, also called Inset)
@@ -2197,7 +2208,7 @@
 %   #4 = height of icon
 %   #5 = text to appear in the center of the icon.
 %   #6 = JavaScript commands to be executed when the button is clicked.
-%\end{verbatim}
+%\end{Verbatim}
 % The color of the text is controlled by \cs{navibarTextColor}, and the background color
 % is determined by \cs{@menuBgColor}.
 %    \begin{macrocode}
@@ -2242,7 +2253,8 @@
 %    \end{macrocode}
 %    \end{macro}
 % Another navigation icon/button, this one allows jumping to a named destination.
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
 %Parameters
 %  [#1] = optional parameter for setting the highlight, N (none),
 %         I (invert, the default), O (outline), P (push, also called Inset)
@@ -2251,12 +2263,13 @@
 %   #4 = height of icon
 %   #5 = text to appear in the center of the icon.
 %   #6 = \hyperlink or \href with its first argument
-%\end{verbatim}
+%\end{Verbatim}
 % For example,
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
 %\newNaviIcon[l]{\Home}{40pt}{15pt}{\footnotesize Home}
 %   {\href{http://www.math.uakron.edu/}}
-%\end{verbatim}
+%\end{Verbatim}
 % The color of the text is controlled by \cs{navibarTextColor}, and the background color
 % is determined by \cs{@menuBgColor}.
 %    \begin{macrocode}
@@ -2452,9 +2465,10 @@
 %    \begin{macro}{\ArrowUp}
 %    \begin{macro}{\ArrowDown}
 % Pre-Fab Rule Icons \cs{Uparrow} and \cs{Downarrow}, for example,
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
 %\insertnaviiconhere{\ArrowUp{\href{http://www.adobe.com/}}}
-%\end{verbatim}
+%\end{Verbatim}
 %    \begin{macrocode}
 \newcommand\ArrowUp[1]{%
   \normalsize\ifeqforpaper
@@ -3067,11 +3081,12 @@
   \begingroup
 %    \end{macrocode}
 % Sample line from .aux
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
 %  \contentsline {section}{\numberline {1}Introduction}{4}{section.1}
 %  \contentsline {section}{\numberline {}References}{56}{section*.1}
 %                                #1                   #2     #3
-%\end{verbatim}
+%\end{Verbatim}
 %    \begin{macrocode}
     \global\let\isChapter\web@NO
     \parskip0pt\parindent\toc@indent\relax
@@ -3217,9 +3232,10 @@
 % is optional.  Use any  of the \emph{boolean keys} of the
 % \cs{includegraphics} command. Do not use the \texttt{width} or
 % \texttt{height} keys in this optional argument. For example,
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
 %  \template[hiresbb]{myBG}
-%\end{verbatim}
+%\end{Verbatim}
 % Causes the driver to import the graphic using the high resolution bounding
 % box.
 % It is assumed that a graphic defined by \cs{template} is intended to fill the entire
@@ -3948,8 +3964,9 @@
 % in the \texttt{web} package. This command should appear in the preamble.
 %
 %\medskip\noindent Example usage:
-%\begin{verbatim}
-%\DeclareDocInfo{%
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
+%\DeclareDocInfo{!%
 %    title=My First Presentation,
 %    author=D. P. Speaker,
 %    university=My University,
@@ -3958,7 +3975,7 @@
 %    talksite=The Talking University,
 %    subject=The Art of Talking
 %}
-%\end{verbatim}
+%\end{Verbatim}
 %    \begin{macrocode}
 \newcommand{\DeclareDocInfo}[1]{\setkeys{aebDocInfo}{#1}%
   \ifx\web@talkdate@value\@empty\else\let\webversion\webtalkdate\fi}
@@ -4048,15 +4065,16 @@
 % ignored when the \texttt{forpaper} option is in effect.
 %
 %\medskip\noindent Example usage:
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
 %\DeclarePageLayout
-%{%
+%{!%
 %    screensizeOf=designv,
 %    margins={.75in}{.75in}{.75in}{.75in},
 %    topmargin=40pt,
 %    webfootskip=30pt
 %}
-%\end{verbatim}
+%\end{Verbatim}
 % This sets the \texttt{\texttt{screensize}} to the same as the
 % \texttt{screensize} of \texttt{designv}. We then adjust the
 % margins, the \texttt{topmargin} key is used to position the running
@@ -5186,9 +5204,10 @@
 % The \cs{selectColors} is a convenience command for setting
 % many of the colors involved in the design of an \textsf{APB} document.
 % The default colors are \dots
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
 %\selectColors
-%{
+%{!%
 %    universityColor = blue,
 %    titleColor = black,
 %    authorColor = black,
@@ -5199,7 +5218,7 @@
 %    linkColor = webgreen,
 %    fileColor = webbrown
 %}
-%\end{verbatim}
+%\end{Verbatim}
 %    \begin{macrocode}
 \newcommand{\selectColors}[1]{\setkeys{aebcolordesign}{#1}}
 %    \end{macrocode}
@@ -5235,14 +5254,15 @@
 %    \begin{macro}{\selectTocDings}
 % This is an \textsf{xkeyval} interface to setting the dings used by
 % the structured lists and the table of contents. Usage:
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
 %\selectTocDings
-%{
+%{!%
 %    dDing=\ding{082},
 %    ddDing=\ding{079},
 %    dddDing=\ding{254}
 %}
-%\end{verbatim}
+%\end{Verbatim}
 %    \begin{macrocode}
 \newcommand{\selectTocDings}[1]{\setkeys{aebDings}{#1}}
 %    \end{macrocode}
@@ -5265,10 +5285,8 @@
 % comment environments one \texttt{forpaper} and another for
 % \texttt{forscreen}.
 %    \begin{macrocode}
-  \includecomment{forpaper}\excludecomment{forscreen}
-\else
-  \includecomment{forscreen}\excludecomment{forpaper}
-\fi
+  \includecomment{forpaper}\excludecomment{forscreen}\else
+  \includecomment{forscreen}\excludecomment{forpaper}\fi
 %    \end{macrocode}
 %    \end{environment}
 %    \end{environment}
-- 
cgit v1.2.3

