summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/askinclude
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-12-11 03:01:04 +0000
committerNorbert Preining <norbert@preining.info>2019-12-11 03:01:04 +0000
commite22515f37100cb2802961f6a7cb76c8a22a118db (patch)
treec7e4363da93af0719a6f9681769c9441a464a3fb /macros/latex/contrib/askinclude
parent0174af21196c197a5b3672c87bc6f7a614fddd7d (diff)
CTAN sync 201912110301
Diffstat (limited to 'macros/latex/contrib/askinclude')
-rw-r--r--macros/latex/contrib/askinclude/README.md10
-rw-r--r--macros/latex/contrib/askinclude/askinclude.dtx1895
-rw-r--r--macros/latex/contrib/askinclude/askinclude.pdfbin0 -> 594397 bytes
3 files changed, 1905 insertions, 0 deletions
diff --git a/macros/latex/contrib/askinclude/README.md b/macros/latex/contrib/askinclude/README.md
new file mode 100644
index 0000000000..51997bfd6e
--- /dev/null
+++ b/macros/latex/contrib/askinclude/README.md
@@ -0,0 +1,10 @@
+# askinclude
+
+askinclude package for LaTeX
+
+
+
+This package replaces \includeonly by an interactive user
+interface.
+
+
diff --git a/macros/latex/contrib/askinclude/askinclude.dtx b/macros/latex/contrib/askinclude/askinclude.dtx
new file mode 100644
index 0000000000..04f8d04f17
--- /dev/null
+++ b/macros/latex/contrib/askinclude/askinclude.dtx
@@ -0,0 +1,1895 @@
+% \iffalse meta-comment
+%
+% File: askinclude.dtx
+% Version: 2019/12/09 v2.5
+% Info: Interactive asking of included files
+%
+% Copyright (C)
+% 1991-1994 Pablo A. Straub
+% 2007, 2008, 2011 Heiko Oberdiek
+% 2016-2019 Oberdiek Package Support Group
+% https://github.com/ho-tex/askinclude/issues
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either
+% version 1.3c of this license or (at your option) any later
+% version. This version of this license is in
+% https://www.latex-project.org/lppl/lppl-1-3c.txt
+% and the latest version of this license is in
+% https://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of
+% LaTeX version 2005/12/01 or later.
+%
+% This work has the LPPL maintenance status "maintained".
+%
+% The Current Maintainers of this work are
+% Heiko Oberdiek and the Oberdiek Package Support Group
+% https://github.com/ho-tex/askinclude/issues
+%
+% This work consists of the main source file askinclude.dtx
+% and the derived files
+% askinclude.sty, askinclude.pdf, askinclude.ins, askinclude.drv,
+%
+% Distribution:
+% CTAN:macros/latex/contrib/askinclude/askinclude.dtx
+% CTAN:macros/latex/contrib/askinclude/askinclude.pdf
+%
+% Unpacking:
+% (a) If askinclude.ins is present:
+% tex askinclude.ins
+% (b) Without askinclude.ins:
+% tex askinclude.dtx
+% (c) If you insist on using LaTeX
+% latex \let\install=y\input{askinclude.dtx}
+% (quote the arguments according to the demands of your shell)
+%
+% Documentation:
+% (a) If askinclude.drv is present:
+% latex askinclude.drv
+% (b) Without askinclude.drv:
+% latex askinclude.dtx; ...
+% The class ltxdoc loads the configuration file ltxdoc.cfg
+% if available. Here you can specify further options, e.g.
+% use A4 as paper format:
+% \PassOptionsToClass{a4paper}{article}
+%
+% Programm calls to get the documentation (example):
+% pdflatex askinclude.dtx
+% bibtex askinclude.aux
+% makeindex -s gind.ist askinclude.idx
+% pdflatex askinclude.dtx
+% makeindex -s gind.ist askinclude.idx
+% pdflatex askinclude.dtx
+%
+% Installation:
+% TDS:tex/latex/askinclude/askinclude.sty
+% TDS:doc/latex/askinclude/askinclude.pdf
+% TDS:source/latex/askinclude/askinclude.dtx
+%
+%<*ignore>
+\begingroup
+ \catcode123=1 %
+ \catcode125=2 %
+ \def\x{LaTeX2e}%
+\expandafter\endgroup
+\ifcase 0\ifx\install y1\fi\expandafter
+ \ifx\csname processbatchFile\endcsname\relax\else1\fi
+ \ifx\fmtname\x\else 1\fi\relax
+\else\csname fi\endcsname
+%</ignore>
+%<*install>
+\input docstrip.tex
+\Msg{************************************************************************}
+\Msg{* Installation}
+\Msg{* Package: askinclude 2019/12/09 v2.5 Interactive asking of included files}
+\Msg{************************************************************************}
+
+\keepsilent
+\askforoverwritefalse
+
+\let\MetaPrefix\relax
+\preamble
+
+This is a generated file.
+
+Project: askinclude
+Version: 2019/12/09 v2.5
+
+Copyright (C)
+ 1991-1994 Pablo A. Straub
+ 2007, 2008, 2011 Heiko Oberdiek
+ 2016-2019 Oberdiek Package Support Group
+
+This work may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either
+version 1.3c of this license or (at your option) any later
+version. This version of this license is in
+ https://www.latex-project.org/lppl/lppl-1-3c.txt
+and the latest version of this license is in
+ https://www.latex-project.org/lppl.txt
+and version 1.3 or later is part of all distributions of
+LaTeX version 2005/12/01 or later.
+
+This work has the LPPL maintenance status "maintained".
+
+The Current Maintainers of this work are
+Heiko Oberdiek and the Oberdiek Package Support Group
+https://github.com/ho-tex/askinclude/issues
+
+
+This work consists of the main source file askinclude.dtx
+and the derived files
+ askinclude.sty, askinclude.pdf, askinclude.ins, askinclude.drv,
+
+\endpreamble
+\let\MetaPrefix\DoubleperCent
+
+\generate{%
+ \file{askinclude.ins}{\from{askinclude.dtx}{install}}%
+ \file{askinclude.drv}{\from{askinclude.dtx}{driver}}%
+ \nopreamble
+ \nopostamble
+ \file{askinclude.bib}{\from{askinclude.dtx}{bib}}%
+ \usepreamble\defaultpreamble
+ \usepostamble\defaultpostamble
+ \usedir{tex/latex/askinclude}%
+ \file{askinclude.sty}{\from{askinclude.dtx}{package}}%
+}
+
+\catcode32=13\relax% active space
+\let =\space%
+\Msg{************************************************************************}
+\Msg{*}
+\Msg{* To finish the installation you have to move the following}
+\Msg{* file into a directory searched by TeX:}
+\Msg{*}
+\Msg{* askinclude.sty}
+\Msg{*}
+\Msg{* To produce the documentation run the file `askinclude.drv'}
+\Msg{* through LaTeX.}
+\Msg{*}
+\Msg{* Happy TeXing!}
+\Msg{*}
+\Msg{************************************************************************}
+
+\endbatchfile
+%</install>
+%<*bib>
+@online{texlive,
+ author={Fairbairns, Robin},
+ title={[tex-live] licence on includeonly.sty},
+ date={2007-10-13},
+ url={https://www.tug.org/pipermail/tex-live/2007-October/014928.html},
+ urldate={2011-12-02},
+}
+@online{newsthread,
+ author={Vo{\ss}, Herbert},
+ title={askinclude.sty},
+ note={Thread in newsgroup {\xnewsgroup{comp.text.tex}};
+ Message-ID: {\texttt{fev72m\$b35\$02\$2@news.t-online.com}}},
+ date={2007-10-15},
+ url={https://groups.google.com/group/comp.text.tex/browse_thread/thread/728a3e73c04c6789/349e31865c40d00c},
+ urldate={2011-12-02},
+}
+@manual{makematch,
+ author={Kastrup, David},
+ title={makematch.sty: Pattern matching with wildcards},
+ date={2007-02-23},
+ version={1.7925},
+ url={https://ctan.org/pkg/qstest},
+ urldate={2011-12-02},
+}
+@manual{excludeonly,
+ author={Luecking, Daniel H. and Arseneau, Donald},
+ title={The excludeonly package},
+ date={2003-03-14},
+ url={https://ctan.org/pkg/excludeonly},
+ urldate={2011-12-02},
+}
+%</bib>
+%<*ignore>
+\fi
+%</ignore>
+%<*driver>
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesFile{askinclude.drv}%
+ [2019/12/09 v2.5 Interactive asking of included files]%
+\documentclass{ltxdoc}
+\usepackage{holtxdoc}[2011/11/22]
+\usepackage{iftex}
+\ifluatex
+\else
+ \usepackage[T1]{fontenc}%
+ \usepackage{lmodern}%
+\fi
+\usepackage{csquotes}
+\usepackage[
+ backend=bibtex,
+ bibencoding=ascii,
+ alldates=iso,seconds=true,
+]{biblatex}[2011/11/13]
+\bibliography{oberdiek-source}
+\bibliography{askinclude}
+\begin{document}
+ \DocInput{askinclude.dtx}%
+\end{document}
+%</driver>
+% \fi
+%
+%
+%
+% \GetFileInfo{askinclude.drv}
+%
+% \title{The \xpackage{askinclude} package}
+% \date{2019/12/09 v2.5}
+% \author{
+% Pablo A. Straub\\[1ex]
+% Heiko Oberdiek\thanks
+% {Please report any issues at \url{https://github.com/ho-tex/askinclude/issues}}}
+%
+%
+% \maketitle
+%
+% \begin{abstract}
+% This package replaces \cs{includeonly} by an interactive user
+% interface.
+% \end{abstract}
+%
+% \tableofcontents
+%
+% \section{Documentation}
+%
+% \subsection{User interface}
+%
+% The \cs{include} feature of \LaTeX\ allows the division of
+% the text body in separate compilation units. It is page
+% based and stores counter settings in additional auxiliary
+% files. \cs{includeonly} limits the actually included files
+% to the ones, listed in its argument.
+%
+% Example:
+%\begin{quote}
+%\begin{verbatim}
+%\documentclass{report}
+%
+%\usepackage{askinclude}
+%
+% % Don't use \include in the preamble.
+% % Instead \input can be used or make a package
+%
+%\begin{document}
+%\include{title}
+%\include{introduction}
+%\include{summary}
+%\include{index}
+%\end{document}
+%\end{verbatim}
+%\end{quote}
+%
+% Package \xpackage{askinclude} adds an interactive user interface.
+% The user is asked which files he want to include and sets
+% \cs{includeonly} accordingly.
+%
+% The first time the package is used the question looks like:
+%\begin{quote}
+%\begin{verbatim}
+%***********************************
+%*** Package askinclude Question ***
+%***********************************
+%
+%Previous answer (noregexp):
+% [*]
+%
+%Regular expressions:
+% --> [noregexp] disabled
+% [makematch] enabled, using package `makematch'
+% [pdfmatch] enabled, using pdfTeX's \pdfmatch
+%
+%Which files do you want to include?
+% [foo,bar] comma separated file or pattern list
+% [*] all files
+% [-] no files
+% [?] ask for each file
+% [] use the previous answer
+%
+%\answer=chapter2,summary
+%\end{verbatim}
+%\end{quote}
+% Square brackets are used as quotation symbols,
+% they are not part of the answer.
+% The answer by the user follows in the last line after |\answer=|.
+% \begin{description}
+% \def\Item[#1]{\item[{[\texttt{#1}]:}]}
+% \Item[foo,bar]
+% A comma separated file list (also one file only) is passed
+% to macro \cs{includeonly} directly. If regular expression support
+% is enabled, the entries in the list are interpreted as
+% file name patterns that will be matched against the file names
+% in \cs{include}, see \hyperref[sec:regexp]{section \ref*{sec:regexp}}.
+% \Item[*] This is a shortcut for specifying \emph{all} files.
+% \Item[-] This means \emph{none} of the files is included.
+% \Item[?] The switches in single asking mode.
+% The user will be asked at each \cs{include}.
+% See section \hyperref[sec:single]{section \ref*{sec:single}}.
+% \Item[] Just pressing return (empty string) uses the default
+% answer, that was stored in the auxiliary file (\xfile{.aux})
+% of the previous \LaTeX run with package \xpackage{askinclude}.
+% Without previous runs the default is [|*|] for all files.
+% \Item[noregexp] Turns regular expression support off.
+% \Item[makematch] Enables regular expression support
+% package \xpackage{makematch} provides.
+% \Item[pdfmatch] It is shown, if \pdfTeX~1.30 or later is used.
+% It relies on an undocumented feature \cs{pdfmatch} that may
+% change in future versions of \pdfTeX.
+% \end{description}
+% Package \xpackage{askinclude} remembers the files of \cs{include}
+% in the auxiliary file and the given answer. they are
+% presented at the next run
+% at the start of the question:
+%\begin{quote}
+%\begin{verbatim}
+%***********************************
+%*** Package askinclude Question ***
+%***********************************
+%
+%Files, found by previous run in \include:
+% (-) title
+% (-) introduction
+% (-) chapter1
+% (+) chapter2
+% (-) chapter3
+% (+) summary
+%
+%Previous answer (noregexp):
+% [chapter2,summary]
+%...
+%\end{verbatim}
+%\end{quote}
+% |(+)| and |(-)| marks files that were and were not included in
+% the previous run. The file list and marks are not always correct.
+% For example, if \cs{include} statements are added or removed.
+% If the method of regular expression support is different,
+% then the marks only reflects the mode of the previous answer.
+%
+% \subsection{Single asking mode}
+% \label{sec:single}
+%
+% The special answer `|?|' trigger single asking mode,
+% at the next \cs{include} the user is asked again:
+%\begin{quote}
+%\begin{verbatim}
+%***********************************
+%*** Package askinclude Question ***
+%***********************************
+%
+%Include `title'? [y]es, [n]o, [A]ll, [N]one, [D]efault (n):
+%
+%\answer=
+%\end{verbatim}
+%\end{quote}
+% Use the letter inside the square brackets as answer.
+% An empty string uses the default answer, the letter in parentheses.
+% The answers are:
+% \begin{description}
+% \def\Item[#1]{\item[{[\texttt{#1}]:}]}
+% \Item[y] The file is included.
+% \Item[n] The file is excluded.
+% \Item[A] This file and all following files are included.
+% \Item[N] This file and all following files are excluded.
+% \Item[D] Use the default answer for this and all following files.
+% \end{description}
+% If the file is known from the previous run, then the
+% default is `|y|' or `|n|' corresponding to the mark
+% `|(+)|' or `|(-)|' in the list of previous files.
+% Otherwise `|y|' is used as default.
+%
+% \subsection{Regular expressions}
+% \label{sec:regexp}
+%
+% Three methods are available that can also set by package options:
+% \begin{description}
+% \def\Item[#1]{\item[\xoption{#1}:]}
+% \Item[noregexp] Regular expression support is disabled.
+% \Item[makematch] Use package \xpackage{makematch}.
+% \Item[pdfmatch] Use \pdfTeX's \cs{pdfmatch} if available.
+% \end{description}
+% Without options the value remembered in the auxiliary file
+% is used, otherwise the default is \xoption{noregexp}.
+%
+% \subsubsection{Method \xoption{makematch}}
+%
+% Package \xpackage{makematch} (part of \xpackage{qstest}), written
+% by David Kastrup provides pattern matching based on wildcards:
+% \begin{description}
+% \item[{[\texttt{*}]}:] The star matches zero or more characters.
+% Thus a lonely star machtes anything.
+% \item[{[\texttt{!}]}:] The exclamation mark at the begin of a
+% pattern negates it, thus the matching files are excluded.
+% \end{description}
+% The pattern list is evaluated for a file name from left to
+% right. Always a file name must match the whole pattern.
+% The file is included if it is matched by a pattern and
+% not excluded afterwards. Examples:
+% \begin{quote}
+% \def\no{\textrm{$\emptyset$}}
+% \begin{tabular}{>{\ttfamily}l|>{\ttfamily}l|>{\ttfamily}l}
+% \textrm{Pattern list} & \textrm{File names} & \textrm{Result}\\
+% \hline
+% foobar & foobar,dummy & foobar\\
+% foo* & foobar,xfoobar & foobar\\
+% \relax *foo* & xfoobar & xfoobar\\
+% f*b*r & foobar & foobar\\
+% \relax * & any & any\\
+% !foobar & foobar,other & other\\
+% !foo* & xfoobar & xfoobar\\
+% in*,!*dex & intro,index & intro\\
+% !index,in* & intro,index & intro,index\\
+% \relax *,!chap2 & chap1,chap2,chap3 & chap1,chap3\\
+% \end{tabular}
+% \end{quote}
+% The example in the last line shows, how the behaviour of package
+% \xpackage{excludeonly} \cite{excludeonly} can be simulated.
+%
+% The documentation of package \xpackage{makematch} tells the
+% the empty pattern does not match anything. But if you answer
+% the question with an empty string the answer of the previous
+% run is used. Also curly braces are not reliable because the
+% can get stripped during the processing of the answer.
+% Using a pair of empty curly braces or the comma for two empty
+% patterns currently works, but this is specific for the current
+% implementation and may change in future. But the special
+% answer `-' is available.
+%
+% \subsubsection{Method \xoption{pdfmatch}}
+%
+% In \pdfTeX\ 1.30 the new primitive \cs{pdfmatch} was introduced.
+% It is not documented yet, because it was not decided if it remains
+% and which implementation of regular expressions should be used.
+% Thus the situation may change in later versions of \pdfTeX.
+% Currently (1.30 until 1.40) it uses a library for POSIX 1003.2 regular
+% expressions, see manual page ``regex(7)''.
+%
+% If a pattern in the pattern list is invalid, the package prints
+% a warning and removes the pattern from the list. Actually there
+% are two warnings, the other warning is generated by \pdfTeX\ itself.
+%
+% In opposite to \xoption{makematch} the pattern only needs to
+% match the specified part of the file name.
+% For matching the whole name, the symbols `|^|' and `|$|' for
+% begin and end of string must be included.
+%
+% Additionally an initial exclamation mark `|!|' implements the
+% same logic as method \xoption{makematch}. The match result is
+% inverted, the matched file excluded.
+%
+% Examples:
+% \begin{quote}
+% \def\no{\textrm{$\emptyset$}}
+% \begin{tabular}{>{\ttfamily}l|>{\ttfamily}l|>{\ttfamily}l}
+% \textrm{Pattern list} & \textrm{File names} & \textrm{Result}\\
+% \hline
+% foobar & foobar,dummy & foobar\\
+% foo.* & foobar,xfoobar & foobar,xfoobar\\
+% |^|foo.* & foobar,xfoobar & foobar\\
+% foo|$| & foo,foobar & foo\\
+% fo?bar & fbar,fobar,foobar & fbar,fobar\\
+% fo+bar & fbar,fobar,foobar & fobar,foobar\\
+% fo*bar & fbar,fobar,foobar & fbar,fobar,foobar\\
+% chap3 & chap3,chap32 & chap1,chap3,chap32\\
+% chap[13] & chap1,chap2,chap3 & chap1,chap3\\
+% chap(1\string|3)|$| & chap1,chap3,chap33 & chap1,chap3\\
+% .* & any & any\\
+% !foobar & foobar,other & other\\
+% in.*,!dex & intro,index & intro\\
+% !index,in.* & intro,index & intro,index\\
+% .*,!chap2 & chap1,chap2,chap3 & chap1,chap3\\
+% .*,!bla & foo,bla,blabla & foo\\
+% .*,!|^|bla|$| & foo,bla,blabla & foo,blabla\\
+% \end{tabular}
+% \end{quote}
+% The example in the last line shows, how the behaviour of package
+% \xpackage{excludeonly} \cite{excludeonly} can be simulated.
+% As the third last line shows, that sometimes `|^|' and `|$|' can
+% be omitted, but this will not work always, shown in the second
+% last line.
+%
+% \subsection{History}
+%
+% Package \xpackage{askinclude} was invented by Pablo A. Straub in 1991
+% and maintained until 1994.
+% ^^A Email address: pablo.straub \symbol{64} gmail.com
+%
+% In October 2007 it was removed from ``TeX Live'' because of
+% the no-commercial license \cite{texlive}. Herbert Vo\ss\ initiated
+% a search for the author in the newsgroup \xnewsgroup{comp.text.tex}
+% \cite{newsthread} to ask him to change the license.
+%
+% It seems that the author could not be reached any more.
+% Joseph Wright suggested a reimplementation that I (HO) have done
+% as package \xpackage{askinc}. Soon it was enhanced by
+% feature requests.
+%
+% Then Ulrike Fischer found email addresses of the original author
+% and Jim Hefferon succeeded in contacting him. He allowed a change
+% of the license to LPPL and the transfer of the maintainership
+% to someone else.
+%
+% Thus I merged both packages as \xpackage{askinclude} in a new
+% major version 2. The license is LPPL.
+%
+% \subsection{New features of version 2}
+%
+% \begin{itemize}
+% \item License is now LPPL.
+% \item A list of \cs{include} files that are detected by the previous
+% run is printed before the question.
+% \item If the special answer `|?|' is given, then the user is
+% asked at each \cs{include}.
+% \item Support for regular expressions.
+% \item The remaining stuff in the \xfile{.aux} file does not
+% cause errors, if the package is removed.
+% \item The use of \cs{includeonly} before the package loading time
+% is detected and respected by taking precedence. After the package
+% is loaded, \cs{includeonly} is disabled and prints a warning.
+% \end{itemize}
+%
+% \subsection{Compatibility to version 1}
+%
+% \begin{itemize}
+% \item The user interface of version 1 with its special answers
+% `|*|', `|-|', and `' remain unchanged, but it is extended by
+% version 2 with the special answer `|?|' and support for
+% regular expressions can be enabled.
+% \item As reimplementation the internal macros have changed of course.
+% \item \xfile{.aux} files that are written by version 1.x will work
+% with version 2.x because \cs{@includeonly} is recognized.
+% \item \LaTeX\ 2.09: The package works as \cs{documentstyle} option
+% in compatibility mode of \LaTeXe. It is possible that it
+% will not work in pure \LaTeX\ 2.09.
+% \end{itemize}
+%
+% \StopEventually{
+% }
+%
+% \section{Implementation}
+%
+% \subsection{Header and catcodes}
+%
+% \begin{macrocode}
+%<*package>
+\NeedsTeXFormat{LaTeX2e}
+\begingroup\catcode61\catcode48\catcode32=10\relax%
+ \catcode13=5 % ^^M
+ \endlinechar=13 %
+ \catcode123=1 % {
+ \catcode125=2 % }
+ \catcode64=11 % @
+ \def\x{\endgroup
+ \expandafter\edef\csname AskInc@AtEnd\endcsname{%
+ \endlinechar=\the\endlinechar\relax
+ \catcode13=\the\catcode13\relax
+ \catcode32=\the\catcode32\relax
+ \catcode35=\the\catcode35\relax
+ \catcode61=\the\catcode61\relax
+ \catcode64=\the\catcode64\relax
+ \catcode123=\the\catcode123\relax
+ \catcode125=\the\catcode125\relax
+ }%
+ }%
+\x\catcode61\catcode48\catcode32=10\relax%
+\catcode13=5 % ^^M
+\endlinechar=13 %
+\catcode35=6 % #
+\catcode64=11 % @
+\catcode123=1 % {
+\catcode125=2 % }
+\def\TMP@EnsureCode#1#2{%
+ \edef\AskInc@AtEnd{%
+ \AskInc@AtEnd
+ \catcode#1=\the\catcode#1\relax
+ }%
+ \catcode#1=#2\relax
+}
+\TMP@EnsureCode{33}{12}% !
+\TMP@EnsureCode{39}{12}% '
+\TMP@EnsureCode{40}{12}% (
+\TMP@EnsureCode{41}{12}% )
+\TMP@EnsureCode{42}{12}% *
+\TMP@EnsureCode{43}{12}% +
+\TMP@EnsureCode{44}{12}% ,
+\TMP@EnsureCode{45}{12}% -
+\TMP@EnsureCode{46}{12}% .
+\TMP@EnsureCode{47}{12}% /
+\TMP@EnsureCode{58}{12}% :
+\TMP@EnsureCode{62}{12}% >
+\TMP@EnsureCode{63}{12}% ?
+\TMP@EnsureCode{91}{12}% [
+\TMP@EnsureCode{93}{12}% ]
+\TMP@EnsureCode{96}{12}% `
+\edef\AskInc@AtEnd{\AskInc@AtEnd\noexpand\endinput}
+\ProvidesPackage{askinclude}%
+ [2019/12/09 v2.5 Interactive asking of included files]%
+% \end{macrocode}
+%
+% Luatex compat
+% \begin{macrocode}
+\ifx\pdfextension\@undefined\else
+ \protected\def\pdflastobj {\numexpr\pdffeedback lastobj\relax}
+ \protected\def\pdfnames {\pdfextension names }
+ \protected\def\pdfobj {\pdfextension obj }
+ \let\pdfoutput \outputmode
+\fi
+% \end{macrocode}
+%
+% \subsection{Delay action after preamble}
+%
+% \begin{macro}{\AskInc@AtBeginDocument}
+% Some actions such as \xfile{.aux} file writing cannot be
+% performed in the preamble. \cs{AtBeginDocument} delays
+% such action until |\begin{document}|. However \cs{AtBeginDocument}
+% must not be used after that time (\cs{@onlypreamble}).
+% Thus \cs{AskInc@AtBeginDocument} uses \cs{AtBeginDocument}
+% in the preamble and afterwards executes the code immediately.
+% \begin{macrocode}
+\AtBeginDocument{%
+ \let\AskInc@AtBeginDocument\@firstofone
+}
+\providecommand*{\AskInc@AtBeginDocument}{\AtBeginDocument}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsection{Write entry in \xfile{.aux} file}
+%
+% \begin{macro}{\AskInc@WriteAux}
+% The first argument is written to the main \xfile{.aux} file
+% and the second argument is executed if writing was possible.
+% Remember \cs{nofiles} prevents writing to auxiliary files.
+% \begin{macrocode}
+\def\AskInc@WriteAux#1#2{%
+ \AskInc@AtBeginDocument{%
+ \if@filesw
+ \immediate\write\@mainaux{#1}%
+ #2%
+ \fi
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsection{Remember \cs{include} files}
+%
+% \begin{macro}{\AskInc@CharHash}
+% \begin{macrocode}
+\edef\AskInc@CharHash{\string#}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\AskInc@WriteDefAddList}
+% \begin{macrocode}
+\def\AskInc@WriteDefAddList{%
+ \AskInc@WriteAux{%
+% \end{macrocode}
+% \begin{macro}{\AskInc@AddList}
+% \begin{macrocode}
+ \string\providecommand*\string\AskInc@AddList[2]{%
+ \string\ifcase\string\ifx\AskInc@CharHash1\string\@undefined
+ \string\else
+ \string\ifx\AskInc@CharHash1\string\relax
+ \string\else
+ \string\ifx\AskInc@CharHash1\string\@empty
+ \string\else
+ 1%
+ \string\fi
+ \string\fi
+ \string\fi
+ 0 %
+ \string\gdef\AskInc@CharHash1{\AskInc@CharHash2}%
+ \string\else
+ \string\g@addto@macro\AskInc@CharHash1{,\AskInc@CharHash2}%
+ \string\fi
+ }%
+% \end{macrocode}
+% \end{macro}
+% \begin{macrocode}
+ }{%
+ \global\let\AskInc@WriteDefAddList\relax
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@WriteDefAddFile}
+% \begin{macrocode}
+\def\AskInc@WriteDefAddFile{%
+ \AskInc@WriteDefAddList
+ \AskInc@WriteAux{%
+% \end{macrocode}
+% \begin{macro}{\AskInc@AddFile}
+% \begin{macrocode}
+ \string\providecommand\string\AskInc@AddFile{%
+ \string\AskInc@AddList\string\AskInc@Files
+ }%
+% \end{macrocode}
+% \end{macro}
+% \begin{macrocode}
+ }{%
+ \global\let\AskInc@WriteDefAddFile\relax
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@AddFile}
+% \begin{macrocode}
+\AtBeginDocument{%
+ \global\let\AskInc@AddFile\@gobble
+}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@WriteAddFile}
+% \begin{macrocode}
+\def\AskInc@WriteAddFile#1{%
+ \AskInc@WriteDefAddFile
+ \AskInc@WriteAux{%
+ \string\AskInc@AddFile{#1}%
+ }{}%
+}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@Files}
+% \begin{macrocode}
+\providecommand*{\AskInc@Files}{}
+% \end{macrocode}
+% \end{macro}
+%
+% \paragraph{Summary:}
+% Now \cs{AskInc@Files} is always defined
+% and either empty or contains a comma separated list of
+% \cs{include} files of previous run.
+%
+% The \cs{include} files are remembered by using
+% \cs{AskInc@WriteAddFile} at each \cs{include}.
+%
+% \subsection{Redefine \cs{include}}
+%
+% \begin{macro}{\AskInc@OrgInclude}
+% \begin{macrocode}
+\newcommand{\AskInc@OrgInclude}{}
+\let\AskInc@OrgInclude\include
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@AskFile}
+% \begin{macrocode}
+\let\AskInc@AskFile\@gobble
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@MatchFile}
+% \begin{macrocode}
+\let\AskInc@MatchFile\@gobble
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\include}
+% \begin{macrocode}
+\renewcommand*{\include}[1]{%
+ \AskInc@WriteAddFile{#1}%
+ \AskInc@AskFile{#1}%
+ \AskInc@MatchFile{#1}%
+ \AskInc@OrgInclude{#1}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsection{Store answer and match method in \xfile{.aux} file}
+%
+% \begin{macrocode}
+\AtEndOfPackage{%
+ \AtBeginDocument{%
+ \@ifundefined{AskInc@Answer}{}{%
+ \AskInc@WriteAux{%
+ \string\gdef\string\AskInc@Answer{\AskInc@Answer}%
+ }{}%
+ }%
+ \@ifundefined{AskInc@MatchMethod}{}{%
+ \AskInc@WriteAux{%
+ \string\gdef\string\AskInc@MatchMethod{\AskInc@MatchMethod}%
+ }{}%
+ }%
+ }%
+}
+% \end{macrocode}
+%
+% \subsection{Support for \cs{@includeonly}}
+%
+% \begin{macro}{\@includeonly}
+% Macro \cs{@includeonly} is defined for compatiblity reasons only,
+% if the \xfile{.aux} file was written by versions before 2 of package
+% \xpackage{askinclude}.
+% \begin{macrocode}
+\providecommand*{\@includeonly}[1]{%
+ \gdef\AskInc@Answer{#1}%
+ \ifx\AskInc@Answer\@empty
+ \gdef\AskInc@Answer{-}%
+ \fi
+ \global\let\AskInc@MatchMethod\@empty
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsection{Stop if \cs{includeonly} is active}
+%
+% If \cs{includeonly} is used before, the questions are skipped
+% and the data in the main auxiliary file is preserved.
+% \begin{macrocode}
+\if@partsw
+ \PackageWarningNoLine{askinclude}{%
+ Previous \string\includeonly\space detected,\MessageBreak
+ therefore asking for files is suppressed%
+ }%
+% \end{macrocode}
+% Dummy options.
+% \begin{macrocode}
+ \DeclareOption{makematch}{}%
+ \DeclareOption{pdfmatch}{}%
+ \DeclareOption{noregexp}{}%
+ \ProcessOptions*%
+% \end{macrocode}
+% Preserve \cs{AskInc@MatchFiles}.
+% \begin{macrocode}
+ \@ifundefined{AskInc@MatchFiles}{%
+ }{%
+ \ifx\AskInc@MatchMethod\@empty
+ \else
+ \AskInc@WriteAux{%
+ \string\gdef\string\AskInc@MatchFiles{\AskInc@MatchFiles}%
+ }{}%
+ \fi
+ }%
+ \expandafter\AskInc@AtEnd
+\fi%
+% \end{macrocode}
+%
+% \subsection{\cs{includeonly}}
+%
+% \begin{macro}{\AskInc@OrgIncludeOnly}
+% \begin{macrocode}
+\newcommand{\AskInc@OrgIncludeOnly}{}%
+\let\AskInc@OrgIncludeOnly\includeonly
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\includeonly}
+% \begin{macrocode}
+\renewcommand*{\includeonly}[1]{%
+ \PackageWarning{askinclude}{%
+ \string\includeonly\space is managed by package `askinclude',%
+ \MessageBreak
+ therefore it is ignored%
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsection{Options}
+%
+% \begin{macro}{\AskInc@StringNoRegExp}
+% \begin{macrocode}
+\def\AskInc@StringNoRegExp{noregexp}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@StringMakeMatch}
+% \begin{macrocode}
+\def\AskInc@StringMakeMatch{makematch}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@StringPdfMatch}
+% \begin{macrocode}
+\def\AskInc@StringPdfMatch{pdfmatch}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\ifAskInc@PdfMatchAvailable}
+% \begin{macrocode}
+\newif\ifAskInc@PdfMatchAvailable
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname pdfmatch\endcsname\relax
+\else
+ \AskInc@PdfMatchAvailabletrue
+\fi
+% \end{macrocode}
+% \end{macro}
+% \begin{macrocode}
+\DeclareOption{makematch}{%
+ \let\AskInc@MatchOption\AskInc@StringMakeMatch
+}
+\ifAskInc@PdfMatchAvailable
+ \DeclareOption{pdfmatch}{%
+ \let\AskInc@MatchOption\AskInc@StringPdfMatch
+ }%
+\else
+ \DeclareOption{pdfmatch}{%
+ \PackageWarningNoLine{askinclude}{%
+ Option `pdfmatch' is not available because\MessageBreak
+ your pdfTeX does not provide \string\pdfmatch
+ }%
+ }%
+\fi
+\DeclareOption{noregexp}{%
+ \let\AskInc@MatchOption\@empty
+}
+\ProcessOptions*
+% \end{macrocode}
+%
+% \subsection{Strings}
+%
+% \begin{macro}{\AskInc@CharAsterisk}
+% \begin{macrocode}
+\def\AskInc@CharAsterisk{*}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@CharMinus}
+% \begin{macrocode}
+\def\AskInc@CharMinus{-}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@CharPlus}
+% \begin{macrocode}
+\def\AskInc@CharPlus{+}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@CharQuestion}
+% \begin{macrocode}
+\def\AskInc@CharQuestion{?}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@CharExclam}
+% \begin{macrocode}
+\def\AskInc@CharExclam{!}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@CharYes}
+% \begin{macrocode}
+\def\AskInc@CharYes{y}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@CharNo}
+% \begin{macrocode}
+\def\AskInc@CharNo{n}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@CharAll}
+% \begin{macrocode}
+\def\AskInc@CharAll{A}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@CharNone}
+% \begin{macrocode}
+\def\AskInc@CharNone{N}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@CharDefault}
+% \begin{macrocode}
+\def\AskInc@CharDefault{D}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsection{Set defaults}
+%
+% \begin{macro}{\AskInc@SanitizeAnswer}
+% \begin{macrocode}
+\def\AskInc@SanitizeAnswer#1#2{%
+ \begingroup
+ \escapechar=`\\%
+ \edef\[{\string\[}%
+ \edef\]{\string\]}%
+ \edef\({\string\(}%
+ \edef\){\string\)}%
+ \edef\*{\string\*}%
+ \edef\+{\string\+}%
+ \edef\?{\string\?}%
+ \edef\|{\string\|}%
+ \edef\^{\string\^}%
+ \edef\${\string\$}%
+ \edef\{{\string\{}%
+ \edef\}{\string\}}%
+ \edef\.{\string\.}%
+ \xdef#1{%
+ \expandafter\expandafter\expandafter\zap@space
+ \expandafter#2\space\@empty
+ }%
+ \endgroup
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macrocode}
+\AtBeginDocument{%
+ \@ifundefined{AskInc@Answer}{%
+ \global\let\AskInc@Answer\AskInc@CharAsterisk
+ }{%
+ \AskInc@SanitizeAnswer\AskInc@Answer\AskInc@Answer
+ }%
+ \global\let\AskInc@PreviousAnswer\AskInc@Answer
+ \@ifundefined{AskInc@MatchMethod}{%
+ \global\let\AskInc@MatchMethod\@empty
+ }{}%
+ \global\let\AskInc@PreviousMatchMethod\AskInc@MatchMethod
+ \@ifundefined{AskInc@MatchOption}{%
+ \let\AskInc@MatchOption\AskInc@MatchMethod
+ }{}%
+ \ifx\AskInc@MatchOption\AskInc@StringPdfMatch
+ \ifAskInc@PdfMatchAvailable
+ \else
+ \let\AskInc@MatchOption\@empty
+ \fi
+ \fi
+ \@ifundefined{AskInc@MatchFiles}{%
+ \let\AskInc@MatchFiles\@empty
+ }{}%
+}
+% \end{macrocode}
+%
+% \subsection{Questions}
+%
+% \subsubsection{Generic question header}
+%
+% \begin{macro}{\AskInc@QuestionHeader}
+% \begin{macrocode}
+\def\AskInc@QuestionHeader{%
+ \typeout{}%
+ \typeout{***********************************}%
+ \typeout{*** Package askinclude Question ***}%
+ \typeout{***********************************}%
+ \typeout{}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsubsection{Display files}
+%
+% \begin{macro}{\AskInc@TypeoutFiles}
+% \begin{macrocode}
+\def\AskInc@TypeoutFiles{%
+ \global\let\AskInc@PreviousMatches\@empty
+ \ifx\AskInc@Files\@empty
+ \else
+ \typeout{Files, found by previous run in \string\include:}%
+ \@for\AskInc@File:=\AskInc@Files\do{%
+ \ifx\AskInc@Answer\AskInc@CharAsterisk
+ \let\AskInc@Mark\AskInc@CharPlus
+ \else
+ \let\AskInc@Mark\AskInc@CharMinus
+ \ifx\AskInc@Answer\AskInc@CharMinus
+ \else
+ \ifx\AskInc@MatchMethod\@empty
+ \expandafter\@firstoftwo
+ \else
+ \expandafter\@secondoftwo
+ \fi
+ {\@for\AskInc@Temp:=\AskInc@Answer}%
+ {\@for\AskInc@Temp:=\AskInc@MatchFiles}%
+ \do{%
+ \ifx\AskInc@File\AskInc@Temp
+ \let\AskInc@Mark\AskInc@CharPlus
+ \fi
+ }%
+ \fi
+ \fi
+ \typeout{ \@spaces(\AskInc@Mark) \AskInc@File}%
+ \ifx\AskInc@Mark\AskInc@CharPlus
+ \ifx\AskInc@PreviousMatches\@empty
+ \global\let\AskInc@PreviousMatches\AskInc@File
+ \else
+ \expandafter\g@addto@macro
+ \expandafter\AskInc@PreviousMatches{%
+ \expandafter,\AskInc@File
+ }%
+ \fi
+ \fi
+ }%
+ \typeout{}%
+ \fi
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsubsection{Previous answer}
+%
+% \begin{macro}{\AskInc@TypeoutPreviousAnswer}
+% \begin{macrocode}
+\def\AskInc@TypeoutPreviousAnswer{%
+ \typeout{%
+ Previous answer (%
+ \ifx\AskInc@MatchMethod\@empty
+ noregexp%
+ \else
+ \AskInc@MatchMethod
+ \fi
+ ):%
+ }%
+ \typeout{ \@spaces[\AskInc@Answer]}%
+ \typeout{}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsubsection{Current regular expression support}
+%
+% \begin{macro}{\AskInc@TypeoutMatchMethod}
+% \begin{macrocode}
+\def\AskInc@TypeoutMatchMethod{%
+ \typeout{Regular expressions:}%
+ \AskInc@TypeoutMethod\@empty{noregexp}{%
+ \space disabled%
+ }%
+ \AskInc@TypeoutMethod\AskInc@StringMakeMatch{makematch}{%
+ enabled, using package `makematch'%
+ }%
+ \ifAskInc@PdfMatchAvailable
+ \AskInc@TypeoutMethod\AskInc@StringPdfMatch{pdfmatch}{%
+ \space enabled, using pdfTeX's \string\pdfmatch
+ }%
+ \fi
+ \typeout{}%
+}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@TypeoutMethod}
+% \begin{macrocode}
+\def\AskInc@TypeoutMethod#1#2#3{%
+ \typeout{%
+ \ifx#1\AskInc@MatchOption \space--> \else\@spaces\space\fi
+ [#2] #3% hash-ok
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsubsection{Main question text}
+%
+% \begin{macro}{\AskInc@TypeoutMainQuestion}
+% \begin{macrocode}
+\def\AskInc@TypeoutMainQuestion{%
+ \typeout{Which files do you want to include?}%
+ \typeout{ \@spaces[foo,bar] \space\space
+ comma separated file or pattern list}%
+ \typeout{ \@spaces[*] \@spaces\@spaces all files}%
+ \typeout{ \@spaces[-] \@spaces\@spaces no files}%
+ \typeout{ \@spaces[?] \@spaces\@spaces ask for each file}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsubsection{Main question}
+%
+% \begin{macro}{\AskInc@MainQuestion}
+% \begin{macrocode}
+\def\AskInc@MainQuestion{%
+ \AskInc@QuestionHeader
+ \AskInc@TypeoutFiles
+ \AskInc@TypeoutPreviousAnswer
+ \AskInc@TypeoutMatchMethod
+ \AskInc@TypeoutMainQuestion
+ \begingroup
+ \@makeother\*%
+ \@makeother\-%
+ \@makeother\?%
+ \@makeother\,%
+ \@makeother\!%
+ \@makeother\^%
+ \@makeother\$%
+ \@makeother\(%
+ \@makeother\)%
+ \@makeother\+%
+ \@makeother\[%
+ \@makeother\]%
+ \@makeother\\%
+ \@makeother\|%
+ \@makeother\:%
+ \@makeother\.%
+ \typein[\answer]%
+ { \@spaces[] \space\@spaces\@spaces use the previous answer}%
+ \typeout{}%
+ \AskInc@SanitizeAnswer\AskInc@@Answer\answer
+ \endgroup
+ \let\AskInc@Next\AskInc@MainQuestion
+ \ifx\AskInc@@Answer\AskInc@StringNoRegExp
+ \let\AskInc@MatchOption\@empty
+ \else
+ \ifx\AskInc@@Answer\AskInc@StringMakeMatch
+ \let\AskInc@MatchOption\AskInc@StringMakeMatch
+ \else
+ \ifx\AskInc@@Answer\AskInc@StringPdfMatch
+ \ifAskInc@PdfMatchAvailable
+ \let\AskInc@MatchOption\AskInc@StringPdfMatch
+ \else
+ \PackageWarning{askinclude}{%
+ Method `pdfmatch' is not available because\MessageBreak
+ your pdfTeX does not provide \string\pdfmatch
+ }%
+ \let\AskInc@MatchOption\@empty
+ \fi
+ \else
+ \ifx\AskInc@@Answer\@empty
+ \global\let\AskInc@@Answer\AskInc@Answer
+ \fi
+ \let\AskInc@Next\AskInc@MainAnswer
+ \fi
+ \fi
+ \fi
+ \AskInc@Next
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsection{Evaluate answer of main question}
+%
+% \begin{macro}{\AskInc@MainAnswer}
+% \begin{macrocode}
+\def\AskInc@MainAnswer{%
+ \ifx\AskInc@@Answer\AskInc@CharQuestion
+ \global\let\AskInc@Answer\@empty
+ \global\let\AskInc@MatchMethod\@empty
+ \global\let\AskInc@AskFile\AskInc@DoAskFile
+ \AskInc@OrgIncludeOnly{}%
+ \else
+ \global\let\AskInc@Answer\AskInc@@Answer
+ \ifx\AskInc@@Answer\AskInc@CharAsterisk
+ \global\let\AskInc@MatchMethod\@empty
+ \else
+ \ifx\AskInc@@Answer\AskInc@CharMinus
+ \global\let\AskInc@MatchMethod\@empty
+ \AskInc@OrgIncludeOnly{}%
+ \else
+ \global\let\AskInc@MatchMethod\AskInc@MatchOption
+ \ifx\AskInc@MatchOption\@empty
+ \expandafter\AskInc@OrgIncludeOnly\expandafter{%
+ \AskInc@Answer
+ }%
+ \else
+ \AskInc@MatchInit
+ \AskInc@OrgIncludeOnly{}%
+ \fi
+ \fi
+ \fi
+ \fi
+ \let\AskInc@Include\AskInc@DoInclude
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\AskInc@MatchInit}
+% \begin{macrocode}
+\def\AskInc@MatchInit{%
+ \RequirePackage{kvsetkeys}[2007/09/29]%
+ \expandafter\comma@normalize\expandafter{\AskInc@Answer}%
+ \global\let\AskInc@MatchList\comma@list
+% \end{macrocode}
+% \begin{macro}{\AskInc@MatchFile}
+% \begin{macrocode}
+ \def\AskInc@MatchFile##1{%
+ \AskInc@DoMatch{##1}{%
+ \AskInc@WriteAddMatch{##1}%
+ \ifx\@partlist\@empty
+ \gdef\@partlist{##1}%
+ \else
+ \g@addto@macro\@partlist{,##1}%
+ \fi
+ }%
+ }%
+% \end{macrocode}
+% \end{macro}
+% \begin{macrocode}
+ \ifx\AskInc@MatchMethod\AskInc@StringMakeMatch
+ \AskInc@MakeMatchInit
+ \else
+ \AskInc@PdfMatchInit
+ \fi
+ \let\AskInc@MatchInit\@undefined
+}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@MakeMatchInit}
+% \begin{macrocode}
+\def\AskInc@MakeMatchInit{%
+ \RequirePackage{makematch}%
+% \end{macrocode}
+% \begin{macro}{\AskInc@DoMatch}
+% \begin{macrocode}
+ \def\AskInc@DoMatch##1{%
+ \def\AskInc@Temp{%
+ \MakeMatcher[,]\AskInc@Temp
+ }%
+ \expandafter\AskInc@Temp\expandafter{\AskInc@MatchList}%
+ \AskInc@Temp{{##1}}\@firstofone\@gobble
+ }%
+% \end{macrocode}
+% \end{macro}
+% \begin{macrocode}
+ \let\AskInc@MakeMatchInit\@undefined
+}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@PdfMatchInit}
+% \begin{macrocode}
+\def\AskInc@PdfMatchInit{%
+% \end{macrocode}
+% \begin{macro}{\ifAskInc@Found}
+% \begin{macrocode}
+ \newif\ifAskInc@Found
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@DoMatch}
+% \begin{macrocode}
+ \def\AskInc@DoMatch##1{%
+ \AskInc@Foundfalse
+ \expandafter\comma@parse@normalized\expandafter
+ {\AskInc@MatchList}{\AskInc@CheckMatch{##1}}%
+ \ifAskInc@Found
+ \expandafter\@firstofone
+ \else
+ \expandafter\@gobble
+ \fi
+ }%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@CheckMatch}
+% \begin{macrocode}
+ \def\AskInc@CheckMatch##1##2{%
+ \AskInc@@CheckMatch##2\@empty\@nil{##1}%
+ }%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@@CheckMatch}
+% \begin{macrocode}
+ \def\AskInc@@CheckMatch##1##2\@nil##3{%
+ \def\AskInc@Temp{##1}%
+ \ifx\AskInc@Temp\AskInc@CharExclam
+ \ifcase\pdfmatch{##2}{##3}=1 %
+ \or
+ \AskInc@Foundfalse
+ \else
+ \AskInc@InvalidPattern{##2}{##1##2}%
+ \fi
+ \else
+ \ifcase\pdfmatch{##1##2}{##3} %
+ \or
+ \AskInc@Foundtrue
+ \else
+ \AskInc@InvalidPattern{##1##2}{##1##2}%
+ \fi
+ \fi
+ }%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@InvalidPattern}
+% Prints a warning with the regular expression and
+% removes it from the list to prevent further warnings
+% for the same expression.
+% \begin{macrocode}
+ \def\AskInc@InvalidPattern##1##2{%
+ \edef\AskInc@Temp{##1}%
+ \PackageWarningNoLine{askinclude}{%
+ Invalid pattern `\AskInc@Temp' for \string\pdfmatch
+ }%
+ \edef\AskInc@Temp{##2}%
+ \global\expandafter\let\expandafter\AskInc@MatchList
+ \expandafter\@empty
+ \expandafter\comma@parse@normalized\expandafter
+ {\AskInc@MatchList}\AskInc@FilterPattern
+ }%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@FilterPattern}
+% \begin{macrocode}
+ \def\AskInc@FilterPattern##1{%
+ \edef\AskInc@Pattern{##1}%
+ \ifx\AskInc@Temp\AskInc@Pattern
+ \else
+ \ifx\AskInc@MatchList\@empty
+ \global\let\AskInc@MatchList\AskInc@Pattern
+ \else
+ \expandafter\g@addto@macro\expandafter\AskInc@MatchList{%
+ \expandafter,\AskInc@Pattern
+ }%
+ \fi
+ \fi
+ }%
+% \end{macrocode}
+% \end{macro}
+% \begin{macrocode}
+ \let\AskInc@PdfMatchInit\@undefined
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\AskInc@WriteDefAddMatch}
+% \begin{macrocode}
+\def\AskInc@WriteDefAddMatch{%
+ \AskInc@WriteDefAddList
+ \AskInc@WriteAux{%
+% \end{macrocode}
+% \begin{macro}{\AskInc@AddMatch}
+% \begin{macrocode}
+ \string\providecommand\string\AskInc@AddMatch{%
+ \string\AskInc@AddList\string\AskInc@MatchFiles
+ }%
+% \end{macrocode}
+% \end{macro}
+% \begin{macrocode}
+ }{%
+ \global\let\AskInc@WriteDefAddMatch\relax
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@AddMatch}
+% \begin{macrocode}
+\AtBeginDocument{%
+ \global\let\AskInc@AddMatch\@gobble
+}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@WriteAddMatch}
+% \begin{macrocode}
+\def\AskInc@WriteAddMatch#1{%
+ \AskInc@WriteDefAddMatch
+ \AskInc@WriteAux{%
+ \string\AskInc@AddMatch{#1}%
+ }{}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\AskInc@SaveAnswer}
+% \begin{macrocode}
+\def\AskInc@SaveAnswer{%
+ \AskInc@WriteAux{%
+ \string\gdef\string\AskInc@Answer{\AskInc@Answer}%
+ }{}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsection{Ask for each file}
+%
+% \begin{macro}{\AskInc@PreviousAnswer}
+% \begin{macrocode}
+\@ifundefined{AskInc@PreviousAnswer}{%
+ \let\AskInc@PreviousAnswer\AskInc@CharAsterisk
+}{}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@PreviousMatchMethod}
+% \begin{macrocode}
+\@ifundefined{AskInc@PreviousMatchMethod}{%
+ \let\AskInc@PreviousMatchMethod\@empty
+}{}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@DoAskFile}
+% \begin{macrocode}
+\def\AskInc@DoAskFile#1{%
+ \edef\AskInc@File{#1}%
+ \ifx\AskInc@PreviousAnswer\AskInc@CharAsterisk
+ \let\AskInc@Default\AskInc@CharYes
+ \else
+ \let\AskInc@Default\AskInc@CharNo
+ \ifx\AskInc@PreviousAnswer\AskInc@CharMinus
+ \else
+ \ifx\AskInc@PreviousMatchMethod\@empty
+ \expandafter\@firstoftwo
+ \else
+ \expandafter\@secondoftwo
+ \fi
+ {\@for\AskInc@Temp:=\AskInc@PreviousAnswer}%
+ {\@for\AskInc@Temp:=\AskInc@MatchFiles}%
+ \do{%
+ \ifx\AskInc@Temp\AskInc@File
+ \let\AskInc@Default\AskInc@CharYes
+ \fi
+ }%
+ \fi
+ \ifx\AskInc@Default\AskInc@CharNo
+ \let\AskInc@Default\AskInc@CharYes
+ \@for\AskInc@Temp:=\AskInc@Files\do{%
+ \ifx\AskInc@Temp\AskInc@File
+ \let\AskInc@Default\AskInc@CharNo
+ \fi
+ }%
+ \fi
+ \fi
+ \let\AskInc@@QuestionHeader\AskInc@QuestionHeader
+ \AskInc@AskQuestion
+ \ifx\AskInc@AskResult\AskInc@CharYes
+ \ifx\AskInc@Answer\@empty
+ \gdef\AskInc@Answer{#1}%
+ \else
+ \g@addto@macro\AskInc@Answer{,#1}%
+ \fi
+ \AskInc@SaveAnswer
+ \let\@partlist\AskInc@Answer
+ \fi
+}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\AskInc@AskQuestion}
+% \begin{macrocode}
+\def\AskInc@AskQuestion{%
+ \let\AskInc@Temp\answer
+ \AskInc@@QuestionHeader
+ \let\AskInc@@QuestionHeader\relax
+ \typein[\answer]{%
+ Include `\AskInc@File'? [y]es, [n]o, [A]ll, [N]one, [D]efault %
+ (\AskInc@Default):%
+ }%
+ \typeout{}%
+ \let\AskInc@AskResult\answer
+ \let\answer\AskInc@Temp
+ \ifx\AskInc@AskResult\@empty
+ \let\AskInc@AskResult\AskInc@Default
+ \let\AskInc@Next\relax
+ \else
+ \ifx\AskInc@AskResult\AskInc@CharYes
+ \let\AskInc@Next\relax
+ \else
+ \ifx\AskInc@AskResult\AskInc@CharNo
+ \let\AskInc@Next\relax
+ \else
+ \ifx\AskInc@AskResult\AskInc@CharAll
+ \gdef\AskInc@AskQuestion{%
+ \let\AskInc@AskResult\AskInc@CharYes
+ }%
+ \else
+ \ifx\AskInc@AskResult\AskInc@CharNone
+ \gdef\AskInc@AskQuestion{%
+ \let\AskInc@AskResult\AskInc@CharNo
+ }%
+ \else
+ \ifx\AskInc@AskResult\AskInc@CharDefault
+ \gdef\AskInc@AskQuestion{%
+ \let\AskInc@AskResult\AskInc@Default
+ }%
+ \else
+ \PackageWarningNoLine{askinclude}{%
+ Invalid answer [\AskInc@AskResult].\MessageBreak
+ Answer must be one letter out of [ynAND]%
+ }%
+ \fi
+ \fi
+ \fi
+ \let\AskInc@Next\AskInc@AskQuestion
+ \fi
+ \fi
+ \fi
+ \AskInc@Next
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macrocode}
+\AtBeginDocument{\AskInc@MainQuestion}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\AskInc@AtEnd%
+%</package>
+% \end{macrocode}
+% \section{Installation}
+%
+% \subsection{Download}
+%
+% \paragraph{Package.} This package is available on
+% CTAN\footnote{\CTANpkg{askinclude}}:
+% \begin{description}
+% \item[\CTAN{macros/latex/contrib/askinclude/askinclude.dtx}] The source file.
+% \item[\CTAN{macros/latex/contrib/askinclude/askinclude.pdf}] Documentation.
+% \end{description}
+%
+%
+% \paragraph{Bundle.} All the packages of the bundle `askinclude'
+% are also available in a TDS compliant ZIP archive. There
+% the packages are already unpacked and the documentation files
+% are generated. The files and directories obey the TDS standard.
+% \begin{description}
+% \item[\CTANinstall{install/macros/latex/contrib/askinclude.tds.zip}]
+% \end{description}
+% \emph{TDS} refers to the standard ``A Directory Structure
+% for \TeX\ Files'' (\CTANpkg{tds}). Directories
+% with \xfile{texmf} in their name are usually organized this way.
+%
+% \subsection{Bundle installation}
+%
+% \paragraph{Unpacking.} Unpack the \xfile{askinclude.tds.zip} in the
+% TDS tree (also known as \xfile{texmf} tree) of your choice.
+% Example (linux):
+% \begin{quote}
+% |unzip askinclude.tds.zip -d ~/texmf|
+% \end{quote}
+%
+% \subsection{Package installation}
+%
+% \paragraph{Unpacking.} The \xfile{.dtx} file is a self-extracting
+% \docstrip\ archive. The files are extracted by running the
+% \xfile{.dtx} through \plainTeX:
+% \begin{quote}
+% \verb|tex askinclude.dtx|
+% \end{quote}
+%
+% \paragraph{TDS.} Now the different files must be moved into
+% the different directories in your installation TDS tree
+% (also known as \xfile{texmf} tree):
+% \begin{quote}
+% \def\t{^^A
+% \begin{tabular}{@{}>{\ttfamily}l@{ $\rightarrow$ }>{\ttfamily}l@{}}
+% askinclude.sty & tex/latex/askinclude/askinclude.sty\\
+% askinclude.pdf & doc/latex/askinclude/askinclude.pdf\\
+% askinclude.dtx & source/latex/askinclude/askinclude.dtx\\
+% \end{tabular}^^A
+% }^^A
+% \sbox0{\t}^^A
+% \ifdim\wd0>\linewidth
+% \begingroup
+% \advance\linewidth by\leftmargin
+% \advance\linewidth by\rightmargin
+% \edef\x{\endgroup
+% \def\noexpand\lw{\the\linewidth}^^A
+% }\x
+% \def\lwbox{^^A
+% \leavevmode
+% \hbox to \linewidth{^^A
+% \kern-\leftmargin\relax
+% \hss
+% \usebox0
+% \hss
+% \kern-\rightmargin\relax
+% }^^A
+% }^^A
+% \ifdim\wd0>\lw
+% \sbox0{\small\t}^^A
+% \ifdim\wd0>\linewidth
+% \ifdim\wd0>\lw
+% \sbox0{\footnotesize\t}^^A
+% \ifdim\wd0>\linewidth
+% \ifdim\wd0>\lw
+% \sbox0{\scriptsize\t}^^A
+% \ifdim\wd0>\linewidth
+% \ifdim\wd0>\lw
+% \sbox0{\tiny\t}^^A
+% \ifdim\wd0>\linewidth
+% \lwbox
+% \else
+% \usebox0
+% \fi
+% \else
+% \lwbox
+% \fi
+% \else
+% \usebox0
+% \fi
+% \else
+% \lwbox
+% \fi
+% \else
+% \usebox0
+% \fi
+% \else
+% \lwbox
+% \fi
+% \else
+% \usebox0
+% \fi
+% \else
+% \lwbox
+% \fi
+% \else
+% \usebox0
+% \fi
+% \end{quote}
+% If you have a \xfile{docstrip.cfg} that configures and enables \docstrip's
+% TDS installing feature, then some files can already be in the right
+% place, see the documentation of \docstrip.
+%
+% \subsection{Refresh file name databases}
+%
+% If your \TeX~distribution
+% (\TeX\,Live, \mikTeX, \dots) relies on file name databases, you must refresh
+% these. For example, \TeX\,Live\ users run \verb|texhash| or
+% \verb|mktexlsr|.
+%
+% \subsection{Some details for the interested}
+%
+% \paragraph{Unpacking with \LaTeX.}
+% The \xfile{.dtx} chooses its action depending on the format:
+% \begin{description}
+% \item[\plainTeX:] Run \docstrip\ and extract the files.
+% \item[\LaTeX:] Generate the documentation.
+% \end{description}
+% If you insist on using \LaTeX\ for \docstrip\ (really,
+% \docstrip\ does not need \LaTeX), then inform the autodetect routine
+% about your intention:
+% \begin{quote}
+% \verb|latex \let\install=y\input{askinclude.dtx}|
+% \end{quote}
+% Do not forget to quote the argument according to the demands
+% of your shell.
+%
+% \paragraph{Generating the documentation.}
+% You can use both the \xfile{.dtx} or the \xfile{.drv} to generate
+% the documentation. The process can be configured by the
+% configuration file \xfile{ltxdoc.cfg}. For instance, put this
+% line into this file, if you want to have A4 as paper format:
+% \begin{quote}
+% \verb|\PassOptionsToClass{a4paper}{article}|
+% \end{quote}
+% An example follows how to generate the
+% documentation with pdf\LaTeX:
+% \begin{quote}
+%\begin{verbatim}
+%pdflatex askinclude.dtx
+%bibtex askinclude.aux
+%makeindex -s gind.ist askinclude.idx
+%pdflatex askinclude.dtx
+%makeindex -s gind.ist askinclude.idx
+%pdflatex askinclude.dtx
+%\end{verbatim}
+% \end{quote}
+%
+% \section{Acknowledgement}
+%
+% \begin{description}
+% \item[Tom Scavo]
+% suggested saving the include file list
+% from the previous run and a simplified user interface.
+% \item[Joseph Wright] suggested questions for each \cs{include}.
+% \end{description}
+%
+% \printbibliography[
+% heading=bibnumbered,
+% ]
+%
+% \begin{History}
+
+% \begin{Version}{1991/11/05 v0.95}
+% \item
+% First beta-test version (asked two questions).
+% \end{Version}
+% \begin{Version}{1991/11/05 v0.99}
+% \item
+% Second beta-test version (asks one question; uses `|*|' and `|-|').
+% \end{Version}
+% \begin{Version}{1991/11/07 v1.0}
+% \item
+% Changed prompts (sent to \xnewsgroup{comp.text.tex}):
+% \URL{``\link{Interactive inclusion of files in LaTeX}''}^^A
+% {https://groups.google.com/group/comp.text.tex/msg/34b770a7c277e79c}
+% \end{Version}
+% \begin{Version}{1991/12/13 v1.1}
+% \item
+% \textit{Unknown}.
+% \end{Version}
+% \begin{Version}{1994/11/02 v1.2e}
+% \item
+% Two small changes to run under LaTeX2e [RF].
+% \item
+% Additional documentation [TRS].
+% \end{Version}
+% \begin{Version}{2007/10/15 v1.0 (askinc)}
+% \item
+% Reimplementation, published as \xpackage{askinc} in
+% newsgroup \xnewsgroup{comp.text.tex}:\\
+% \URL{``\link{Re: askinclude.sty}''}^^A
+% {https://groups.google.com/group/comp.text.tex/msg/2d638b84a858fdc8}
+% \item
+% Listing of included files, collected from the previous run before
+% the question.
+% \item
+% No error message by \xfile{.aux} file if package is removed.
+% \end{Version}
+% \begin{Version}{2007/10/23 v2.0}
+% \item
+% The next version of \xpackage{askinc} becomes
+% version 2.0 of \xpackage{askinclude}.
+% \item
+% `|?|' added for questioning each file.
+% \item
+% \cs{includeonly} has precedence until package loading.
+% Then it is disabled by a warning.
+% \item
+% Documentation rewritten/added.
+% \item
+% Tests added.
+% \end{Version}
+% \begin{Version}{2008/08/11 v2.1}
+% \item
+% Code is not changed.
+% \item
+% URLs updated.
+% \end{Version}
+% \begin{Version}{2011/12/02 v2.2}
+% \item
+% Bibliography rewritten for biblatex.
+% \end{Version}
+% \begin{Version}{2016/05/14 v2.3}
+% \item
+% Luatex compatibility
+% \end{Version}
+% \begin{Version}{2018/11/01 v2.4}
+% \item
+% Remove luatex85 package dependency
+% \end{Version}
+% \begin{Version}{2019/12/09 v2.5}
+% \item
+% Documentation updates.
+% \end{Version}
+% \end{History}
+%
+% \PrintIndex
+%
+% \Finale
+\endinput
+% \begin{Version}{1991/11/05 v0.95}
+% \item
+% First beta-test version (asked two questions).
+% \end{Version}
+% \begin{Version}{1991/11/05 v0.99}
+% \item
+% Second beta-test version (asks one question; uses `|*|' and `|-|').
+% \end{Version}
+% \begin{Version}{1991/11/07 v1.0}
+% \item
+% Changed prompts (sent to \xnewsgroup{comp.text.tex}):
+% \URL{``\link{Interactive inclusion of files in LaTeX}''}^^A
+% {https://groups.google.com/group/comp.text.tex/msg/34b770a7c277e79c}
+% \end{Version}
+% \begin{Version}{1991/12/13 v1.1}
+% \item
+% \textit{Unknown}.
+% \end{Version}
+% \begin{Version}{1994/11/02 v1.2e}
+% \item
+% Two small changes to run under LaTeX2e [RF].
+% \item
+% Additional documentation [TRS].
+% \end{Version}
+% \begin{Version}{2007/10/15 v1.0 (askinc)}
+% \item
+% Reimplementation, published as \xpackage{askinc} in
+% newsgroup \xnewsgroup{comp.text.tex}:\\
+% \URL{``\link{Re: askinclude.sty}''}^^A
+% {https://groups.google.com/group/comp.text.tex/msg/2d638b84a858fdc8}
+% \item
+% Listing of included files, collected from the previous run before
+% the question.
+% \item
+% No error message by \xfile{.aux} file if package is removed.
+% \end{Version}
+% \begin{Version}{2007/10/23 v2.0}
+% \item
+% The next version of \xpackage{askinc} becomes
+% version 2.0 of \xpackage{askinclude}.
+% \item
+% `|?|' added for questioning each file.
+% \item
+% \cs{includeonly} has precedence until package loading.
+% Then it is disabled by a warning.
+% \item
+% Documentation rewritten/added.
+% \item
+% Tests added.
+% \end{Version}
+% \begin{Version}{2008/08/11 v2.1}
+% \item
+% Code is not changed.
+% \item
+% URLs updated.
+% \end{Version}
+% \begin{Version}{2011/12/02 v2.2}
+% \item
+% Bibliography rewritten for biblatex.
+% \end{Version}
+% \begin{Version}{2016/05/14 v2.3}
+% \item
+% Luatex compatibility
+% \end{Version}
+% \end{History}
+%
+% \PrintIndex
+%
+% \Finale
+\endinput
diff --git a/macros/latex/contrib/askinclude/askinclude.pdf b/macros/latex/contrib/askinclude/askinclude.pdf
new file mode 100644
index 0000000000..10c3f10452
--- /dev/null
+++ b/macros/latex/contrib/askinclude/askinclude.pdf
Binary files differ