Debian Codegraph @

texmf-dist/tex/plain/cweb/cwebacromac.tex

raw
1 % hypertext macros for CWEB listings (in addition to cwebmac.tex)
2 % Used in cwebmac.tex, pdfctwimac.tex, pdfproofmac.tex
3 % Version 3.1 --- January 2025
4 \ifx\ifacrohint\undefined\endinput\fi % these are not standalone macros
5
6 \ifluatex % LuaTeX is almost like pdfTeX
7 \protected\def\pdfliteral {\pdfextension literal}
8 \protected\def\pdfstartlink {\pdfextension startlink\space}
9 \protected\def\pdfendlink {\pdfextension endlink}
10 \protected\def\pdfoutline {\pdfextension outline\space}
11 \protected\def\pdfdest {\pdfextension dest\space}
12 \protected\def\pdfcatalog {\pdfextension catalog}
13 \edef\pdfhorigin {\pdfvariable horigin}
14 \edef\pdfvorigin {\pdfvariable vorigin}
15 \let\pdfpagewidth=\pagewidth
16 \let\pdfpageheight=\pageheight
17 \let\pdfoutput=\outputmode
18 \fi % end of LuaTeX->pdfTeX redirection macros
19
20 \def\pdfURL#1#2{\ifpdf \ifpdflua\pdfannotlink height \theheight depth \thedepth
21 attr {/Border [0 0 0]} user { /Type /Annot /Subtype /Link /A
22 << /S /URI /URI (#2) >>}\Blue #1\Black \pdfendlink % changed in 3.69
23 \else {\setbox0=\hbox{\special{pdf: bc [ \pdflinkcolor ]}{#1}%
24 \special{pdf: ec}}\special{pdf: ann width \thewidth height \theheight
25 depth \thedepth << /Border [0 0 0] /Type /Annot /Subtype /Link /A
26 << /S /URI /URI (#2) >> >>}\box0\relax}\fi
27 \else #1 ({\tt#2})\fi}
28 {\catcode`\~=12 \gdef\TILDE/{~}} % ~ in a URL
29 {\catcode`\_=12 \gdef\UNDER/{_}} % _ in a URL
30 \def\tocpages{1} % Most programs have one-page Table-of-Contents
31 \def\startpdf{\def\pagemode{/PageMode /UseOutlines}
32 \ifnum\contentspagenumber=0 \advance \pageno by -\tocpages
33 \def\pagelabels{/PageLabels << /Nums [ 0 << /S/D/St \tocpages >>
34 \the\pageno << /P(Contents) >> ] >>}
35 \else \twodigits=\pageno \pageno=\contentspagenumber
36 \advance \pageno by \tocpages \advance \twodigits by -\pageno
37 \def\pagelabels{/PageLabels << /Nums [ 0 << /S/D/St \the\pageno >>
38 \the\twodigits << /S/D/St \contentspagenumber >> ] >>}
39 \fi
40 \ifpdflua\pdfcatalog{\pagemode\space\pagelabels}
41 \else\special{pdf: docview << \pagemode\space\pagelabels >>}\fi}
42 \ifacrohint\def\digits{\pdflink{\the\countA}\scan}
43 \else\def\digits{{\the\countA}\scan}\fi
44 \def\scan#1{\begingroup
45 \ifx!#1% exit on exclamation point
46 \else\ifx,#1,\space\aftergroup\scan % insert ,\space}\scan ...
47 \else\ifx\[#1\aftergroup#1% insert }\[...
48 \else\ifx\*#1\aftergroup\lapstar\aftergroup\scan % insert }\lapstar\scan ...
49 \else\ifnum`#1>`9#1\aftergroup\scan % insert #1}\scan ...
50 \else\ifnum`#1<`0#1\aftergroup\scan % insert #1}\scan ...
51 \else
52 \afterassignment\digits \aftergroup\countA
53 \aftergroup#1% insert }\countA=#1...\digits ...
54 \fi\fi\fi\fi\fi \fi
55 \endgroup}
56
57 % Local variables; there are a few externals like '\toksA' and '\countA'
58 \newtoks\toksB \newtoks\toksC \newtoks\toksD \newtoks\toksF \newtoks\sanitizer
59 \newif\iftokprocessed \newif\ifTnum \newif\ifinstr \newif\ifhavenum
60
61 \ifacrohint % Common macros for \ifacro and \ifhint to create \pdflink's
62 \def\pdfnote#1.{\setbox0=\hbox{\toksA={#1.}\toksB={}\maketoks}\the\toksA}
63 \def\firstsecno#1.{\setbox0=\hbox{\toksA={#1.}\toksB={}%
64 \def\makenote{\addtokens\toksB{\the\toksC}\def\makenote{\let\space\empty
65 \toksC={}\toksD={}}\makenote}\maketoks}}
66 \def\addtokens#1#2{\edef\addtoks{\noexpand#1={\the#1#2}}\addtoks}
67 \def\poptoks#1#2|ENDTOKS|{\let\first=#1\toksD={#1}\toksA={#2}%
68 \ifcat\noexpand\first0\countB=`#1\else\countB=0\fi}
69 \def\maketoks{\expandafter\poptoks\the\toksA|ENDTOKS|%
70 \let\next=\maketoks % continue processing by default
71 \ifnum\countB>`9 \countB=0 \fi
72 \ifnum\countB<`0
73 \ifhavenum\makenote\fi
74 \ifx\first.\let\next=\maketoksdone % fullstop
75 \else\addtokens\toksB{\the\toksD}\ifx\first,\addtokens\toksB{\space}\fi
76 \fi
77 \else\addtokens\toksC{\the\toksD}\global\havenumtrue
78 \fi
79 \next}
80 \def\makenote{\addtokens\toksB
81 {\noexpand\pdflink{\the\toksC}}\toksC={}\global\havenumfalse}
82 \def\maketoksdone{\edef\st{\global\noexpand\toksA={\the\toksB}}\st}
83 \fi % End of common pdf/hint macros
84
85 \ifacro % The following are general pdf macros
86 \def\thewidth{\the\wd0 \space}
87 \def\theheight{\the\ht\strutbox\space}
88 \def\thedepth{\the\dp\strutbox\space}
89 \ifpdflua
90 \ifx\pdfannotlink\undefined\let\pdfannotlink\pdfstartlink\fi% for pdfTeX 0.14
91 \def\pdflink#1{\hbox{\pdfannotlink height \theheight depth \thedepth
92 attr{/Border [0 0 0]} goto num #1 \Blue #1\Black\pdfendlink}} % changed 3.69
93 \else\def\pdflink#1{\setbox0=\hbox{\special{pdf: bc [ \pdflinkcolor ]}{#1}%
94 \special{pdf: ec}}\special{pdf: ann width \thewidth height \theheight
95 depth \thedepth << /Type /Annot /Subtype /Link /Border [0 0 0]
96 /A << /S /GoTo /D (\romannumeral#1) >> >>}\box0\relax}
97 \fi
98 \def\sanitizecommand#1#2{\addtokens\sanitizer
99 {\noexpand\dosanitizecommand\noexpand#1{#2}}}
100 \def\dosanitizecommand#1#2{\ifx\nxt#1\addF{#2}\fi}
101
102 \catcode`\[=1 \catcode`\]=2 \catcode`\{=12 \catcode`\}=12
103 \def\lbchar[{] \def\rbchar[}]
104 \catcode`\[=12 \catcode`\]=12 \catcode`\{=1 \catcode`\}=2
105 \catcode`\~=12 \def\tildechar{~} \catcode`\~=13
106 \catcode`\|=0 |catcode`|\=12 |def|bschar{\} |catcode`|\=0 \catcode`\|=12
107 \def\makeoutlinetoks{\toksF={}\Tnumfalse
108 \afterassignment\makeolproctok\let\nxt= }
109 \def\makeolnexttok{\afterassignment\makeolproctok\let\nxt= }
110 \def\makeolgobbletok{\afterassignment\makeolnexttok\let\nxt= }
111 \def\makeolgobbletokk{\afterassignment\makeolgobbletok\let\nxt= }
112 \def\addF#1{\addtokens\toksF{#1}\tokprocessedtrue}
113 % now comes a routine to "sanitize" section names, for pdf outlines
114 \def\makeolproctok{\tokprocessedfalse
115 \let\next\makeolnexttok % default
116 \ifx\nxt\outlinedone\let\next\outlinedone
117 \else\ifx{\nxt \else\ifx}\nxt \Tnumfalse \instrfalse % skip braces
118 \else\ifx$\nxt % or a $ sign
119 \else\ifx^\nxt \addF^\else\ifx_\nxt \addF_% sanitize ^ and _
120 \else\ifx\nxt\spacechar \addF\space
121 \else\if\noexpand\nxt\relax % we have a control sequence; is it one we know?
122 \ifx\nxt~\addF\space \else\ifx\nxt\onespace\addF\space
123 \else\the\sanitizer
124 \iftokprocessed\else\makeolproctokctli
125 \iftokprocessed\else\makeolproctokctlii
126 \iftokprocessed\else\makeolproctokctliii % if not recognised, skip it
127 \fi\fi\fi
128 \fi\fi
129 \else % we don't have a control sequence, it's an ordinary char
130 \ifx/\nxt \addF{\string\/}% quote chars special to PDF with backslash
131 \else\ifx(\nxt \addF{\string\(}\else\ifx)\nxt \addF{\string\)}%
132 \else\ifx[\nxt \addF{\string\[}\else\ifx]\nxt \addF{\string\]}%
133 \else\expandafter\makeolproctokchar\meaning\nxt
134 \fi\fi\fi\fi\fi
135 \fi\fi\fi\fi\fi \fi\fi\fi
136 \next}
137 \def\makeolproctokchar#1 #2 #3{\addF{#3}}
138 \def\makeolproctokctli{%
139 \ifx\nxt\CEE\addF{C}\let\next\makeolgobbletok % \CEE/
140 \else\ifx\nxt\UNIX\addF{UNIX}\let\next\makeolgobbletok % \UNIX/
141 \else\ifx\nxt\TEX\addF{TeX}\let\next\makeolgobbletok % \TEX/
142 \else\ifx\nxt\TeX\addF{TeX}\else\ifx\nxt\LaTeX\addF{LaTeX}%
143 \else\ifx\nxt\CPLUSPLUS\addF{C++}\let\next\makeolgobbletok % \CPLUSPLUS/
144 \else\ifx\nxt\Cee\addF{C}\else\ifx\nxt\dots\addF{...\space}%
145 \else\ifx\nxt\PB \let\next\makeolgobbletok \tokprocessedtrue % \PB{...}
146 \else\ifx\nxt\9 \expandafter\nxt\relax \let\next\makeolgobbletokk % \9{#1}
147 \else\ifx\nxt\.\tokprocessedtrue\instrtrue % \.{...}
148 % skip \|
149 \else\ifx\nxt\\\ifinstr\addF{\bschar\bschar}\else\tokprocessedtrue\fi
150 \else\ifx\nxt\&\ifinstr\addF&\else\tokprocessedtrue\fi
151 \else\ifx\nxt\~\ifTnum\addF{0}\else\addF\tildechar\fi % 077->\T{\~77}
152 \else\ifx\nxt\_\ifTnum\addF{E}\else\addF_\fi % 0.1E5->\T{0.1\_5}
153 \else\ifx\nxt\^\ifTnum\addF{0x}\else\addF^\fi % 0x77 -> \T{\^77}
154 \else\ifx\nxt\\\\\ifTnum\addF{0b}\else\addF\\\fi % 0b10111 -> \T{\\10111}
155 \else\ifx\nxt\$\ifTnum\tokprocessedtrue\else\addF$\fi %$% \T{77\$L}
156 \else\ifx\nxt\{\addF\lbchar\else\ifx\nxt\}\addF\rbchar
157 \else\ifx\nxt\ \addF\space\else\ifx\nxt\#\addF{\string\#}%
158 \else\ifx\nxt\PP\addF{++}\else\ifx\nxt\MM\addF{--}%
159 \fi\fi\fi\fi\fi \fi\fi\fi\fi\fi
160 \fi\fi\fi\fi\fi \fi\fi\fi\fi\fi
161 \fi\fi\fi\fi
162 }
163 \def\makeolproctokctlii{%
164 \ifx\nxt\MG\addF{->}\else\ifx\nxt\GG\addF{>>}%
165 \else\ifx\nxt\LL\addF{<<}\else\ifx\nxt\NULL\addF{NULL}%
166 \else\ifx\nxt\AND\addF&\else\ifx\nxt\OR\addF|%
167 \else\ifx\nxt\XOR\addF^\else\ifx\nxt\CM\addF\tildechar
168 \else\ifx\nxt\MOD\addF{\string\%}\else\ifx\nxt\DC\addF{::}%
169 \else\ifx\nxt\PA\addF{.*}\else\ifx\nxt\MGA\addF{->*}%
170 \else\ifx\nxt\this\addF{this}\else\ifx\nxt\?\addF?%
171 \else\ifx\nxt\E\addF{==}\else\ifx\nxt\G\addF{>=}%
172 \else\ifx\nxt\I\addF{!=}\else\ifx\nxt\K\addF{=}%
173 \else\ifx\nxt\l\addF{l}\else\ifx\nxt\L\addF{L}%
174 \else\ifx\nxt\o\addF{o}\else\ifx\nxt\O\addF{O}%
175 \else\ifx\nxt\R\addF!%
176 \else\ifx\nxt\T \Tnumtrue \let\next\makeolgobbletok
177 \tokprocessedtrue % \T{number}
178 \else\ifx\nxt\AM\addF&\else\ifx\nxt\%\addF{\string\%}%
179 \fi\fi\fi\fi\fi \fi\fi\fi\fi\fi
180 \fi\fi\fi\fi\fi \fi\fi\fi\fi\fi
181 \fi\fi\fi\fi\fi \fi
182 }
183 \def\makeolproctokctliii{%
184 \ifx\nxt\V\addF{||}\else\ifx\nxt\W\addF{&&}\else\ifx\nxt\Z\addF{<=}%
185 \else\ifx\nxt\*\addF*\else\ifx\nxt\Xand\addF{\space and\space}%
186 \else\ifx\nxt\Xandxeq\addF{\space and_eq\space}%
187 \else\ifx\nxt\Xbitand\addF{\space bitand\space}%
188 \else\ifx\nxt\Xbitor\addF{\space bitor\space}%
189 \else\ifx\nxt\Xcompl\addF{\space compl\space}%
190 \else\ifx\nxt\Xnot\addF{\space not\space}%
191 \else\ifx\nxt\Xnotxeq\addF{\space not_eq\space}%
192 \else\ifx\nxt\Xor\addF{\space or\space}%
193 \else\ifx\nxt\Xorxeq\addF{\space or_eq\space}%
194 \else\ifx\nxt\Xxor\addF{\space xor\space}%
195 \else\ifx\nxt\Xxorxeq\addF{\space xor_eq\space}%
196 \fi\fi\fi\fi\fi \fi\fi\fi\fi\fi
197 \fi\fi\fi\fi\fi
198 }
199 \def\outlinedone{\edef\outlinest{\global\noexpand\toksE={\the\toksF}}%
200 \outlinest\let\outlinedone=\relax\outlinedone}
201 \fi % End of pdf macros
202
203 \ifhint
204 % The following top level macros use HINT primitives to implement:
205 % \HINThome to mark the position of the home page
206 % \HINTlabel to attach a label to the top of a section
207 % \HINTlink to link a section number to the section label
208 % \HINTcontents to produce an 'outline' item
209 \def\HINThome{\HINTdest name {HINT.home}%
210 \HINToutline goto name {HINT.home} depth 1 {Table of Contents}}
211 \def\HINTlabel{{\let\*=\empty\HINTdest num \secstar top}}
212 \def\HINTlink#1{\HINTstartlink goto num #1 {#1}\HINTendlink}
213 \def\HINTcontents#1#2#3{\HINToutline goto num #3 depth #2 {#1}}
214 \let\pdflink=\HINTlink
215 \fi % End of HINT macros