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.