Debian Codegraph @

texmf-dist/source/latex/catchfile/catchfile.dtx

raw
1 % \iffalse meta-comment
2 %
3 % File: catchfile.dtx
4 % Version: 2019/12/09 v1.8
5 % Info: Catch the contents of a file
6 %
7 % Copyright (C)
8 % 2007, 2010, 2011 Heiko Oberdiek
9 % 2016-2019 Oberdiek Package Support Group
10 % https://github.com/ho-tex/catchfile/issues
11 %
12 % This work may be distributed and/or modified under the
13 % conditions of the LaTeX Project Public License, either
14 % version 1.3c of this license or (at your option) any later
15 % version. This version of this license is in
16 % https://www.latex-project.org/lppl/lppl-1-3c.txt
17 % and the latest version of this license is in
18 % https://www.latex-project.org/lppl.txt
19 % and version 1.3 or later is part of all distributions of
20 % LaTeX version 2005/12/01 or later.
21 %
22 % This work has the LPPL maintenance status "maintained".
23 %
24 % The Current Maintainers of this work are
25 % Heiko Oberdiek and the Oberdiek Package Support Group
26 % https://github.com/ho-tex/catchfile/issues
27 %
28 % The Base Interpreter refers to any `TeX-Format',
29 % because some files are installed in TDS:tex/generic//.
30 %
31 % This work consists of the main source file catchfile.dtx
32 % and the derived files
33 % catchfile.sty, catchfile.pdf, catchfile.ins, catchfile.drv,
34 % catchfile-test1.tex, catchfile-test2.tex,
35 % catchfile-test3.tex.
36 %
37 % Distribution:
38 % CTAN:macros/latex/contrib/catchfile/catchfile.dtx
39 % CTAN:macros/latex/contrib/catchfile/catchfile.pdf
40 %
41 % Unpacking:
42 % (a) If catchfile.ins is present:
43 % tex catchfile.ins
44 % (b) Without catchfile.ins:
45 % tex catchfile.dtx
46 % (c) If you insist on using LaTeX
47 % latex \let\install=y\input{catchfile.dtx}
48 % (quote the arguments according to the demands of your shell)
49 %
50 % Documentation:
51 % (a) If catchfile.drv is present:
52 % latex catchfile.drv
53 % (b) Without catchfile.drv:
54 % latex catchfile.dtx; ...
55 % The class ltxdoc loads the configuration file ltxdoc.cfg
56 % if available. Here you can specify further options, e.g.
57 % use A4 as paper format:
58 % \PassOptionsToClass{a4paper}{article}
59 %
60 % Programm calls to get the documentation (example):
61 % pdflatex catchfile.dtx
62 % makeindex -s gind.ist catchfile.idx
63 % pdflatex catchfile.dtx
64 % makeindex -s gind.ist catchfile.idx
65 % pdflatex catchfile.dtx
66 %
67 % Installation:
68 % TDS:tex/generic/catchfile/catchfile.sty
69 % TDS:doc/latex/catchfile/catchfile.pdf
70 % TDS:source/latex/catchfile/catchfile.dtx
71 %
72 %<*ignore>
73 \begingroup
74 \catcode123=1 %
75 \catcode125=2 %
76 \def\x{LaTeX2e}%
77 \expandafter\endgroup
78 \ifcase 0\ifx\install y1\fi\expandafter
79 \ifx\csname processbatchFile\endcsname\relax\else1\fi
80 \ifx\fmtname\x\else 1\fi\relax
81 \else\csname fi\endcsname
82 %</ignore>
83 %<*install>
84 \input docstrip.tex
85 \Msg{************************************************************************}
86 \Msg{* Installation}
87 \Msg{* Package: catchfile 2019/12/09 v1.8 Catch the contents of a file (HO)}
88 \Msg{************************************************************************}
89
90 \keepsilent
91 \askforoverwritefalse
92
93 \let\MetaPrefix\relax
94 \preamble
95
96 This is a generated file.
97
98 Project: catchfile
99 Version: 2019/12/09 v1.8
100
101 Copyright (C)
102 2007, 2010, 2011 Heiko Oberdiek
103 2016-2019 Oberdiek Package Support Group
104
105 This work may be distributed and/or modified under the
106 conditions of the LaTeX Project Public License, either
107 version 1.3c of this license or (at your option) any later
108 version. This version of this license is in
109 https://www.latex-project.org/lppl/lppl-1-3c.txt
110 and the latest version of this license is in
111 https://www.latex-project.org/lppl.txt
112 and version 1.3 or later is part of all distributions of
113 LaTeX version 2005/12/01 or later.
114
115 This work has the LPPL maintenance status "maintained".
116
117 The Current Maintainers of this work are
118 Heiko Oberdiek and the Oberdiek Package Support Group
119 https://github.com/ho-tex/catchfile/issues
120
121
122 The Base Interpreter refers to any `TeX-Format',
123 because some files are installed in TDS:tex/generic//.
124
125 This work consists of the main source file catchfile.dtx
126 and the derived files
127 catchfile.sty, catchfile.pdf, catchfile.ins, catchfile.drv,
128 catchfile-test1.tex, catchfile-test2.tex,
129 catchfile-test3.tex.
130
131 \endpreamble
132 \let\MetaPrefix\DoubleperCent
133
134 \generate{%
135 \file{catchfile.ins}{\from{catchfile.dtx}{install}}%
136 \file{catchfile.drv}{\from{catchfile.dtx}{driver}}%
137 \usedir{tex/generic/catchfile}%
138 \file{catchfile.sty}{\from{catchfile.dtx}{package}}%
139 }
140
141 \catcode32=13\relax% active space
142 \let =\space%
143 \Msg{************************************************************************}
144 \Msg{*}
145 \Msg{* To finish the installation you have to move the following}
146 \Msg{* file into a directory searched by TeX:}
147 \Msg{*}
148 \Msg{* catchfile.sty}
149 \Msg{*}
150 \Msg{* To produce the documentation run the file `catchfile.drv'}
151 \Msg{* through LaTeX.}
152 \Msg{*}
153 \Msg{* Happy TeXing!}
154 \Msg{*}
155 \Msg{************************************************************************}
156
157 \endbatchfile
158 %</install>
159 %<*ignore>
160 \fi
161 %</ignore>
162 %<*driver>
163 \NeedsTeXFormat{LaTeX2e}
164 \ProvidesFile{catchfile.drv}%
165 [2019/12/09 v1.8 Catch the contents of a file (HO)]%
166 \documentclass{ltxdoc}
167 \usepackage{holtxdoc}[2011/11/22]
168 \begin{document}
169 \DocInput{catchfile.dtx}%
170 \end{document}
171 %</driver>
172 % \fi
173 %
174 %
175 %
176 % \GetFileInfo{catchfile.drv}
177 %
178 % \title{The \xpackage{catchfile} package}
179 % \date{2019/12/09 v1.8}
180 % \author{Heiko Oberdiek\thanks
181 % {Please report any issues at \url{https://github.com/ho-tex/catchfile/issues}}}
182 %
183 % \maketitle
184 %
185 % \begin{abstract}
186 % This package catches the contents of a file and puts it in a macro.
187 % It requires \eTeX. Both \LaTeX\ and \plainTeX\ are supported.
188 % \end{abstract}
189 %
190 % \tableofcontents
191 %
192 % \section{Documentation}
193 %
194 % The package relies on \eTeX's \cs{everyeof}. Otherwise it
195 % aborts with an error message.
196 %
197 % \begin{declcs}{CatchFileDef} \M{cmd} \M{file name} \M{setup}\\
198 % \cs{CatchFileEdef} \M{cmd} \M{file name} \M{setup}
199 % \end{declcs}
200 % Macro \meta{cmd} is defined with the contents
201 % of file \meta{file name}.
202 % \cs{CatchFileDef} uses \cs{def}, \cs{CatchFileEdef} \cs{edef}
203 % for the definition.
204 % Additional setup code for setting
205 % catcodes or treatment of line ends can be given in code
206 % \meta{setup}. See the test files for an example.
207 %
208 % \StopEventually{
209 % }
210 %
211 % \section{Implementation}
212 %
213 % \begin{macrocode}
214 %<*package>
215 % \end{macrocode}
216 %
217 % \subsection{Reload check and package identification}
218 % Reload check, especially if the package is not used with \LaTeX.
219 % \begin{macrocode}
220 \begingroup\catcode61\catcode48\catcode32=10\relax%
221 \catcode13=5 % ^^M
222 \endlinechar=13 %
223 \catcode35=6 % #
224 \catcode39=12 % '
225 \catcode44=12 % ,
226 \catcode45=12 % -
227 \catcode46=12 % .
228 \catcode58=12 % :
229 \catcode64=11 % @
230 \catcode123=1 % {
231 \catcode125=2 % }
232 \expandafter\let\expandafter\x\csname [email protected]\endcsname
233 \ifx\x\relax % plain-TeX, first loading
234 \else
235 \def\empty{}%
236 \ifx\x\empty % LaTeX, first loading,
237 % variable is initialized, but \ProvidesPackage not yet seen
238 \else
239 \expandafter\ifx\csname PackageInfo\endcsname\relax
240 \def\x#1#2{%
241 \immediate\write-1{Package #1 Info: #2.}%
242 }%
243 \else
244 \def\x#1#2{\PackageInfo{#1}{#2, stopped}}%
245 \fi
246 \x{catchfile}{The package is already loaded}%
247 \aftergroup\endinput
248 \fi
249 \fi
250 \endgroup%
251 % \end{macrocode}
252 % Package identification:
253 % \begin{macrocode}
254 \begingroup\catcode61\catcode48\catcode32=10\relax%
255 \catcode13=5 % ^^M
256 \endlinechar=13 %
257 \catcode35=6 % #
258 \catcode39=12 % '
259 \catcode40=12 % (
260 \catcode41=12 % )
261 \catcode44=12 % ,
262 \catcode45=12 % -
263 \catcode46=12 % .
264 \catcode47=12 % /
265 \catcode58=12 % :
266 \catcode64=11 % @
267 \catcode91=12 % [
268 \catcode93=12 % ]
269 \catcode123=1 % {
270 \catcode125=2 % }
271 \expandafter\ifx\csname ProvidesPackage\endcsname\relax
272 \def\x#1#2#3[#4]{\endgroup
273 \immediate\write-1{Package: #3 #4}%
274 \xdef#1{#4}%
275 }%
276 \else
277 \def\x#1#2[#3]{\endgroup
278 #2[{#3}]%
279 \ifx#1\@undefined
280 \xdef#1{#3}%
281 \fi
282 \ifx#1\relax
283 \xdef#1{#3}%
284 \fi
285 }%
286 \fi
287 \expandafter\x\csname [email protected]\endcsname
288 \ProvidesPackage{catchfile}%
289 [2019/12/09 v1.8 Catch the contents of a file (HO)]%
290 % \end{macrocode}
291 %
292 % \subsection{Catcodes}
293 %
294 % \begin{macrocode}
295 \begingroup\catcode61\catcode48\catcode32=10\relax%
296 \catcode13=5 % ^^M
297 \endlinechar=13 %
298 \catcode123=1 % {
299 \catcode125=2 % }
300 \catcode64=11 % @
301 \def\x{\endgroup
302 \expandafter\edef\csname CatchFile@AtEnd\endcsname{%
303 \endlinechar=\the\endlinechar\relax
304 \catcode13=\the\catcode13\relax
305 \catcode32=\the\catcode32\relax
306 \catcode35=\the\catcode35\relax
307 \catcode61=\the\catcode61\relax
308 \catcode64=\the\catcode64\relax
309 \catcode123=\the\catcode123\relax
310 \catcode125=\the\catcode125\relax
311 }%
312 }%
313 \x\catcode61\catcode48\catcode32=10\relax%
314 \catcode13=5 % ^^M
315 \endlinechar=13 %
316 \catcode35=6 % #
317 \catcode64=11 % @
318 \catcode123=1 % {
319 \catcode125=2 % }
320 \def\TMP@EnsureCode#1#2{%
321 \edef\CatchFile@AtEnd{%
322 \CatchFile@AtEnd
323 \catcode#1=\the\catcode#1\relax
324 }%
325 \catcode#1=#2\relax
326 }
327 \TMP@EnsureCode{39}{12}% '
328 \TMP@EnsureCode{44}{12}% ,
329 \TMP@EnsureCode{45}{12}% -
330 \TMP@EnsureCode{46}{12}% .
331 \TMP@EnsureCode{47}{12}% /
332 \TMP@EnsureCode{91}{12}% [
333 \TMP@EnsureCode{93}{12}% ]
334 \TMP@EnsureCode{96}{12}% `
335 \edef\CatchFile@AtEnd{\CatchFile@AtEnd\noexpand\endinput}
336 % \end{macrocode}
337 %
338 % \subsection{Preparations}
339 %
340 % \begin{macrocode}
341 \begingroup\expandafter\expandafter\expandafter\endgroup
342 \expandafter\ifx\csname RequirePackage\endcsname\relax
343 \input infwarerr.sty\relax
344 \input ltxcmds.sty\relax
345 \else
346 \RequirePackage{infwarerr}[2007/09/09]%
347 \RequirePackage{ltxcmds}[2010/03/09]%
348 \fi
349 % \end{macrocode}
350 %
351 % Check for \eTeX's \cs{everyeof}.
352 % \begin{macrocode}
353 \begingroup
354 \escapechar=92\relax
355 \edef\TestString{\string\everyeof}%
356 \edef\TestMeaning{\meaning\everyeof}%
357 \ifx\TestString\TestMeaning
358 \else
359 \@PackageError{catchfile}{%
360 Cannot find e-TeX's \string\everyeof,\MessageBreak
361 package loading is aborted%
362 }\@ehd
363 \endgroup
364 \expandafter\CatchFile@AtEnd
365 \fi%
366 \endgroup
367 % \end{macrocode}
368 %
369 % \subsection{Looking for primitive \cs{input}}
370 %
371 % \begin{macro}{\CatchFile@Input}
372 % The package needs the expandable primitive \cs{input}.
373 % However there are formats that redefine it. For example,
374 % \LaTeX's \cs{input} is not expandable, but it stores
375 % the primitive in \cs{@@input}. The third possibility
376 % is \cs{pdfprimitive}, introduced in \pdfTeX\ 1.40.0.
377 %
378 % Thus we try to find the primitive and store it in
379 % \cs{CatchFile@Input}. If it is used, it must be expanded
380 % twice (because of the solution with \cs{pdfprimitive}).
381 % \begin{macrocode}
382 \begingroup
383 \def\Check#1#2#3#4\endgroup{%
384 \edef\TestString{\string#1}%
385 \edef\TestMeaning{\meaning#2}%
386 \ifx\TestString\TestMeaning
387 \endgroup
388 \let\CatchFile@Primitive#2%
389 \def\CatchFile@Input{\CatchFile@Primitive#3}%
390 \else
391 #4\endgroup
392 \fi
393 }%
394 \Check\input\input{}%
395 \Check\input\@@input{}%
396 \Check\pdfprimitive\pdfprimitive\input
397 \@PackageError{%
398 Cannot find primitive \string\input,\MessageBreak
399 package loading is aborted%
400 }\@ehd
401 \csname endgroup\endcsname
402 \CatchFile@AtEnd%
403 \endgroup
404 % \end{macrocode}
405 % \end{macro}
406 %
407 % \subsection{Input file check}
408 %
409 % \begin{macro}{\CatchFile@CheckFileExists}
410 % \begin{macrocode}
411 \begingroup\expandafter\expandafter\expandafter\endgroup
412 \expandafter\ifx\csname IfFileExists\endcsname\relax
413 \input pdftexcmds.sty\relax
414 \begingroup\expandafter\expandafter\expandafter\endgroup
415 \expandafter\ifx\csname pdf@filesize\endcsname\relax
416 \def\CatchFile@CheckFileExists#1{%
417 \expandafter\ifx\csname @inputcheck\endcsname\relax
418 \csname newread\endcsname\@inputcheck
419 \fi
420 \openin\@inputcheck#1\relax
421 \expandafter\closein\expandafter\@inputcheck
422 \ifeof\@inputcheck
423 \let\CatchFile@File\relax
424 \else
425 \def\CatchFile@File{#1}%
426 \fi
427 }%
428 \else
429 \def\CatchFile@CheckFileExists#1{%
430 \expandafter\expandafter\expandafter\ifx
431 \expandafter\expandafter\expandafter\relax\pdf@filesize{#1}\relax
432 \let\CatchFile@File\relax
433 \else
434 \def\CatchFile@File{#1}%
435 \fi
436 }%
437 \fi
438 \else
439 \def\CatchFile@CheckFileExists#1{%
440 \IfFileExists{#1}{%
441 \expandafter\CatchFile@DefFile\@filef@und\@nil
442 \begingroup\expandafter\expandafter\expandafter\endgroup
443 \expandafter\ifx\csname @addtofilelist\endcsname\relax
444 \else
445 \@addtofilelist\CatchFile@File
446 \fi
447 }{%
448 \let\CatchFile@File\relax
449 }%
450 }%
451 \def\CatchFile@DefFile#1 \@nil{%
452 \def\CatchFile@File{#1}%
453 }%
454 \fi
455 % \end{macrocode}
456 % \end{macro}
457 %
458 % \begin{macro}{\CatchFile@NotFound}
459 % \begin{macrocode}
460 \def\CatchFile@NotFound#1#2{%
461 \def#1{}%
462 \@PackageError{catchfile}{%
463 File `#2' not found%
464 }\@ehc
465 }
466 % \end{macrocode}
467 % \end{macro}
468 %
469 % \subsection{Catch file contents}
470 %
471 % \begin{macrocode}
472 \ltx@IfUndefined{RequirePackage}{%
473 \input etexcmds.sty\relax
474 }{%
475 \RequirePackage{etexcmds}[2010/01/28]%
476 }
477 % \end{macrocode}
478 %
479 % \begin{macro}{\CatchFileEdef}
480 % \begin{macrocode}
481 \long\def\CatchFileEdef#1#2#3{%
482 \CatchFile@CheckFileExists{#2}%
483 \ifx\CatchFile@File\relax
484 \CatchFile@NotFound{#1}{#2}%
485 \else
486 \begingroup
487 \everyeof{\noexpand}%
488 #3%
489 \xdef\CatchFile@Contents{\CatchFile@Input\CatchFile@File\space}%
490 \endgroup
491 \let#1\CatchFile@Contents
492 \fi
493 }
494 % \end{macrocode}
495 % \end{macro}
496 %
497 % \begin{macro}{\CatchFileDef}
498 % \begin{macrocode}
499 \long\def\CatchFileDef#1#2#3{%
500 \CatchFile@CheckFileExists{#2}%
501 \ifx\CatchFile@File\relax
502 \CatchFile@NotFound{#1}{#2}%
503 \else
504 \begingroup
505 \everyeof\expandafter{%
506 \CatchFile@EOF
507 \expandafter\CatchFile@Finish
508 \noexpand
509 }%
510 \ltx@ifundefined{etex@unexpanded}{%
511 \expandafter\long\expandafter\def\expandafter\CatchFile@Do
512 \expandafter##\expandafter1\CatchFile@EOF{%
513 \toks\ltx@zero{##1}%
514 \xdef\CatchFile@gtemp{\the\toks\ltx@zero}%
515 \def\CatchFile@Finish{%
516 \endgroup
517 \let#1\CatchFile@gtemp
518 \global\let\CatchFile@gtemp\ltx@undefined
519 }%
520 }%
521 }{%
522 \expandafter\long\expandafter\def\expandafter\CatchFile@Do
523 \expandafter##\expandafter1\CatchFile@EOF{%
524 \edef\CatchFile@Finish{%
525 \endgroup
526 \etex@unexpanded{%
527 \edef#1{\etex@unexpanded{##1}}%
528 }%
529 }%
530 }%
531 }%
532 #3\relax
533 \expandafter\expandafter\expandafter\CatchFile@Do
534 \CatchFile@Input\CatchFile@File\relax
535 \fi
536 }
537 % \end{macrocode}
538 % \cs{relax} after |#3| was added to make it more robust in
539 % case the user uses something like
540 %\begin{verbatim}
541 %\CatchFileDef{\content}{\jobname.tt}{\endlinechar=-1}
542 %\end{verbatim}
543 % that expands the following \cs{expandafter} after |#3| prematurely
544 % (contribution of Martin Scharrer).
545 % \end{macro}
546 % \begin{macro}{\CatchFile@EOF}
547 % If the file is read the catcode mappings are fixed.
548 % This means that the same character cannot occur
549 % inside the file with different catcodes.
550 % Thus we use as end of file marker the at sign
551 % twice with different catcodes.
552 % \begin{macrocode}
553 \begingroup
554 \lccode65=64 % lowercase('A') = '@'
555 \lccode66=64 % lowercase('B') = '@'
556 \catcode65=8 % catcode('A') = subscript
557 \catcode66=3 % catcode('B') = math shift
558 \lowercase{\endgroup
559 \def\CatchFile@EOF{AB}%
560 }
561 % \end{macrocode}
562 % \end{macro}
563 %
564 % \begin{macrocode}
565 \CatchFile@AtEnd%
566 %</package>
567 % \end{macrocode}
568 %% \section{Installation}
569 %
570 % \subsection{Download}
571 %
572 % \paragraph{Package.} This package is available on
573 % CTAN\footnote{\CTANpkg{catchfile}}:
574 % \begin{description}
575 % \item[\CTAN{macros/latex/contrib/catchfile/catchfile.dtx}] The source file.
576 % \item[\CTAN{macros/latex/contrib/catchfile/catchfile.pdf}] Documentation.
577 % \end{description}
578 %
579 %
580 % \paragraph{Bundle.} All the packages of the bundle `catchfile'
581 % are also available in a TDS compliant ZIP archive. There
582 % the packages are already unpacked and the documentation files
583 % are generated. The files and directories obey the TDS standard.
584 % \begin{description}
585 % \item[\CTANinstall{install/macros/latex/contrib/catchfile.tds.zip}]
586 % \end{description}
587 % \emph{TDS} refers to the standard ``A Directory Structure
588 % for \TeX\ Files'' (\CTANpkg{tds}). Directories
589 % with \xfile{texmf} in their name are usually organized this way.
590 %
591 % \subsection{Bundle installation}
592 %
593 % \paragraph{Unpacking.} Unpack the \xfile{catchfile.tds.zip} in the
594 % TDS tree (also known as \xfile{texmf} tree) of your choice.
595 % Example (linux):
596 % \begin{quote}
597 % |unzip catchfile.tds.zip -d ~/texmf|
598 % \end{quote}
599 %
600 % \subsection{Package installation}
601 %
602 % \paragraph{Unpacking.} The \xfile{.dtx} file is a self-extracting
603 % \docstrip\ archive. The files are extracted by running the
604 % \xfile{.dtx} through \plainTeX:
605 % \begin{quote}
606 % \verb|tex catchfile.dtx|
607 % \end{quote}
608 %
609 % \paragraph{TDS.} Now the different files must be moved into
610 % the different directories in your installation TDS tree
611 % (also known as \xfile{texmf} tree):
612 % \begin{quote}
613 % \def\t{^^A
614 % \begin{tabular}{@{}>{\ttfamily}l@{ $\rightarrow$ }>{\ttfamily}l@{}}
615 % catchfile.sty & tex/generic/catchfile/catchfile.sty\\
616 % catchfile.pdf & doc/latex/catchfile/catchfile.pdf\\
617 % catchfile.dtx & source/latex/catchfile/catchfile.dtx\\
618 % \end{tabular}^^A
619 % }^^A
620 % \sbox0{\t}^^A
621 % \ifdim\wd0>\linewidth
622 % \begingroup
623 % \advance\linewidth by\leftmargin
624 % \advance\linewidth by\rightmargin
625 % \edef\x{\endgroup
626 % \def\noexpand\lw{\the\linewidth}^^A
627 % }\x
628 % \def\lwbox{^^A
629 % \leavevmode
630 % \hbox to \linewidth{^^A
631 % \kern-\leftmargin\relax
632 % \hss
633 % \usebox0
634 % \hss
635 % \kern-\rightmargin\relax
636 % }^^A
637 % }^^A
638 % \ifdim\wd0>\lw
639 % \sbox0{\small\t}^^A
640 % \ifdim\wd0>\linewidth
641 % \ifdim\wd0>\lw
642 % \sbox0{\footnotesize\t}^^A
643 % \ifdim\wd0>\linewidth
644 % \ifdim\wd0>\lw
645 % \sbox0{\scriptsize\t}^^A
646 % \ifdim\wd0>\linewidth
647 % \ifdim\wd0>\lw
648 % \sbox0{\tiny\t}^^A
649 % \ifdim\wd0>\linewidth
650 % \lwbox
651 % \else
652 % \usebox0
653 % \fi
654 % \else
655 % \lwbox
656 % \fi
657 % \else
658 % \usebox0
659 % \fi
660 % \else
661 % \lwbox
662 % \fi
663 % \else
664 % \usebox0
665 % \fi
666 % \else
667 % \lwbox
668 % \fi
669 % \else
670 % \usebox0
671 % \fi
672 % \else
673 % \lwbox
674 % \fi
675 % \else
676 % \usebox0
677 % \fi
678 % \end{quote}
679 % If you have a \xfile{docstrip.cfg} that configures and enables \docstrip's
680 % TDS installing feature, then some files can already be in the right
681 % place, see the documentation of \docstrip.
682 %
683 % \subsection{Refresh file name databases}
684 %
685 % If your \TeX~distribution
686 % (\TeX\,Live, \mikTeX, \dots) relies on file name databases, you must refresh
687 % these. For example, \TeX\,Live\ users run \verb|texhash| or
688 % \verb|mktexlsr|.
689 %
690 % \subsection{Some details for the interested}
691 %
692 % \paragraph{Unpacking with \LaTeX.}
693 % The \xfile{.dtx} chooses its action depending on the format:
694 % \begin{description}
695 % \item[\plainTeX:] Run \docstrip\ and extract the files.
696 % \item[\LaTeX:] Generate the documentation.
697 % \end{description}
698 % If you insist on using \LaTeX\ for \docstrip\ (really,
699 % \docstrip\ does not need \LaTeX), then inform the autodetect routine
700 % about your intention:
701 % \begin{quote}
702 % \verb|latex \let\install=y\input{catchfile.dtx}|
703 % \end{quote}
704 % Do not forget to quote the argument according to the demands
705 % of your shell.
706 %
707 % \paragraph{Generating the documentation.}
708 % You can use both the \xfile{.dtx} or the \xfile{.drv} to generate
709 % the documentation. The process can be configured by the
710 % configuration file \xfile{ltxdoc.cfg}. For instance, put this
711 % line into this file, if you want to have A4 as paper format:
712 % \begin{quote}
713 % \verb|\PassOptionsToClass{a4paper}{article}|
714 % \end{quote}
715 % An example follows how to generate the
716 % documentation with pdf\LaTeX:
717 % \begin{quote}
718 %\begin{verbatim}
719 %pdflatex catchfile.dtx
720 %makeindex -s gind.ist catchfile.idx
721 %pdflatex catchfile.dtx
722 %makeindex -s gind.ist catchfile.idx
723 %pdflatex catchfile.dtx
724 %\end{verbatim}
725 % \end{quote}
726 %
727 % \begin{History}
728 % \begin{Version}{2007/05/30 v1.0}
729 % \item
730 % First version.
731 % \end{Version}
732 % \begin{Version}{2007/09/09 v1.1}
733 % \item
734 % Catcode section rewritten.
735 % \end{Version}
736 % \begin{Version}{2007/11/11 v1.2}
737 % \item
738 % Use of package \xpackage{pdftexcmds} for \LuaTeX\ support.
739 % \end{Version}
740 % \begin{Version}{2010/03/01 v1.3}
741 % \item
742 % Fix for unknown \cs{@PackageErrorNoLine}.
743 % \end{Version}
744 % \begin{Version}{2010/04/08 v1.4}
745 % \item
746 % \cs{closein} also added if \cs{ifeof} is true.
747 % \end{Version}
748 % \begin{Version}{2010/04/28 v1.5}
749 % \item
750 % \cs{CatchFileDef}: Getting rid of warning `end of semi simple group
751 % entered at line \dots\ of
752 % a different file (Florent Chervet).
753 % \item
754 % \cs{CatchFileDef}: Fix for error `Illegal parameter number in
755 % definition of \dots' (HO) including improvement that uses
756 % \cs{unexpanded} if available (Florent Chervet).
757 % \end{Version}
758 % \begin{Version}{2011/03/01 v1.6}
759 % \item
760 % \cs{relax} added after the setup argument of
761 % \cs{CatchFileDef} to prevent premature file reading
762 % (Martin Scharrer).
763 % \end{Version}
764 % \begin{Version}{2016/05/16 v1.7}
765 % \item
766 % Documentation updates.
767 % \end{Version}
768 % \begin{Version}{2019/12/09 v1.8}
769 % \item
770 % Documentation updates.
771 % \end{Version}
772 % \end{History}
773 %
774 % \PrintIndex
775 %
776 % \Finale
777 \endinput