~stolowski/kleansweep/trunk

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
KleanSweep v0.2.9 (c)by Pawel Stolowski 2005-2006 <pawel.stolowski@wp.pl>
released under terms of GNU General Public License v2

1. Introduction
---------------

KleanSweep allows you to reclaim disk space by finding unneeded files. It can
search for files basing on several criterias; you can seek for:

* empty files 
* empty directories
* backup files 
* broken symbolic links 
* dead menu entries (.desktop files pointing to non-existing executables) 
* duplicated files
* broken executables (executables in PATH with broken dependecies - e.g. missing libraries)
* orphaned files (files not found in RPM or DEB database). 
* obsolete thumbnails (thumbnails conforming to freedesktop.org standard, pointing to
  non-existing pictures) - requires 'identify' from ImageMagick

Planned features: 
* seeking for orphaned files in Gentoo (portage) database
* seeking for unused locales
* and more!

KleanSweep consists of KDE-based (C++) graphical frontend and small helper Perl
script that performs actual searching. All searches, except for orphaned files,
duplicates and dead menu entries are as fast as usual 'find' would be.
KleanSweep requires KDE libraries and Perl. Note: I take no responsibility for
any damage caused by this program. Rate this project at kde-apps.org. 

2. Requirements
---------------
To compile KleanSweep you need:
- C++ compiler (gcc/g++)
- KDE 3.4.x libraries with developement headers (may or may not work with older version - not tested)
- Scons (optionally - you may use bundled one; see INSTALL)
- Python 

Note: due to incompatibility between current bksys with older Python
versions, you may need Python >= 2.2.3, until the problem is fixed.

Perl is also neeed by kleansweep-helper script, when running KleanSweep. You will also need 'identify' from
ImageMagick if you want to be able to seek for obsolete thumbnails.

3. Bugs
-------
Please report bugs to the author: pawel.stolowski@wp.pl

4. Credits
----------
Programming and left-side KleanSweep banner - Pawel Stolowski <pawel.stolowski@wp.pl>
Icon and logo - Troy Biggers