summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/inputtrc
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/inputtrc
Initial commit
Diffstat (limited to 'macros/latex/contrib/inputtrc')
-rw-r--r--macros/latex/contrib/inputtrc/README41
-rw-r--r--macros/latex/contrib/inputtrc/README.pdfbin0 -> 14183 bytes
-rw-r--r--macros/latex/contrib/inputtrc/doc/RELEASE.txt36
-rw-r--r--macros/latex/contrib/inputtrc/doc/SrcFILEs.txt23
-rw-r--r--macros/latex/contrib/inputtrc/doc/inputtrc.RLS2
-rw-r--r--macros/latex/contrib/inputtrc/doc/inputtrc.pdfbin0 -> 357511 bytes
-rw-r--r--macros/latex/contrib/inputtrc/docsrc/README.tex12
-rw-r--r--macros/latex/contrib/inputtrc/docsrc/inputtrc.tex529
-rw-r--r--macros/latex/contrib/inputtrc/docsrc/srcfiles.tex15
-rw-r--r--macros/latex/contrib/inputtrc/inputtrc.sty145
10 files changed, 803 insertions, 0 deletions
diff --git a/macros/latex/contrib/inputtrc/README b/macros/latex/contrib/inputtrc/README
new file mode 100644
index 0000000000..62d7892a12
--- /dev/null
+++ b/macros/latex/contrib/inputtrc/README
@@ -0,0 +1,41 @@
+ README for the `inputtrc' package
+
+ Tracing Which File Loads Which
+
+ (C) Uwe Lueck 2012/10/10
+
+ http://www.contact-ednotes.sty.de.vu
+
+
+`inputtrc.sty' produces screen/log messages
+`<current> INPUTTING <next>' on LaTeX input commands,
+<current> and <next> being file names.
+The message indents reflect the input nesting level.
+This can be turned on and off, and the "indent unit"
+can be chosen. `RETURNING TO <current>' may be added.
+These messages should help when you otherwise get a screen
+message about some input line number and wonder in which
+file that is.
+
+The implementation somewhat resembles packages `currfile',
+`filehook', `FiNK', and `inputfile'.
+
+Typesetting the documentation requires the 'nicetext' bundle,
+
+ http://ctan.org/pkg/nicetext
+
+`inputtrc' is author-maintained in the sense of LPPL below.
+
+`inputtrc.sty', its documentation `inputtrc.pdf', and the
+latter's source `inputtrc.tex' can be redistributed and/or
+modified under the terms of the LaTeX Project Public License;
+either version 1.3c of the License, or any later version.
+The latest version of this license is in
+
+ http://www.latex-project.org/lppl.txt
+
+We did our best to help you, but there is NO WARRANTY.
+
+Please report bugs, problems, and suggestions via
+
+ http://www.contact-ednotes.sty.de.vu
diff --git a/macros/latex/contrib/inputtrc/README.pdf b/macros/latex/contrib/inputtrc/README.pdf
new file mode 100644
index 0000000000..73e94c1c46
--- /dev/null
+++ b/macros/latex/contrib/inputtrc/README.pdf
Binary files differ
diff --git a/macros/latex/contrib/inputtrc/doc/RELEASE.txt b/macros/latex/contrib/inputtrc/doc/RELEASE.txt
new file mode 100644
index 0000000000..9cd979164c
--- /dev/null
+++ b/macros/latex/contrib/inputtrc/doc/RELEASE.txt
@@ -0,0 +1,36 @@
+r0.3 = v0.3, 2012/10/10,
+corrects \notracingreturns, adds package options for
+immediately issuing \dotracinginputs and \dotracingreturns,
+and adjusts and slightly corrects documentation.
+Source file list generation is modified and includes
+inputtrc.RLS for a release summary.
+____________________________________________________________
+
+r0.2d corrects the TDS version and the date of the earlier
+release, maybe gather.tex and FileList.txt also,
+nothing else. (Date of r0.2c interchanges one `0' and one 1'
+as compared to date of t0.2b)
+UL 2011/01/30
+____________________________________________________________
+r0.2c changes inputtrc.tex (documentation) only,
+using texlinks.sty v0.2 (\urlfoot).
+\baselineskip's are corrected with makedoc.sty v0.41
+UL 2011/01/28
+
+____________________________________________________________
+W.r.t. v0.2, `inputtrc' RELEASE v0.2b (2010/11/28) updates
+
+ * LPPL version in README and inputtrc.sty
+ * makedoc.cfg
+ * inputtrc.pdf with
+ * new makedoc.cfg formatting
+ * using `readprov.sty' for referring to `inputtrc.sty'
+ * mention of the `filehook' package
+
+and adds
+
+ * README.pdf (+ README.tex)
+ * FileList.txt + gather.tex
+
+UL 2010/11/28
+
diff --git a/macros/latex/contrib/inputtrc/doc/SrcFILEs.txt b/macros/latex/contrib/inputtrc/doc/SrcFILEs.txt
new file mode 100644
index 0000000000..9c35e4b116
--- /dev/null
+++ b/macros/latex/contrib/inputtrc/doc/SrcFILEs.txt
@@ -0,0 +1,23 @@
+
+ *File List*
+----HERE.--- -- -- -- -- ----
+inputtrc.sty 2012/10/10 v0.3 input tracing (UL)
+inputtrc.tex 2012/10/03 -- documenting inputtrc.sty
+inputtrc.RLS 2012/10/10 r0.3 v0.3 fix, [i], [r], [ir]
+-DOC-FMT.--- -- -- -- -- ----
+fifinddo.sty 2012/08/27 v0.6 filtering TeX(t) files by TeX (UL)
+ makedoc.sty 2012/08/28 v0.52 TeX input from *.sty (UL)
+niceverb.sty 2012/09/27 v0.5 minimize doc markup (UL)
+ makedoc.cfg 2012/07/13 -- documentation settings
+ README.tex 2012/03/18 -- make README.pdf
+hypertoc.sty 2011/01/23 v0.1 pretty TOC links (UL)
+texlinks.sty 2012/05/13 v0.6 TeX-related links (UL)
+----LIST.--- -- -- -- -- ----
+myfilist.sty 2012/10/11 v0.6 \listfiles -- mine only (UL)
+readprov.sty 2012/03/20 v0.3b file infos without loading (UL)
+srcfiles.tex 2012/10/11 -- file infos -> SrcFILEs.txt
+ ***********
+
+ List made at 2012/10/11, 13:38
+ from script file srcfiles.tex
+
diff --git a/macros/latex/contrib/inputtrc/doc/inputtrc.RLS b/macros/latex/contrib/inputtrc/doc/inputtrc.RLS
new file mode 100644
index 0000000000..00a77bc5e3
--- /dev/null
+++ b/macros/latex/contrib/inputtrc/doc/inputtrc.RLS
@@ -0,0 +1,2 @@
+\ProvidesFile{inputtrc.RLS} %% RELEASE INFO
+ [{2012/10/10 r0.3 v0.3 fix, [i], [r], [ir]}]
diff --git a/macros/latex/contrib/inputtrc/doc/inputtrc.pdf b/macros/latex/contrib/inputtrc/doc/inputtrc.pdf
new file mode 100644
index 0000000000..5b4b672504
--- /dev/null
+++ b/macros/latex/contrib/inputtrc/doc/inputtrc.pdf
Binary files differ
diff --git a/macros/latex/contrib/inputtrc/docsrc/README.tex b/macros/latex/contrib/inputtrc/docsrc/README.tex
new file mode 100644
index 0000000000..a4bf82368f
--- /dev/null
+++ b/macros/latex/contrib/inputtrc/docsrc/README.tex
@@ -0,0 +1,12 @@
+\ProvidesFile{README.tex}[2012/03/18 make README.pdf]
+\listfiles
+
+\documentclass[12pt]{article}
+\usepackage{verbatim}
+\pagestyle{empty}
+\begin{document}
+\vspace*{-3\baselineskip}
+\enlargethispage{2\baselineskip}
+% \small %% 2011/02/14
+\verbatiminput{README.txt}
+\end{document}
diff --git a/macros/latex/contrib/inputtrc/docsrc/inputtrc.tex b/macros/latex/contrib/inputtrc/docsrc/inputtrc.tex
new file mode 100644
index 0000000000..60396eb37b
--- /dev/null
+++ b/macros/latex/contrib/inputtrc/docsrc/inputtrc.tex
@@ -0,0 +1,529 @@
+\ProvidesFile{inputtrc.tex}[2012/10/03 documenting inputtrc.sty]
+\title{\pkgtitle{inputtrc.sty}{Tracing Which File Loads Which}} %% 2012/10/03
+% \listfiles
+\RequirePackage{inputtrc} %%% \dotracinginputs %%% returns
+% \setinputindentunit{\space\space\space}
+{ \RequirePackage{makedoc} \ProcessLineMessage{}
+ \MakeJobDoc{18}{\SectionLevelTwoParseInput} } %% 18 2012/10/03
+\documentclass[fleqn]{article}%% TODO paper dimensions!?
+% \notracinginputs
+\input{makedoc.cfg} %% shared formatting settings
+\newcommand*{\TODO}{\textcolor{blue}{\acro{TODO}}}
+\AddQuotes
+\sloppy
+\begin{document}
+\maketitle
+\begin{abstract}\noindent
+'inputtrc.sty' produces screen/log messages
+`<current> INPUTTING <next>'
+on \LaTeX\ input commands, <current> and <next> being file names.
+The message indents reflect the input nesting level.
+This can be turned on and off, and the ``indent unit"
+can be chosen. `RETURNING TO <current>' may be
+added. These messages should help especially
+when you otherwise get a screen message about `l.<digits>'
+referring to an input line while you have no idea in which
+\emph{file} that line is.---The implementation somewhat resembles packages
+\ctanpkgref{filehook}, \ctanpkgref{currfile}, %% 2010/11/28
+\CtanPkgRef{fink}{FiNK} and \ctanpkgref{inputfile}.
+\end{abstract}
+\tableofcontents
+
+ \newpage %% 2010/10/08b
+\section{Features and Usage}
+
+\subsection{Installing, Calling, and Package Options}
+The file 'inputtrc.sty' is provided ready, installation only requires
+putting it somewhere where \TeX\ finds it
+(which may need updating the filename data
+ base).\urlfoot{ukfaqref}{inst-wlcf}
+ % \footnote{\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=inst-wlcf}}
+
+% \AddQuotes %% 2012/10/10
+
+\emph{After} `\documentclass', you may load 'inputtrc' (as usually) by
+\[|\usepackage{inputtrc}|\]
+In order to use one of the package options that come with v0.3, you may type
+\[|\usepackage[<ir>]{inputtrc}|\]
+where <ir> is `i', `r', or `ir' (---or `i,r').
+However, you may want to see what `\documentclass' loads;
+then precede `\documentclass' with
+\[|\RequirePackage[<ir>]{inputtrc}|\]
+|[i]| issues `\dotracinginputs' immediately, |[r]| issues
+`\dotracingreturns' immediately, and |[ir]| issues
+`\dotracinginputsreturns' immediately. So `[ir]' is like `[i,r]'.
+
+% \DontAddQuotes
+
+\subsection{Input}
+Indeed, the `INPUTTING' messages appear after command
+|\dotracinginputs| only, \emph{unless} you load the package with
+option |[i]| or |[ir]|.
+The command |\notracinginputs| turns the feature off again.
+
+|\setinputindentunit{<cmds>}| globally sets the ``indent unit,"
+whose default is set by
+\[|\setinputindentunit{\space\space}|\]
+in 'inputtrc.sty'. By default, the indent for what the main file
+(to whose name `\jobname' expands---\TODO: extension is not
+ yet dealt with) loads is two spaces; each nesting level increases
+the indent by two more spaces, and the indent is reduced again when a
+loaded file is left.
+(\TODO: not dealt with `\dotracinginputs' in other files yet,
+ may need 'fink'.)
+The first indent and the indent difference will be, e.g., \emph{three}
+spaces if you insert
+\[|\setinputindentunit{\space\space\space}|\]
+
+\textbf{Note} that only \emph{\LaTeX} input commands are recognized by
+'inputtrc.sty' (at present, \TODO). This means that `\input'
+\emph{without braces} is not recognized: it neither produces a message
+nor changes the indent, and with
+\[`\input <file>'\]
+where <file> loads other files, files that <file> loads directly
+produce \emph{wrong} messages.
+
+\subsection{After Input}
+|\dotracingreturns| adds a message
+\[`RETURNING TO <current>' \quad \mbox{after} \quad
+ `<current> INPUTTING <next>'\]
+meaning that processing file <next> has been finished.
+The package issues this command immediately if called
+with option |[r]|
+Use |\notracingreturns| to turn this additional
+feature off again.
+
+%% doubled `both' before 2012/10/10:
+|\dotracinginputsreturns| calls both
+\[`\dotracinginputs' \quad \mbox{and} \quad `\dotracingreturns'\]
+at (about) the same time.
+On package option |[ir]|, this command is issued immediately.
+|\notracinginputsreturns| switches off both kinds of messages.
+
+
+\section{What it is Good for}
+
+\TeX's primitive `\input' (that \LaTeX\ represents as \cs{@@input})
+sends a left round bracket to screen, followed by the path of the
+loaded file. When \TeX\ stops reading the file, a right round bracket
+is sent to screen. This screen log suffices to trace which files load
+which other files (directly). However, this has a quite little visual
+effect and hardly reflects input nesting in an intuitive way.
+And when an inputted file produces many messages, it becomes quite
+impossible to trace input nesting by eyes and mind only.
+
+This may be very painful in debugging. Sometimes you get a warning or
+error message and you are unable to tell which file produced the
+message (if the file is not a \LaTeX\ package issuing the proper
+\emph{package} warnings and errors)\footnote{\cs{PackageWarning}
+etc.}---typically the \emph{number of the line} that caused the
+warning is shown, but not the \emph{file name}.
+
+Indeed on the 'texhax' mailing list, \emph{Karl Berry} posted the
+following:\urlfoot{texhaxpref}{10-02-014305} %% 2011/01/28 ...
+\begin{quote}\itshape\small
+ Sometimes it would be helpful for tex debugging to get a
+ \dqtd{backtrace} of the files that tex is executing.
+ It could be something static, that
+ reads a .log file (or maybe .fls file from -recorder) and reports on
+ which files were opened and closed in some way that is readable for deep
+ nesting.
+
+ I seem to recall that auctex and presumably front ends have dealt with
+ extracting the filenames, at least, out of the mess of garbage printed
+ to the terminal on a typical run, parsing all the open/close parens, but
+ I've been unable to find anything that works as a separate utility.
+
+ Does anyone know of something to do this?
+
+ Failing anything else, I wonder about adding a new primitive to pdftex
+ to dump the input stack at any point. Then we could get line numbers
+ too, I expect.
+\end{quote}
+The subject line was \textit{\dqtd{tex filename backtrace
+utility}}.---\emph{Ronald Fehd}
+joined:\urlfoot{texhaxpref}{10-02-014311}
+\begin{quote}\itshape\small
+ I am glad to see this suggestion as I have occasional problems
+ identifying from which of my included files the error message is coming
+ from.
+\end{quote}
+and suggested using the programming language SAS.
+
+Karl's suggestion to filter the .log file would have the advantage
+over the present approach that information not relevant for input
+tracing would be stripped off. However, more in the direction
+addressed by Ronald Fehd, any message from a file may be wanted to be
+attributed to that file. The present approach should be helpful then,
+you just must read the log back to the last line containing
+`INPUTTING'---or to \texttt{RETURNING TO} (v0.2).
+
+The present approach was inspired by Karl's idea to provide a new
+\TeX\ primitive. This first triggered my
+reply\urlfoot{texhaxpref}{10-02-014309}
+claiming one could just redefine the primitive `\input' as a macro---a
+%% <- typo and wording 2010/10/08b ->
+little too optimistic. In the documentation for his 'FiNK'
+package,\urlfoot{CtanPkgRef}{fink}
+Didier Verna remarks that this primitive parses the file name
+in a way that is somewhat difficult to imitate
+by %%% with %% 2010/10/08b
+macros:
+\begin{quote}\itshape\small
+(one would have to parse the characters one by one,
+ and I'm not ready to do so\dots)
+\end{quote}
+Instead, I here change two \LaTeX\ macros that use the primitive.
+
+\section{Example}
+It is especially nice to watch 'hyperref' loading quite a bunch
+from Heiko's 'oberdiek' bundle (on running the present
+ 'inputtrc.tex'):\urlfoot{CtanPkgRef}{oberdiek}
+\begingroup \hfuzz=10pc \small
+ \begin{verbatim}
+ inputtrc.tex 2010/10/09 documenting inputtrc.sty
+ (./inputtrc.sty
+ Package: inputtrc 2010/10/09 v0.2 input tracing (UL)
+ )
+ inputtrc INPUTTING makedoc.sty
+ (/usr/share/texmf/tex/latex/nicetext/makedoc.sty
+ Package: makedoc 2010/03/30 v0.4 TeX input from *.sty (UL)
+
+ makedoc.sty INPUTTING fifinddo.sty
+ (/usr/share/texmf/tex/latex/nicetext/fifinddo.sty
+ Package: fifinddo 2010/04/15 v0.41 filtering TeX(t) files by TeX (UL)
+ \result_file=\write3
+ \c@fdInputLine=\count79
+ )
+ RETURNING TO makedoc.sty
+ )
+ RETURNING TO inputtrc
+ inputtrc INPUTTING mdoccorr.cfg
+ (/usr/share/texmf/tex/latex/nicetext/mdoccorr.cfg
+ File: mdoccorr.cfg 2010/03/29 local typographical corrections with `makedoc.sty
+ '
+ )
+ RETURNING TO inputtrc
+ \openout3 = `inputtrc.doc'.
+
+ `fifinddo' processing `inputtrc.sty'
+ inputtrc INPUTTING article.cls
+ (/usr/share/texmf/tex/latex/base/article.cls
+ Document Class: article 2005/09/16 v1.4f Standard LaTeX document class
+ article.cls INPUTTING size10.clo
+ (/usr/share/texmf/tex/latex/base/size10.clo
+ File: size10.clo 2005/09/16 v1.4f Standard LaTeX file (size option)
+ )
+ RETURNING TO article.cls
+ \c@part=\count80
+ \c@section=\count81
+ \c@subsection=\count82
+ \c@subsubsection=\count83
+ \c@paragraph=\count84
+ \c@subparagraph=\count85
+ \c@figure=\count86
+ \c@table=\count87
+ \abovecaptionskip=\skip41
+ \belowcaptionskip=\skip42
+ \bibindent=\dimen102
+ )
+ RETURNING TO inputtrc
+ inputtrc INPUTTING makedoc.cfg
+ (./makedoc.cfg
+ File: makedoc.cfg 2010/10/08 doc formatting settings
+
+ makedoc.cfg INPUTTING ifpdf.sty
+ (/usr/share/texmf/tex/generic/oberdiek/ifpdf.sty
+ Package: ifpdf 2009/04/10 v2.0 Provides the ifpdf switch (HO)
+ Package ifpdf Info: pdfTeX in pdf mode not detected.
+ )
+ RETURNING TO makedoc.cfg
+ makedoc.cfg INPUTTING hyperref.sty
+ (/usr/share/texmf/tex/latex/hyperref/hyperref.sty
+ Package: hyperref 2010/06/18 v6.81g Hypertext links for LaTeX
+
+ hyperref.sty INPUTTING ltxcmds.sty
+ (/usr/share/texmf/tex/latex/oberdiek/ltxcmds.sty
+ Package: ltxcmds 2010/04/26 v1.7 LaTeX kernel commands for general use (HO)
+ )
+ RETURNING TO hyperref.sty
+ hyperref.sty INPUTTING keyval.sty
+ (/usr/share/texmf/tex/latex/graphics/keyval.sty
+ Package: keyval 1999/03/16 v1.13 key=value parser (DPC)
+ \KV@toks@=\toks14
+ )
+ RETURNING TO hyperref.sty
+ hyperref.sty INPUTTING kvsetkeys.sty
+ (/usr/share/texmf/tex/generic/oberdiek/kvsetkeys.sty
+ Package: kvsetkeys 2007/09/29 v1.3 Key value parser with default handler suppor
+ t (HO)
+
+ kvsetkeys.sty INPUTTING infwarerr.sty
+ (/usr/share/texmf/tex/generic/oberdiek/infwarerr.sty
+ Package: infwarerr 2007/09/09 v1.2 Providing info/warning/message (HO)
+ )
+ RETURNING TO kvsetkeys.sty
+ kvsetkeys.sty INPUTTING etexcmds.sty
+ (/usr/share/texmf/tex/generic/oberdiek/etexcmds.sty
+ Package: etexcmds 2007/12/12 v1.2 Prefix for e-TeX command names (HO)
+ Package etexcmds Info: Could not find \expanded.
+ (etexcmds) That can mean that you are not using pdfTeX 1.50 or
+ (etexcmds) that some package has redefined \expanded.
+ (etexcmds) In the latter case, load this package earlier.
+ )
+ RETURNING TO kvsetkeys.sty
+ )
+ RETURNING TO hyperref.sty
+ hyperref.sty INPUTTING pdfescape.sty
+ (/usr/share/texmf/tex/generic/oberdiek/pdfescape.sty
+ Package: pdfescape 2007/11/11 v1.8 Provides hex, PDF name and string conversion
+ s (HO)
+
+ pdfescape.sty INPUTTING pdftexcmds.sty
+ (/usr/share/texmf/tex/generic/oberdiek/pdftexcmds.sty
+ Package: pdftexcmds 2009/04/10 v0.4 LuaTeX support for pdfTeX utility functions
+ (HO)
+
+ pdftexcmds.sty INPUTTING ifluatex.sty
+ (/usr/share/texmf/tex/generic/oberdiek/ifluatex.sty
+ Package: ifluatex 2009/04/10 v1.1 Provides the ifluatex switch (HO)
+ Package ifluatex Info: LuaTeX not detected.
+ )
+ RETURNING TO pdftexcmds.sty
+ Package pdftexcmds Info: LuaTeX not detected on input line 145.
+ )
+ RETURNING TO pdfescape.sty
+ )
+ RETURNING TO hyperref.sty
+ hyperref.sty INPUTTING ifvtex.sty
+ (/usr/share/texmf/tex/generic/oberdiek/ifvtex.sty
+ Package: ifvtex 2008/11/04 v1.4 Switches for detecting VTeX and its modes (HO)
+ Package ifvtex Info: VTeX not detected.
+ )
+ RETURNING TO hyperref.sty
+ hyperref.sty INPUTTING ifxetex.sty
+ (/usr/share/texmf/tex/generic/ifxetex/ifxetex.sty
+ Package: ifxetex 2010/09/12 v0.6 Provides ifxetex conditional
+ )
+ RETURNING TO hyperref.sty
+ hyperref.sty INPUTTING hycolor.sty
+ (/usr/share/texmf/tex/latex/oberdiek/hycolor.sty
+ Package: hycolor 2008/09/08 v1.4 Code for color options of hyperref/bookmark (H
+ O)
+
+ hycolor.sty INPUTTING xcolor-patch.sty
+ (/usr/share/texmf/tex/latex/oberdiek/xcolor-patch.sty
+ Package: xcolor-patch 2008/09/08 xcolor patch
+ )
+ RETURNING TO hycolor.sty
+ )
+ RETURNING TO hyperref.sty
+ hyperref.sty INPUTTING letltxmacro.sty
+ (/usr/share/texmf/tex/latex/oberdiek/letltxmacro.sty
+ Package: letltxmacro 2008/06/24 v1.3 Let assignment for LaTeX macros (HO)
+ )
+ RETURNING TO hyperref.sty
+ \@linkdim=\dimen103
+ \Hy@linkcounter=\count88
+ \Hy@pagecounter=\count89
+ hyperref.sty INPUTTING pd1enc.def
+ (/usr/share/texmf/tex/latex/hyperref/pd1enc.def
+ File: pd1enc.def 2010/06/18 v6.81g Hyperref: PDFDocEncoding definition (HO)
+ )
+ RETURNING TO hyperref.sty
+ hyperref.sty INPUTTING intcalc.sty
+ (/usr/share/texmf/tex/generic/oberdiek/intcalc.sty
+ Package: intcalc 2007/09/27 v1.1 Expandable integer calculations (HO)
+ )
+ RETURNING TO hyperref.sty
+ hyperref.sty INPUTTING hyperref.cfg
+ (/usr/share/texmf/tex/latex/config/hyperref.cfg
+ File: hyperref.cfg 2002/06/06 v1.2 hyperref configuration of TeXLive
+ )
+ RETURNING TO hyperref.sty
+ hyperref.sty INPUTTING kvoptions.sty
+ (/usr/share/texmf/tex/latex/oberdiek/kvoptions.sty
+ Package: kvoptions 2010/02/22 v3.7 Keyval support for LaTeX options (HO)
+ )
+ RETURNING TO hyperref.sty
+ Package hyperref Info: Option `draft' set `true' on input line 3577.
+ Package hyperref Info: Hyper figures OFF on input line 3658.
+ Package hyperref Info: Link nesting OFF on input line 3663.
+ Package hyperref Info: Hyper index ON on input line 3666.
+ Package hyperref Info: Plain pages OFF on input line 3673.
+ Package hyperref Info: Backreferencing OFF on input line 3678.
+ Implicit mode ON; LaTeX internals redefined
+ Package hyperref Info: Bookmarks ON on input line 3874.
+ hyperref.sty INPUTTING url.sty
+ (/usr/share/texmf/tex/latex/ltxmisc/url.sty
+ \Urlmuskip=\muskip10
+ Package: url 2005/06/27 ver 3.2 Verb mode for urls, etc.
+ )
+ RETURNING TO hyperref.sty
+ LaTeX Info: Redefining \url on input line 4159.
+ hyperref.sty INPUTTING bitset.sty
+ (/usr/share/texmf/tex/generic/oberdiek/bitset.sty
+ Package: bitset 2007/09/28 v1.0 Data type bit set (HO)
+
+ bitset.sty INPUTTING bigintcalc.sty
+ (/usr/share/texmf/tex/generic/oberdiek/bigintcalc.sty
+ Package: bigintcalc 2007/11/11 v1.1 Expandable big integer calculations (HO)
+ )
+ RETURNING TO bitset.sty
+ )
+ RETURNING TO hyperref.sty
+ \Fld@menulength=\count90
+ \Field@Width=\dimen104
+ \Fld@charsize=\dimen105
+ \Field@toks=\toks15
+ Package hyperref Info: Hyper figures OFF on input line 5137.
+ Package hyperref Info: Link nesting OFF on input line 5142.
+ Package hyperref Info: Hyper index ON on input line 5145.
+ Package hyperref Info: backreferencing OFF on input line 5152.
+ Package hyperref Info: Link coloring OFF on input line 5157.
+ Package hyperref Info: Link coloring with OCG OFF on input line 5162.
+ Package hyperref Info: PDF/A mode OFF on input line 5167.
+ LaTeX Info: Redefining \ref on input line 5207.
+ LaTeX Info: Redefining \pageref on input line 5211.
+ hyperref.sty INPUTTING atbegshi.sty
+ (/usr/share/texmf/tex/generic/oberdiek/atbegshi.sty
+ Package: atbegshi 2008/07/31 v1.9 At begin shipout hook (HO)
+ )
+ RETURNING TO hyperref.sty
+ \Hy@abspage=\count91
+ \c@Item=\count92
+ \c@Hfootnote=\count93
+ )
+ RETURNING TO makedoc.cfg
+ * hyperref using default driver hdvips *
+ makedoc.cfg INPUTTING hdvips.def
+ (/usr/share/texmf/tex/latex/hyperref/hdvips.def
+ File: hdvips.def 2010/06/18 v6.81g Hyperref driver for dvips
+
+ hdvips.def INPUTTING pdfmark.def
+ (/usr/share/texmf/tex/latex/hyperref/pdfmark.def
+ File: pdfmark.def 2010/06/18 v6.81g Hyperref definitions for pdfmark specials
+ \pdf@docset=\toks16
+ \pdf@box=\box26
+ \pdf@toks=\toks17
+ \pdf@defaulttoks=\toks18
+ \Fld@listcount=\count94
+ \c@bookmark@seq@number=\count95
+
+ pdfmark.def INPUTTING rerunfilecheck.sty
+ (/usr/share/texmf/tex/latex/oberdiek/rerunfilecheck.sty
+ Package: rerunfilecheck 2010/03/16 v1.6 Rerun checks for auxiliary files (HO)
+
+ rerunfilecheck.sty INPUTTING atveryend.sty
+ (/usr/share/texmf/tex/latex/oberdiek/atveryend.sty
+ Package: atveryend 2010/03/24 v1.5 Hooks at very end of document (HO)
+ Package atveryend Info: \enddocument detected (standard).
+ )
+ RETURNING TO rerunfilecheck.sty
+ rerunfilecheck.sty INPUTTING uniquecounter.sty
+ (/usr/share/texmf/tex/latex/oberdiek/uniquecounter.sty
+ Package: uniquecounter 2009/12/18 v1.1 Provides unlimited unique counter (HO)
+ )
+ RETURNING TO rerunfilecheck.sty
+ Package uniquecounter Info: New unique counter `rerunfilecheck' on input line 2
+ 71.
+ )
+ RETURNING TO pdfmark.def
+ \Hy@SectionHShift=\skip43
+ )
+ RETURNING TO hdvips.def
+ )
+ RETURNING TO makedoc.cfg
+ makedoc.cfg INPUTTING niceverb.sty
+ (/usr/share/texmf/tex/latex/nicetext/niceverb.sty
+ Package: niceverb 2010/04/05 v0.41 minimize doc markup (UL)
+ \niceverb_savebox=\box27
+ )
+ RETURNING TO makedoc.cfg
+ )
+ RETURNING TO inputtrc
+ inputtrc INPUTTING inputtrc.aux
+ (./inputtrc.aux)
+ RETURNING TO inputtrc
+ \openout1 = `inputtrc.aux'.
+
+ LaTeX Font Info: Checking defaults for OML/cmm/m/it on input line 13.
+ LaTeX Font Info: ... okay on input line 13.
+ LaTeX Font Info: Checking defaults for T1/cmr/m/n on input line 13.
+ LaTeX Font Info: ... okay on input line 13.
+ LaTeX Font Info: Checking defaults for OT1/cmr/m/n on input line 13.
+ LaTeX Font Info: ... okay on input line 13.
+ LaTeX Font Info: Checking defaults for OMS/cmsy/m/n on input line 13.
+ LaTeX Font Info: ... okay on input line 13.
+ LaTeX Font Info: Checking defaults for OMX/cmex/m/n on input line 13.
+ LaTeX Font Info: ... okay on input line 13.
+ LaTeX Font Info: Checking defaults for U/cmr/m/n on input line 13.
+ LaTeX Font Info: ... okay on input line 13.
+ LaTeX Font Info: Checking defaults for PD1/pdf/m/n on input line 13.
+ LaTeX Font Info: ... okay on input line 13.
+ inputtrc INPUTTING moreverb.sty
+ (/usr/share/texmf/tex/latex/moreverb/moreverb.sty
+ Package: moreverb 1997/12/07 v2.2d.2 `more' verbatim facilities
+
+ moreverb.sty INPUTTING verbatim.sty
+ (/usr/share/texmf/tex/latex/tools/verbatim.sty
+ Package: verbatim 2003/08/22 v1.5q LaTeX2e package for verbatim enhancements
+ \every@verbatim=\toks19
+ \verbatim@line=\toks20
+ \verbatim@in@stream=\read1
+ )
+ RETURNING TO moreverb.sty
+ \verbatim@out=\write4
+ \tab@position=\count96
+ \tab@size=\count97
+ \listing@line=\count98
+ )
+ RETURNING TO inputtrc
+ \AtBeginShipoutBox=\box28
+
+ Package hyperref Warning: draft mode on.
+
+ Package hyperref Info: Link coloring OFF on input line 13.
+ inputtrc INPUTTING nameref.sty
+ (/usr/share/texmf/tex/latex/hyperref/nameref.sty
+ Package: nameref 2010/04/30 v2.40 Cross-referencing by name of section
+
+ nameref.sty INPUTTING refcount.sty
+ (/usr/share/texmf/tex/latex/oberdiek/refcount.sty
+ Package: refcount 2008/08/11 v3.1 Data extraction from references (HO)
+ )
+ RETURNING TO nameref.sty
+ nameref.sty INPUTTING gettitlestring.sty
+ (/usr/share/texmf/tex/latex/oberdiek/gettitlestring.sty
+ Package: gettitlestring 2009/12/18 v1.3 Cleanup title references (HO)
+ )
+ RETURNING TO nameref.sty
+ \c@section@level=\count99
+ )
+ RETURNING TO inputtrc
+ \end{verbatim}
+\endgroup
+
+
+% \pagebreak %% 2010/10/08b %% rm. 2012/10/10
+\DontAddQuotes %% 2012/10/10
+
+\section{Implementation}
+\subsection{Package File Header (Legalese)} %% ize -> ese 2012/10/03
+\input{inputtrc.doc}
+\end{document}
+
+HISTORY
+
+2010/10/08 for v0.1 very first, installed on CTAN same day
+2010/10/08b for v0.1a some wordings, even contentually
+ (occurrences of \@@input)
+2010/11/11 for v0.2a + package date
+2010/11/28 for myfilist.sty; using readprov.sty;
+ mention `filehook'
+2011/01/28 use texlinks.sty (v0.2)
+2012/10/03 for v0.3 ize -> ese, using \pkgtitle, corr. \HeaderLines
+2012/10/10 [fleqn] for replacing verbatim/quote
+ environments, account for [i] and [ir], use
+ \AddQuotes instead of \qtd, abstract mentions
+ "line number", corr. \dotracinginput|returns
diff --git a/macros/latex/contrib/inputtrc/docsrc/srcfiles.tex b/macros/latex/contrib/inputtrc/docsrc/srcfiles.tex
new file mode 100644
index 0000000000..ebf515c9ed
--- /dev/null
+++ b/macros/latex/contrib/inputtrc/docsrc/srcfiles.tex
@@ -0,0 +1,15 @@
+\ProvidesFile{srcfiles.tex}[2012/10/11 file infos -> SrcFILEs.txt]
+\RequirePackage[r]{nicefilelist}
+\MaxBaseEmptyList*[readprov.sty,myfilist.sty]
+\NoBottomLines
+\FileListRemark[----]{----HERE.---}
+\ReadPackageInfos{inputtrc}
+\ReadFileInfos{inputtrc,inputtrc.RLS}
+\FileListRemark[----]{-DOC-FMT.---}
+\ReadPackageInfos{fifinddo,makedoc,niceverb}
+\ReadFileInfos{makedoc.cfg,README}
+\ReadPackageInfos{hypertoc,texlinks}
+\FileListRemark[----]{----LIST.---}
+\ReadPackageInfos{myfilist,readprov}
+\ReadFileInfos{srcfiles}
+\ListInfos[SrcFILEs.txt]
diff --git a/macros/latex/contrib/inputtrc/inputtrc.sty b/macros/latex/contrib/inputtrc/inputtrc.sty
new file mode 100644
index 0000000000..ccc48d177b
--- /dev/null
+++ b/macros/latex/contrib/inputtrc/inputtrc.sty
@@ -0,0 +1,145 @@
+\NeedsTeXFormat{LaTeX2e}[1994/12/01]
+\ProvidesPackage{inputtrc}[2012/10/10 v0.3 input tracing (UL)]
+
+%% Copyright (C) 2010 2011 2012 Uwe Lueck,
+%% http://www.contact-ednotes.sty.de.vu
+%% -- author-maintained in the sense of LPPL below --
+%%
+%% This file can be redistributed and/or modified under
+%% the terms of the LaTeX Project Public License; either
+%% version 1.3c of the License, or any later version.
+%% The latest version of this license is in
+%% http://www.latex-project.org/lppl.txt
+%% We did our best to help you, but there is NO WARRANTY.
+%%
+%% Please report bugs, problems, and suggestions via
+%%
+%% http://www.contact-ednotes.sty.de.vu
+%%
+%% === Core Definitions ===
+%% Initializations of indent, current filename, and filename stack:
+\gdef\IT@indent{\IT@indent@unit}
+\xdef\IT@currfile{\jobname\space}
+%% ... TODO: add `.tex' unless ...
+\xdef\IT@filestack{\relax}
+%% ... `\relax' saves braces around job file name
+%% when the file stack is unbuilt.
+%%
+%% |\IT@prim@input{<file>}| will replace \LaTeX's \cs{@@input}
+%% (at certain places, see below).
+\newcommand*{\IT@prim@input}[1]{%
+ \typeout{\IT@indent\IT@currfile INPUTTING #1}%
+%% ... TODO: option to write to `.log' only.
+ \xdef\IT@filestack{{\IT@currfile}\IT@filestack}%
+ \xdef\IT@currfile{#1}%
+ \expandafter \gdef\expandafter \IT@indent\expandafter{%
+ \IT@indent \IT@indent@unit}
+ \@@input#1
+ \expandafter\IT@pop@indent\IT@indent \@nil
+ \expandafter\IT@pop@file \IT@filestack\@nil
+ \IT@maybe@returnmessage %% v0.2
+}
+\def\IT@pop@indent#1#2\@nil{\gdef\IT@indent{#2}}
+\def\IT@pop@file #1#2\@nil{%
+ \gdef\IT@currfile{#1}\gdef\IT@filestack{#2}}
+%% ... cf. LaTeX's `\@pushfilename'/`\@popfilename'.
+\newcommand*{\IT@the@returnmessage}{% %% v0.2
+ \typeout{\IT@indent RETURNING TO \IT@currfile}}
+%% ... the ``active" version of `\IT@maybe@returnmessage',
+%% see below ...
+%%
+%% === Changing \LaTeX\ (Preparations) ===
+%%
+%% Changing \LaTeX's `\@@input'
+%% (that stores \TeX's primitive `\input')
+%% is not easy
+%% (cf. Didier Verna on his 'fink'
+%% package,\footnote{\url{http://ctan.org/pkg/fink}}
+%% also 'inputfile');
+%% but it should suffice to change two of the three
+%% %% <- `the two' was wrong 2010/10/08b ->
+%% \LaTeX\ commands that use `\@@input':
+\newcommand\IT@InputIfFileExists[2]{%
+ \IfFileExists{#1}%
+ {#2\@addtofilelist{#1}\IT@prim@input\@filef@und}}
+%% ... \LaTeX's version is `\long', as opposed to `\@input':
+\newcommand*{\IT@input}[1]{%
+ \IfFileExists{#1}{\IT@prim@input\@filef@und}%
+ {\typeout{No file #1.}}}
+%% ... the third macro using `\@@input' is `\input'---too
+%% difficult for now.
+%%
+%% Storing original \LaTeX:
+\let\IT@ltx@InputIfFileExists\InputIfFileExists
+\let\IT@ltx@input\@input
+%%
+%% === The User Commands ===
+%% |\dotracinginputs| globally activates input tracing:
+\newcommand*{\dotracinginputs}{%
+ \global \let \InputIfFileExists \IT@InputIfFileExists
+ \global \let \@input \IT@input}
+%% |\notracinginputs| globally turns input tracing off:
+\newcommand*{\notracinginputs}{%
+ \global \let \InputIfFileExists \IT@ltx@InputIfFileExists
+ \global \let \@input \IT@ltx@input}
+%% |\setinputindentunit{<cmds>}| globally sets the ``indent unit"---the
+%% default setting is <cmds>~= `\space\space':
+\newcommand*{\setinputindentunit}{\gdef\IT@indent@unit}
+\setinputindentunit{\space\space}
+%% |\dotracingreturns| activates the \texttt{RETURNING~TO} message---
+\newcommand*{\dotracingreturns}{%
+ \global \let \IT@maybe@returnmessage \IT@the@returnmessage}
+%% ---|\notracingreturns| turns it off---
+\newcommand*{\notracingreturns}{%
+ \global \let \IT@maybe@returnmessage \relax}
+%% %% <- was like \dotracingreturns 2012/10/03
+%% ---\emph{not} activated is the default:
+\notracingreturns
+%% |\dotracinginputsreturns| activates \emph{both} `INPUTTING' and
+%% `RETURNING' messages:
+\newcommand*{\dotracinginputsreturns}{%
+ \dotracinginputs \dotracingreturns}
+%% |\notracinginputsreturns| turns off \emph{both} `INPUTTING' and
+%% `RETURNING' messages:
+\newcommand*{\notracinginputsreturns}{%
+ \notracinginputs \notracingreturns}
+%%
+%% === Package Options ===
+%% \label{sec:opt}
+%% Package Option |[i]| issues |\dotracinginputs|
+%% immediately after loading the package:
+\DeclareOption{i}{\dotracinginputs}
+%% Package Option |[r]| issues |\dotracingreturns|
+%% immediately after loading the package:
+\DeclareOption{r}{\dotracingreturns}
+%% Package Option |[ir]| \emph{combines} the functionality
+%% of options `[i]' and `[r]':
+\DeclareOption{ir}{\dotracinginputs\dotracingreturns}
+\ProcessOptions
+%%
+\endinput
+%%
+%% == Coda ==
+%% You can't overestimate my pride!
+%% \emph{That's one small step for a man---one giant leap for \TeX kind.}
+%%
+%% On the other hand, I probably exhausted the set of possible
+%% trials and errors (becoming euphoric when it suddenly worked).
+%%
+%% \bigskip \noindent \itshape
+%% Dedicated to Koppa Aleph Rio Lord.
+%%
+%% \bigskip \raggedleft
+%% Worms-Pfeddersheim~2010/10/08,~U.~L.
+
+HISTORY
+
+v0.1 2010/10/08 very first, installed on CTAN same day
+v0.1a 2010/10/08 doc corrected: LaTeX commands using \@@input;
+ manual page breaks -- installed on CTAN 2010/10/09
+v0.2 2010/10/09 \IT@maybe@returnmessage etc.
+v0.2a 2010/11/11 updated LPPL version
+v0.3 2012/10/03 \dotracingreturns corrected, [i], [r];
+ updated (C)
+ 2012/10/10 correcting doc. on options, three of them,
+ \notracinginputsreturns