path: root/macros/latex/contrib/askinclude/askinclude.dtx

% \iffalse meta-comment
%
% File: askinclude.dtx
% Version: 2020-04-12 v2.7
% Info: Interactive asking of included files
%
% Copyright (C)
%    1991-1994  Pablo A. Straub
%    2007, 2008, 2011 Heiko Oberdiek
%    2016-2020 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 2020-04-12 v2.7 Interactive asking of included files}
\Msg{************************************************************************}

\keepsilent
\askforoverwritefalse

\let\MetaPrefix\relax
\preamble

This is a generated file.

Project: askinclude
Version: 2020-04-12 v2.7

Copyright (C)
   1991-1994 Pablo A. Straub
   2007, 2008, 2011 Heiko Oberdiek
   2016-2020 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}%
  [2020-04-12 v2.7 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{2020-04-12 v2.7}
% \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}%
  [2020-04-12 v2.7 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
        \expandafter\gdef\expandafter\@partlist\expandafter{\detokenize{##1}}%
      \else
        \expandafter\g@addto@macro\expandafter\@partlist\expandafter{\expandafter,\detokenize{##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
     \expandafter\gdef\expandafter\AskInc@Answer\expandafter{\detokenize{#1}}%
    \else
     \expandafter\g@addto@macro\expandafter\AskInc@Answer\expandafter{\expandafter,\detokenize{#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}
%   \begin{Version}{2019-12-10 v2.6}
%   \item Updated
%   \end{Version}
%   \begin{Version}{2020-04-12 v2.7}
%   \item Fixed issue \#1, wrong catcode in filename match after kernel change.
%   \end{Version}
% \end{History}
%
% \PrintIndex
%
% \Finale
\endinput