~ubuntu-branches/debian/sid/deborphan/sid

« back to all changes in this revision

Viewing changes to README

  • Committer: Bazaar Package Importer
  • Author(s): Peter Palfrader
  • Date: 2001-10-28 01:28:24 UTC
  • Revision ID: james.westby@ubuntu.com-20011028012824-0jvhpixo5ldm3h85
Tags: upstream-1.0
ImportĀ upstreamĀ versionĀ 1.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
CONFIGURATION 
 
2
-------------
 
3
You can configure some default values at compile-time. Some of these
 
4
may be overridden at run-time. See the list of C constants below for 
 
5
a detailed explanation of the options.
 
6
 
 
7
The configure options that do not take an argument (like --with-xalloc)
 
8
can be set by using --without-var (e.g. --without-xalloc).
 
9
 
 
10
configure option           C-constant                 override at runtime
 
11
---------------------------------------------------------------------------
 
12
--with-xalloc              USE_XALLOC                      no
 
13
--with-nice                DEFAULT_NICE                    yes
 
14
--with-priority=PRIOR      DEFAULT_PRIORITY                yes
 
15
--with-isfa                ALL_PACKAGES_IMPLY_SECTION      yes
 
16
                           STATUS_FILE                     yes
 
17
                           REG_FLAGS                       no
 
18
                           KEEPER_FILE                     yes
 
19
--without-debfoster        IGNORE_DEBFOSTER                yes
 
20
                           DEBFOSTER_KEEP                  no
 
21
----------------------------------------------------------------------------
 
22
The following constants are defined at the bottom of config.h:
 
23
 STATUS_FILE   - The location of your status file 
 
24
                 (default: "/var/lib/dpkg/status")
 
25
 USE_XALLOC    - Safe memory allocation. A little bit slower, and a whole
 
26
                 lot safer.
 
27
                 (default: 1)
 
28
 DEFAULT_NICE  - Count 'recommends' and 'suggests' as 'depends'. This
 
29
                 option can be overridden by passing the -n option to deborphan.
 
30
                 (default: 1)
 
31
 DEFAULT_PRIORITY - The default priority to use when searching for packages.
 
32
                    See the manual page (under --priority) for more information
 
33
                    (default: 2) 
 
34
 REG_FLAGS     - Bitwise or'd list of options to pass to regcomp(3). Unsetting 
 
35
                 REG_ICASE will violate the dpkg standard, but is not likely 
 
36
                 to cause problems. Note that REG_EXTENDED is hard-coded.
 
37
                 (default: REG_ICASE)
 
38
 KEEPER_FILE   - Location of the file to store information about kept back
 
39
                 packages. This can only be changed via src/Makefile.am.
 
40
                 (default: /var/lib/deborphan/keep)
 
41
 ALL_PACKAGES_IMPLY_SECTION - Imply --show-section if --all-packages is used.
 
42
                              Shows in which sections the packages are. Can be
 
43
                              overridden with --no-show-section at runtime.
 
44
                              (default: 1)
 
45
 IGNORE_DEBFOSTER - Ignore debfoster's keepers file by default.
 
46
                    (default: 0)
 
47
 DEBFOSTER_KEEP   - Location of debfoster's keepers file. Undefine to never
 
48
                    use debfoster's keepfile.
 
49
                    (default: configure)
 
50
 
 
51
To get deborphan to run faster, run configure with the following options:
 
52
--without-nice --without-xalloc --with-priority=4 --without-isfa 
 
53
--with-bufsize=2000 --disable-nls
 
54
 
 
55
INSTALLATION
 
56
------------
 
57
Run the following commands:
 
58
  ./configure [your options]
 
59
  make all
 
60
  make install
 
61
 
 
62
TROUBLESHOOTING
 
63
---------------
 
64
If compilation fails on NLS (in po/ or intl/), try passing the
 
65
--disable-nls option to configure. If you don't want to use the
 
66
Dutch messages, supply --disable-nls for slightly faster operation.
 
67
 
 
68
REMOVING ALL SUGGESTED PACKAGES
 
69
-------------------------------
 
70
deborphan -p4 | xargs apt-get -u remove
 
71
Never run this command without looking at deborphan's output first!
 
72
 
 
73
If you decide you want to keep some packages use:
 
74
  deborphan -A libfoo libbar lib...
 
75
  deborphan -p4 | xargs apt-get -u remove
 
76
 
 
77
Next time you run deborphan, it will not display libfoo and libbar.
 
78
See the manual page for more information.
 
79
 
 
80
BUGS
 
81
----
 
82
deborphan does not check for "or" dependencies, i.e. when a package 
 
83
depends on libfoo OR libbar, both libfoo and libbar will be marked as 
 
84
being in use. Unless someone comes up with a bit of code to do this 
 
85
really fast, it will never be implemented.
 
86
 
 
87
If you discover a new bug, send a message describing your problems,
 
88
the output of deborphan, and your /var/lib/dpkg/status (if that is not
 
89
too private information) to "Cris van Pelt"@tribe.eu.org, or to the Debian
 
90
BTS if you are using the Debian package.
 
91
 
 
92
COPYING
 
93
-------
 
94
See the file COPYING provided in this package, or 
 
95
/usr/share/common-licenses/Artistic on a Debian system. Note that orphaner
 
96
has a different license, see util/orphaner for details.
 
97