summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/longnamefilelist/docsrc/longnamefilelist.tex
blob: 7685a6f46df3dc24da6025302f4fa83f85cd203b (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
\ProvidesFile{longnamefilelist.tex}[2012/03/14 documenting longnamefilelist.sty]
\title{\textsf{\Huge                            %% \Huge 2012/03/14
       longnamefilelist.sty}\\---\\\cs{listfiles} 
       when some File Names\\Consist of quite a Lot of 
       Characters, such as\\\relax
       [\,to be continued in next package update\,]\thanks{This
       document describes version
       \textcolor{blue}{\UseVersionOf{\jobname.sty}}
       of \textsf{\jobname.sty} as of \UseDateOf{\jobname.sty}.}}
{ \RequirePackage{makedoc} \ProcessLineMessage{}
  \MakeJobDoc{19}
  {\SectionLevelTwoParseInput}  }
\documentclass[fleqn]{article}%% TODO paper dimensions!?
\input{makedoc.cfg} %% shared formatting settings
\ReadPackageInfos{longnamefilelist}
\sloppy
\begin{document}
\maketitle
\begin{abstract}\noindent
'longnamefilelist.sty' equips \LaTeX's `\listfiles' with an optional 
argument for the number of characters in the longest base filename. 
This way you get a neatly aligned file list even when it contains 
files whose base names have more than 8 characters.
\end{abstract}
\tableofcontents

%   \newpage
% \section{Features and Usage}
\section{Installing and Calling}
The file 'longnamefilelist.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}           %% corr. 2011/02/08

%% extended 2011/01/14:
Below the `\documentclass' line(s) and above `\begin{document}',
you load 'longnamefilelist.sty' (as usually) by
\begin{verbatim}
  \usepackage{longnamefilelist}
\end{verbatim}
Alternatively---e.g., for use with \ctanpkgref{myfilist} from the 
\ctanpkgref{fileinfo} bundle, see~Sec.~\ref{sec:myfilist}, 
or in order to include the `.cls' file in the list---you may load it by 
\begin{verbatim}
  \RequirePackage{longnamefilelist}
\end{verbatim}
before `\documentclass' or when you don't use `\documentclass'. 

% \section{Example}

%   \pagebreak
% \section{Implementation}
\section{Package File Header (Legalese)} %% ize -> ese 2012/09/30
\input{longnamefilelist.doc}
\end{document}

VERSION HISTORY

2012/03/11  for v0.1    started
2012/03/12              completed 
2012/03/14      v0.1b   name in title \Huge
2012/09/30  for v0.2    ize -> ese