summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/fileinfo/myfilist.tex
blob: 38083b0832d56b36cf4c7c2b8fe1ce0989e4351a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
\ProvidesFile{myfilist.tex}[2011/01/29 documenting myfilist.sty]
\title{\textsf{myfilist}\\---\\
       List Infos on just the Files\\You Want to Know About%
       \GetFileInfo{myfilist.sty}\thanks{%
            This file describes version 
            \textcolor{blue}{\fileversion} % \textbf{\fileversion}
            of \textsf{\filename} as of \filedate.}}
% \listfiles

%% Preprocessing:
\RequirePackage{makedoc}
\CopyFDconditionFromTo{PScomment}{comment}
% \MainDocParser{\ProcessInputWith{PScomment}}
%% Replacements:
\SetPatternCodes{\MakeOther\\\MakeOther\ } %% CARE!
\MakeExpandableAllReplacer{LaTeX2e}{LaTeX2e }{\LaTeXe }{LEAVE}
% \MakeExpandableAllReplacer{TeX}{\TeX }{\TeX{} }{LEAVE}
\PrependExpandableAllReplacer{log}{ .log}{ `.log'} 
\PrependExpandableAllReplacer{tex}{ .tex}{ `.tex'} 
\PrependExpandableAllReplacer{cls}{ .cls}{ `.cls'} 
\PrependExpandableAllReplacer{sty}{ .sty}{ `.sty'} 
\PrependExpandableAllReplacer{NOTE}{NOTE: }{\textbf{Note: }} 
\SetPatternCodes{\MakeOther\\}             %% less care needed 
\PrependExpandableAllReplacer{dots}{...}{$\dots$} 
\PrependExpandableAllReplacer{provf}{\ProvidesFile}{`\ProvidesFile'} 
\PrependExpandableAllReplacer{loads}{"loads"}{``loads''} 
\PrependExpandableAllReplacer{USAGE}{USAGE:}{\section{Usage}} 
\PrependExpandableAllReplacer{IMPLEM}
                             {IMPLEMENTATION:}{\section{Implementation}} 
\PrependExpandableAllReplacer{gather}
                             {gather.tex}{`gather.tex'}
\PrependExpandableAllReplacer{readprov.pdf}
                             {readprov.pdf}{`readprov.pdf'}
\PrependExpandableAllReplacer{readprov-}    %% 2010/11/26
                             {readprov-.sty}{readprov.sty}
\PrependExpandableAllReplacer{readprov}
                             {readprov.sty}{'readprov.sty'}
\PrependExpandableAllReplacer{myfilist-}    %% 2010/11/26
                             {myfilist-.sty}{myfilist.sty} 
\PrependExpandableAllReplacer{myfilist}
                             {myfilist.sty}{'myfilist.sty'} 
\PrependExpandableAllReplacer{rungather}[\MakeOther\ ]%
{run gather.tex}{\emph{run} gather.tex}
  %% <- TODO \PrependStandardEnhancement...
\SetCorrectHookJobLast
\ResetPatternCodes

\MainDocParser{\ProcessInputWith{PScomment}}
\LaTeXresultFile{myfilist.doc}
\MakeCloseDoc{myfilist.sty}
  %% <- we must NOT read mdoccorr.cfg here! 
  %%    (or put the above setup into a new one!) ->
% \MakeJobDoc{0}{\ProcessInputWith{PScomment}}

%% Typesetting:
\documentclass{article}
\usepackage{color} %% for highlighting package version!? TODO
\input{makedoc.cfg}
\ReadPackageInfos{myfilist}
\usepackage{wiki}
%% TeX markup inserted by the txt-to-TeX function must be 
%% declared here for using 'niceverb''s ``auto mode". 
\AddToNoVerbList{\LaTeXe\dots\textbf\emph}
\begingroup \MakeActive\" 
 \gdef\fineDQ{``\begingroup
   \let\do\MakeOther \dospecials \tt
   \def"{\endgroup''}}%
\endgroup

\pagestyle{headings}
\usepackage{parskip}

\begin{document}

\maketitle 

\begin{abstract}\sloppy\noindent
  'myfilist' addresses lazy file versions management, 
  when you move your package or chapter files through 
  various computers and various directories and after a while 
  wonder where the most recent versions are.

  Like Paul Ebermann's 
  'dateiliste',\urlfoot{CtanPkgRef}{dateiliste}
  'myfilist' varies \LaTeX's `\listfiles' 
  for listing file (especially version) informations. 
  Differences to 'dateiliste' and \LaTeX\ are:
  \begin{enumerate}
    \item You choose the files (and their order) to be listed;
    \item indeed: this has very little to do with files used in 
          typesetting some document;
    \item output is just screen, `.log', or a `.txt'-type file 
          that you choose. 
  \end{enumerate}

  The code of this package was ready in spring 2008; 
  in spring 2010 I presented it as a kind of study on improving 
  'nicetext''s\urlfoot{CtanPkgRef}{nicetext}
  `txt'-to-\LaTeX\ processing after 'nicetext v0.4' 
  (aim was to do this without modifying the documented file, 
   yet I did not obey this ruly strictly here).
  The new idea is adding 'wiki.sty''s ``environments'' 
  feature to 'makedoc' and 'niceverb''s ``auto mode" 
  in order to interprete `txt' comment indents in the package file, 
  while 'wiki.sty''s \emph{font} switching 
  still is not compatible with 'niceverb''s. Easy script 
  commands for achieving this are still missing (sorry; see the code 
  in 'myfilist.tex' that achieved the present formatting.)
\end{abstract}

\pagebreak
\tableofcontents

\section{Installing}
The file '\jobname.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}
\section{File Info Header}

\sloppy 
\wikiEnvironments %% TODO fails with "or" 2010/03/31
\MakeActiveLetHere\"\fineDQ %% fails with "loads"
\AutoCmdInput{myfilist.doc}
\nowikiEnvironments

\section{Example}
`gather.tex' for the present bundle has been as follows 
  %% TODO 2010/11/27:
(added development versions of 'fifinddo.sty' etc.):
\verbatiminput{gather}              %% 2010/11/27

\end{document}