inputtrc update (10oct10)

git-svn-id: svn://tug.org/texlive/trunk@20045 c570f23f-e606-0410-a88d-b1316a301751

5 files changed, 385 insertions, 191 deletions

diff --git a/Master/texmf-dist/doc/latex/inputtrc/README b/Master/texmf-dist/doc/latex/inputtrc/README
index b074070ff13..1b38f5843a8 100644
--- a/Master/texmf-dist/doc/latex/inputtrc/README
+++ b/Master/texmf-dist/doc/latex/inputtrc/README
@@ -2,7 +2,7 @@
 
          Tracing Which File Loads Which
 
-             (C) Uwe Lück 2010/10/08
+             (C) Uwe Lück 2010/10/09
 
        http://www.contact-ednotes.sty.de.vu 
 
@@ -12,7 +12,7 @@
 <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. 
+can be chosen. `RETURNING TO <current>' may be added.
 
 The implementation somewhat resembles packages 
 'FiNK' and 'inputfile'.
diff --git a/Master/texmf-dist/doc/latex/inputtrc/README.txt b/Master/texmf-dist/doc/latex/inputtrc/README.txt
index b074070ff13..1b38f5843a8 100644
--- a/Master/texmf-dist/doc/latex/inputtrc/README.txt
+++ b/Master/texmf-dist/doc/latex/inputtrc/README.txt
@@ -2,7 +2,7 @@
 
          Tracing Which File Loads Which
 
-             (C) Uwe Lück 2010/10/08
+             (C) Uwe Lück 2010/10/09
 
        http://www.contact-ednotes.sty.de.vu 
 
@@ -12,7 +12,7 @@
 <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. 
+can be chosen. `RETURNING TO <current>' may be added.
 
 The implementation somewhat resembles packages 
 'FiNK' and 'inputfile'.
diff --git a/Master/texmf-dist/doc/latex/inputtrc/inputtrc.pdf b/Master/texmf-dist/doc/latex/inputtrc/inputtrc.pdf
index 8cf982b75b1..d02130184e8 100644
--- a/Master/texmf-dist/doc/latex/inputtrc/inputtrc.pdf
+++ b/Master/texmf-dist/doc/latex/inputtrc/inputtrc.pdf
diff --git a/Master/texmf-dist/doc/latex/inputtrc/inputtrc.tex b/Master/texmf-dist/doc/latex/inputtrc/inputtrc.tex
index 21308958583..b432c4d1d6b 100644
--- a/Master/texmf-dist/doc/latex/inputtrc/inputtrc.tex
+++ b/Master/texmf-dist/doc/latex/inputtrc/inputtrc.tex
@@ -1,16 +1,13 @@
-\typeout{inputtrc.tex 2010/10/08b documenting inputtrc.sty}
-\title{\textsf{inputtrc.sty}\\---\\Tracing Which File Loads Which}
-% \thanks{This
-%     manual describes package version
-%     version 0.2 as of April 09, 2009%%%\fileversion\ as of \filedate\ 
-%     .}}%%%of the package.}%
+\typeout{inputtrc.tex 2010/10/09 documenting inputtrc.sty}
+\title{\textsf{inputtrc.sty}\\---\\Tracing Which File Loads 
+       Which\thanks{This manual describes package version v0.2.}}
 % \listfiles 
-\RequirePackage{inputtrc}\dotracinginputs
+\RequirePackage{inputtrc} %%% \dotracinginputs %%% returns
 % \setinputindentunit{\space\space\space}
 { \RequirePackage{makedoc} \ProcessLineMessage{} 
   \MakeJobDoc{17}{\SectionLevelTwoParseInput}  }
 \documentclass{article}%% TODO paper dimensions!?
-\notracinginputs
+% \notracinginputs
 \input{makedoc.cfg} %% shared formatting settings
 \sloppy
 \begin{document}
@@ -23,7 +20,8 @@ on \LaTeX\ input commands,
 The message indents reflect the input nesting level. 
 This can be turned on and off, and the ``indent unit" 
 can be chosen. 
-The implementation somewhat resembles packages 
+\qtd{\texttt{RETURNING~TO <current>}} may be 
+added.---The implementation somewhat resembles packages 
 \ctanpkgref{fink} and \ctanpkgref{inputfile}.
 \end{abstract}
 \tableofcontents
@@ -31,6 +29,7 @@ The implementation somewhat resembles packages
   \newpage      %% 2010/10/08b
 \section{Features and Usage}
 
+\subsection{Installing and Calling}
 The file 'inputtrc.sty' is provided ready, installation only requires 
 putting it somewhere where \TeX\ finds it 
 (which may need updating the filename data 
@@ -46,7 +45,8 @@ then precede `\documentclass' with
   \RequirePackage{inputtrc}\dotracinginputs
 \end{verbatim}
 
-Indeed, the feature messages appear after the command 
+\subsection{Input}
+Indeed, the `INPUTTING' messages appear after command 
 |\dotracinginputs| only. The command |\notracinginputs|
 turns the feature off again. 
 
@@ -73,11 +73,24 @@ spaces if you insert
 \emph{without braces} is not recognized: it neither produces a message 
 nor changes the indent, and with 
 \begin{quote}
-  `\input <file>'
+  \hspace*{-1.2pc}\texttt{\string\input\ <file>}
 \end{quote}
 where <file> loads other files, files that <file> loads directly 
 produce \emph{wrong} messages. 
 
+\subsection{After Input}
+|\dotracingreturns| adds a message 
+\qtd{\texttt{RETURNING TO <current>}} after 
+\qtd{\texttt{<current> INPUTTING <next>}}
+meaning that processing file <next> has been finished. 
+Use |\notracingreturns| to turn this additional 
+feature off again. 
+
+|\dotracinginputsreturns| calls both 
+both `\dotracinginputs' and\\ `\dotracingreturns' 
+at the same time.
+
+
 \section{What it is Good for}
 
 \TeX's primitive `\input' (that \LaTeX\ represents as \cs{@@input})
@@ -99,7 +112,7 @@ warning is shown, but not the \emph{file name}.
 %   \pagebreak    %% 2010/10/08b
 Indeed on the 'texhax' mailing list, \emph{Karl Berry} posted the 
 following:\footnote{\url{http://tug.org/mailman/htdig/texhax/2010-February/014305.html}}
-\begin{quote}\itshape
+\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
@@ -121,7 +134,7 @@ following:\footnote{\url{http://tug.org/mailman/htdig/texhax/2010-February/01430
 The subject line was \textit{\dqtd{tex filename backtrace 
 utility}}.---\emph{Ronald Fehd} 
 joined:\footnote{\url{http://tug.org/mailman/htdig/texhax/2010-February/014311.html}} 
-\begin{quote}\itshape
+\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.
@@ -133,7 +146,8 @@ 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'. 
+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 
@@ -146,178 +160,340 @@ 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
-(one would have to
-parse the characters one by one, and I'm not ready to do so\dots)
+\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. 
 
-  \pagebreak    %% 2010/10/08b
+%   \pagebreak    %% 2010/10/08b    %% rm 2010/10/09
 \section{Example}
 It is especially nice to watch 'hyperref' loading quite a bunch 
-from Heiko's 'oberdiek' 
-bundle:\footnote{\url{http://ctan.org/pkg/oberdiek}}
-\begingroup \hfuzz=10pc
-\begin{verbatim}
-      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)
-)
-      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
-)
-      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)
-)
-        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.
-))
-      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.
-)
-Package pdftexcmds Info: LuaTeX not detected on input line 145.
-))
-      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.
-)
-      hyperref.sty INPUTTING ifxetex.sty 
-(/usr/share/texmf/tex/generic/ifxetex/ifxetex.sty
-Package: ifxetex 2010/09/12 v0.6 Provides ifxetex conditional
-)
-      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
-))
-      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)
-)
-\@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)
-)
-      hyperref.sty INPUTTING intcalc.sty 
-(/usr/share/texmf/tex/generic/oberdiek/intcalc.sty
-Package: intcalc 2007/09/27 v1.1 Expandable integer calculations (HO)
-)
-      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
-)
-      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)
-)
-Package hyperref Info: Option `bookmarksnumbered' 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.
-)
-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)
-))
-\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)
-)
-\Hy@abspage=\count91
-\c@Item=\count92
-\c@Hfootnote=\count93
-)
-* hyperref using default driver hpdftex *
-    makedoc.cfg INPUTTING hpdftex.def 
-(/usr/share/texmf/tex/latex/hyperref/hpdftex.def
-File: hpdftex.def 2010/06/18 v6.81g Hyperref driver for pdfTeX
-
-      hpdftex.def 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).
-)
-\Fld@listcount=\count94
-\c@bookmark@seq@number=\count95
-
-      hpdftex.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 uniquecounter.sty 
-(/usr/share/texmf/tex/latex/oberdiek/uniquecounter.sty
-Package: uniquecounter 2009/12/18 v1.1 Provides unlimited unique counter (HO)
-)
-Package uniquecounter Info: New unique counter `rerunfilecheck' on input line 2
-71.
-)
-\Hy@SectionHShift=\skip43
-)
-\end{verbatim}
+from Heiko's 'oberdiek' bundle (on running the present 
+ 'inputtrc.tex'):\footnote{\url{http://ctan.org/pkg/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
@@ -328,5 +504,6 @@ Package uniquecounter Info: New unique counter `rerunfilecheck' on input line 2
 
 HISTORY
 
-2010/10/08  for v0.1    very first, sent to CTAN
+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)
diff --git a/Master/texmf-dist/tex/latex/inputtrc/inputtrc.sty b/Master/texmf-dist/tex/latex/inputtrc/inputtrc.sty
index e75c6fe4724..477b32e2ec6 100644
--- a/Master/texmf-dist/tex/latex/inputtrc/inputtrc.sty
+++ b/Master/texmf-dist/tex/latex/inputtrc/inputtrc.sty
@@ -1,5 +1,5 @@
 \NeedsTeXFormat{LaTeX2e}[1994/12/01]
-\ProvidesPackage{inputtrc}[2010/10/08 v0.1a input tracing (UL)]
+\ProvidesPackage{inputtrc}[2010/10/09 v0.2 input tracing (UL)]
 
 %% Copyright (C) 2010 Uwe Lueck, 
 %% http://www.contact-ednotes.sty.de.vu 
@@ -37,11 +37,16 @@
   \@@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) ===
 %%
@@ -78,10 +83,21 @@
     \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'.
+%% 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 \IT@the@returnmessage} 
+%% ---\emph{not} activated is the default:
+\notracingreturns
+%% |\dotracinginputsreturns| activates \emph{both} `INPUTTING' and 
+%% `RETURNING' messages:
+\newcommand*{\dotracinginputsreturns}{%
+    \dotracinginputs \dotracingreturns}
 %%
 \endinput
 %%
@@ -100,6 +116,7 @@
 
 HISTORY
 
-v0.1   2010/10/08   very first, sent to CTAN same day
+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
+                    manual page breaks -- installed on CTAN 2010/10/09 
+v0.2   2010/10/09   \IT@maybe@returnmessage etc.