| 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 |