NAME

lintex - removes TeX-related garbage files

SYNOPSIS

lintex [ -i ] [ -r ] [ -b ext ] [ -p ] [ -k ] [ -o ] [ -q ] [ -v ] [ -d ] [ dir [ dir ... ]]

DESCRIPTION

lintex is a program that removes TeX-related auxiliary files, normally not needed after a successful TeX run (i.e. log, aux, dvi, ... files); they are actually removed only if their modification timestamp is more recent than the one of the related TeX source and if they aren't readonly. In addition, all the backup files that your favorite editor has generated are also removed.

OPTIONS

-i

Asks the user permission before actually removing any file.

-r

The given directories are scanned recursively; i.e., if they contain any subdirectory structure, all the tree will be cleaned up.

-b ext

ext is the trailer string (the ´extension´) that identifies the backup files generated by your editor, e.g. -b .bak; ext defaults to ~ (the tilde character), i.e. to the emacs convention. If ext includes characters having a special meaning for the shell, it must be enclosed in quotes: e.g. -b "~" (equivalent to the default). Specifying the null string, as in -b "", inhibits the cleanup of any special file.

-p

Pretends, show what files would be removed but don't actually remove them.

-k

Keeps final documents (.pdf, .ps, .dvi).

-o

Permits the removal of files older than their sources.

-q

Quiet, only prints error messages.

-v

Verbose, prints which files were removed and which weren't.

-d

Debug, prints the answers to all of life's questions.

PARAMETERS

dir

The name(s), separated by whitespace, of one or more directories to be cleaned; if missing, the default is the current directory.

EXTENSIONS THAT GET REMOVED

All files ending in the following extensions may be removed when appropriate:

.aux, .bbl, .bcf, .blg, .dvi, .idx, .ilg, .ind, .lof, .log, .lot, .nav, .out, .pdf, .ps, .snm, .thm, .toc, .toc.old, .synctex.gz, .xyc

ENVIRONMENT

The HOME environment variable determines the location of the configuration file, see FILES below.

FILES

Users can create a configuration file $HOME/.lintexrc which optionally contains the keys remove-exts and keep-exts, each followed by a Python style list of extensions to additionally remove or keep, respectively. Each extension must be preceded by a period, e.g. ".pdf" and not "pdf". The keep-exts key is only used when the keep option (-k) is passed. Note that the extensions listed in the keep-exts field replace the defaults used by the -k option. The keep-exts option also takes precedence over remove-exts: no file ending in an extension removed by default or listed in remove-exts will be deleted if its extension is listed in keep-exts and the -k option was passed. For example, the configuration file

keep-exts = [".pdf", ".ps", ".log"];
remove-exts = [".txt", ".1"];

will keep any file ending in ".pdf", ".ps" or ".log" when lintex is called with the -k option (but not files ending in ".dvi"), and adds ".txt" and ".1" to the list of extensions to check for removal. The following configuration file provides lintex with its default behaviour:

keep-exts = [".pdf", ".ps", ".dvi"];
remove-exts = [];

BUGS

lintex cannot handle extensions containing periods, for example, ".toc.old" and ".synctex.gz", since it splits filenames at the last period to find the extension, treating "foo.toc.old" as the file "foo.toc" with the extension ".old".

AUTHOR

lintex was written by Maurizio Loreti <Maurizio_Loreti@gmail.com> between 1996 and 2002.

As of 2010, lintex is maintained by Ryan Kavanagh <rak@debian.org>. It features several extensions/bug fixes. Feel free to email him with your comments and suggestions.

COPYRIGHT

Copyright © 1996–2002 Maurizio Loreti <Maurizio_Loreti@gmail.com>

Copyright © 2010–2015 Ryan Kavanagh <rak@debian.org>

lintex is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

lintex is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License (here included in the file COPYING), for more details.