pkgfoster: initial commit

man1/pkgfoster.1

@@ -0,0 +1,33 @@
+." 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)