CONFIGURATION 
-------------
You can configure some default values at compile-time. Some of these
may be overridden at run-time. See the list of C constants below for 
a detailed explanation of the options.

The configure options that do not take an argument (like --with-xalloc)
can be set by using --without-var (e.g. --without-xalloc).

configure option           C-constant                 override at runtime
---------------------------------------------------------------------------
--with-xalloc              USE_XALLOC                      no
--with-nice                DEFAULT_NICE                    yes
--with-priority=PRIOR      DEFAULT_PRIORITY                yes
--with-isfa                ALL_PACKAGES_IMPLY_SECTION      yes
                           STATUS_FILE                     yes
                           REG_FLAGS                       no
                           KEEPER_FILE                     yes
--without-debfoster        IGNORE_DEBFOSTER                yes
                           DEBFOSTER_KEEP                  no
----------------------------------------------------------------------------
The following constants are defined at the bottom of config.h:
 STATUS_FILE   - The location of your status file 
                 (default: "/var/lib/dpkg/status")
 USE_XALLOC    - Safe memory allocation. A little bit slower, and a whole
                 lot safer.
                 (default: 1)
 DEFAULT_NICE  - Count 'recommends' and 'suggests' as 'depends'. This
                 option can be overridden by passing the -n option to deborphan.
                 (default: 1)
 DEFAULT_PRIORITY - The default priority to use when searching for packages.
                    See the manual page (under --priority) for more information
                    (default: 2) 
 REG_FLAGS     - Bitwise or'd list of options to pass to regcomp(3). Unsetting 
                 REG_ICASE will violate the dpkg standard, but is not likely 
                 to cause problems. Note that REG_EXTENDED is hard-coded.
                 (default: REG_ICASE)
 KEEPER_FILE   - Location of the file to store information about kept back
                 packages. This can only be changed via src/Makefile.am.
                 (default: /var/lib/deborphan/keep)
 ALL_PACKAGES_IMPLY_SECTION - Imply --show-section if --all-packages is used.
                              Shows in which sections the packages are. Can be
                              overridden with --no-show-section at runtime.
                              (default: 1)
 IGNORE_DEBFOSTER - Ignore debfoster's keepers file by default.
                    (default: 0)
 DEBFOSTER_KEEP   - Location of debfoster's keepers file. Undefine to never
                    use debfoster's keepfile.
                    (default: configure)

To get deborphan to run faster, run configure with the following options:
--without-nice --without-xalloc --with-priority=4 --without-isfa 
--with-bufsize=2000 --disable-nls

INSTALLATION
------------
Run the following commands:
  ./configure [your options]
  make all
  make install

TROUBLESHOOTING
---------------
If compilation fails on NLS (in po/ or intl/), try passing the
--disable-nls option to configure. If you don't want to use the
Dutch messages, supply --disable-nls for slightly faster operation.

REMOVING ALL SUGGESTED PACKAGES
-------------------------------
deborphan -p4 | xargs apt-get -u remove
Never run this command without looking at deborphan's output first!

If you decide you want to keep some packages use:
  deborphan -A libfoo libbar lib...
  deborphan -p4 | xargs apt-get -u remove

Next time you run deborphan, it will not display libfoo and libbar.
See the manual page for more information.

BUGS
----
deborphan does not check for "or" dependencies, i.e. when a package 
depends on libfoo OR libbar, both libfoo and libbar will be marked as 
being in use. Unless someone comes up with a bit of code to do this 
really fast, it will never be implemented.

If you discover a new bug, send a message describing your problems,
the output of deborphan, and your /var/lib/dpkg/status (if that is not
too private information) to "Cris van Pelt"@tribe.eu.org, or to the Debian
BTS if you are using the Debian package.

COPYING
-------
See the file COPYING provided in this package, or 
/usr/share/common-licenses/Artistic on a Debian system. Note that orphaner
has a different license, see util/orphaner for details.