summaryrefslogtreecommitdiff
path: root/support/lintex/README
blob: 554ecb889ed40ce0132beb084dcc0c14354de7e2 (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
"lintex" is a C program that removes auxilliary (La)TeX files that are
usually not needed after a (La)TeX run (log, aux, dvi, ... files);
they are however actually removed only if their modification time is
more recent than the one of the related TeX source.  The backup files
usually created by many editors are also removed.

To remove or not remove additional extensions, lintex can parse the
configuration file $HOME/.lintexrc . See the included example and the
manpage for more details

lintex is distributed under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.

Here follows an example run:

ryan@nu $ lintex -h
lintex version 1.13 (2012-09-11)
Usage:
  lintex [OPTIONS] [DIR [DIR ...]]
Purpose:
  Removes unneeded TeX auxiliary files and editor backup files from the
  given directories (default: the current directory); the TeX files are
  actually removed only if their modification time is more recent than
  the one of the related TeX source and if they aren't readonly.
  Please see the manpage for a list of extensions that get removed.
Options:
  -i     : asks the user before removing any file;
  -r     : scans recursively the subdirectories of the given
           directories;
  -b ext : "ext" is the trailing string identifying editor backup files
           (defaults to "~").  -b "" avoids any cleanup of special
           files;
  -p     : pretend, show what files would be removed but don't actually
           remove them;
  -k     : keeps final document (.pdf, .ps, .dvi, etc.);
  -o     : permit removal of files older than their sources;
  -q     : quiet, only print error messages;
  -v     : verbose, prints which files were removed and which weren't;
  -d     : debug output, prints the answers to all of life's questions.
ryan@nu $ ls -lR
.:
total 4
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 bar.aux
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 bar.dvi
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 bar.log
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 bar.pdf
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 bar.ps
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 bar.tex
drwxr-xr-x 2 ryan ryan 4096 Sep  3 18:26 dir1/
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 foo.aux
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 foo.dvi
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 foo.log
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 foo.pdf
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 foo.ps
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:28 foo.tex

./dir1:
total 0
-rw-r--r-- 1 ryan ryan 0 Sep  3 18:26 baz.aux
-rw-r--r-- 1 ryan ryan 0 Sep  3 18:26 baz.dvi
-rw-r--r-- 1 ryan ryan 0 Sep  3 18:26 baz.log
-rw-r--r-- 1 ryan ryan 0 Sep  3 18:26 baz.pdf
-rw-r--r-- 1 ryan ryan 0 Sep  3 18:26 baz.ps
-rw-r--r-- 1 ryan ryan 0 Sep  3 18:26 baz.tex
ryan@nu $ lintex -r README .
lintex: "README" cannot be opened (or is not a directory)
./bar.aux has been removed
./bar.dvi has been removed
./bar.log has been removed
./bar.pdf has been removed
./bar.ps has been removed
./dir1/baz.aux has been removed
./dir1/baz.dvi has been removed
./dir1/baz.log has been removed
./dir1/baz.pdf has been removed
./dir1/baz.ps has been removed
ryan@nu $ ls -lR
.:
total 4
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 bar.tex
drwxr-xr-x 2 ryan ryan 4096 Sep  3 18:26 dir1/
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 foo.aux
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 foo.dvi
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 foo.log
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 foo.pdf
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 foo.ps
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:28 foo.tex
-rw-r--r-- 1 ryan ryan    0 Sep  3 18:26 README

./dir1:
total 0
-rw-r--r-- 1 ryan ryan 0 Sep  3 18:26 baz.tex