Documentation/man1/pkgfoster.1

34 lines
1.5 KiB
Groff

." Text automatically generated by txt2man-1.4.7
.TH pkgfoster 1 "April 23, 2006" "" ""
.SH NAME
\fBpkgfoster \fP- clean orphaned packages
\fB
.SH SYNOPSIS
.nf
.fam C
\fBpkgfoster\fP
.fam T
.fi
.SH DESCRIPTION
\fBpkgfoster\fP is a simple interactive script you can use to clean up orphaned packages (i.e.,
packages not listed in the "Depends on: " line of any other installed package). It uses
prt-cache by default, so remember to build the cache with "prt-get cache". You can also
use normal prt-get by modifying the PRT_GET variable. The bash array FOSTERED
is read from and written to ~/.config/pkgfoster.conf, as a means of preserving your choices
regarding which packages to keep. If you run \fBpkgfoster\fP as a non-root user, make sure the user
is able to elevate permissions using sudo, doas, or 'su -c'.
.PP
Packages from the core collection are never considered for deletion, since some of them
might provide runtime dependencies yet not be listed in the "Depends on: " line. See
\fBPkgfile\fP(5) for an explanation of this practice.
.PP
Some packages flagged by \fBpkgfoster\fP might actually be optional (soft) dependencies of other
packages on your system. Use \fBrevdep\fP(1) to identify any breakage that you introduce by
removing these misidentified orphans, and rebuild the affected ports using
.B prt\-get update \-fr
(see \fBprt\-get\fP(8) for more detailed examples).
.SH AUTHORS
Jukka Heino <jukka@karsikkopuu.net>
.SH SEE ALSO
\fBprt\-cache\fP(8), \fBprt\-get\fP(8), \fBrevdep\fP(1)