From: Zac Medico Date: Sun, 22 Jul 2007 06:42:47 +0000 (-0000) Subject: Document --depclean and --prune enhancements. (trunk r7345) X-Git-Tag: v2.1.3~23 X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=022319f8b20f1713a4daa79f436b263735e42839;p=portage.git Document --depclean and --prune enhancements. (trunk r7345) svn path=/main/branches/2.1.2/; revision=7348 --- diff --git a/man/emerge.1 b/man/emerge.1 index db51d3318..3987f4e0c 100644 --- a/man/emerge.1 +++ b/man/emerge.1 @@ -90,18 +90,23 @@ has completed. This usually entails configuration file setup or other similar setups that the user may wish to run. .TP .BR \-\-depclean -Determines all packages installed on the system that have no -explicit reason for being there. \fBemerge\fR generates a list -of packages which it expects to be installed by checking the -\fBsystem\fR package list and the \fBworld\fR file. It then -compares that list to the list of packages which are actually -installed; the differences are listed as unnecessary packages -and then unmerged after a short timeout. \fBWARNING: Removing some +Cleans the system by removing packages that are not associated +with explicitly merged packages. Depclean works by creating the +full dependency tree from the system list and the world file, +then comparing it to installed packages. Packages installed, but +not associated with an explicit merge are listed as candidates +for unmerging. Inexperienced users are advised to use \fB\-\-pretend\fR +with this option in order to see a preview of which packages +will be uninstalled. \fBWARNING: Removing some packages may cause packages which link to the removed package -to stop working and complain about missing libraries.\fR -Re\-emerge the complaining package to fix this issue. Also see +to stop working and complain about missing libraries.\fR +Rebuild the complaining package to fix this issue. Also see \fB\-\-with\-bdeps\fR for behavior with respect to build time dependencies that -are not strictly required. +are not strictly required. Depclean serves as a dependency aware +version of \fB\-\-unmerge\fR. When given one or more atoms, it will +unmerge matched packages that have no reverse dependencies. Use +\fB\-\-depclean\fR together with \fB\-\-verbose\fR to show reverse +dependencies. .TP .BR "\-\-help " (\fB\-h\fR) Displays help information for emerge. Adding one of the additional @@ -128,7 +133,9 @@ PORTDIR_OVERLAY. In order to generate cache for overlays, use \fB\-\-regen\fR. \fBWARNING: This action can remove important packages!\fR Removes all but the highest installed version of a package from your system. This action doesn't verify the possible binary compatibility between versions and can thus remove -essential dependencies from your system. +essential dependencies from your system. Use \fB\-\-prune\fR together with +\fB\-\-verbose\fR to show reverse dependencies or with \fB\-\-nodeps\fR to +ignore all dependencies. .TP .BR \-\-regen Causes portage to check and update the dependency cache of all ebuilds in the @@ -178,8 +185,9 @@ description of PORTDIR_OVERLAY for a method to avoid deletions. \fBWARNING: This action can remove important packages!\fR Removes all matching packages. This does no checking of dependencies, so it may remove packages necessary for the proper operation of your -system. Its arguments can be \fIebuilds\fR, \fIsets\fR, or -\fIatoms\fR. +system. Its arguments can be \fIatoms\fR or +\fIebuilds\fR. For a dependency aware version of \fB\-\-unmerge\fR, +use \fB\-\-depclean\fR or \fB\-\-prune\fR. .TP .BR "\-\-update " (\fB\-u\fR) Updates packages to the best version available, which may not always be the diff --git a/pym/emergehelp.py b/pym/emergehelp.py index 4a6a042fa..8ac754ce9 100644 --- a/pym/emergehelp.py +++ b/pym/emergehelp.py @@ -64,10 +64,17 @@ def help(myaction,myopts,havecolor=1): print " full dependency tree from the system list and the world file," print " then comparing it to installed packages. Packages installed, but" print " not associated with an explicit merge are listed as candidates" - print " for unmerging."+turquoise(" WARNING: This can seriously affect your system by") - print " "+turquoise("removing packages that may have been linked against, but due to") - print " "+turquoise("changes in USE flags may no longer be part of the dep tree. Use") - print " "+turquoise("caution when employing this feature.") + print " for unmerging. Inexperienced users are advised to use --pretend" + print " with this option in order to see a preview of which packages will" + print " be uninstalled. "+turquoise(" WARNING: Removing some packages may cause") + print " "+turquoise("packages which link to the removed package to stop working and") + print " "+turquoise("complain about missing libraries. Rebuild the complaining package") + print " "+turquoise("to fix this issue.")+" Also see --with-bdeps for behavior with" + print " respect to build time dependencies that are not strictly" + print " required. Depclean serves as a dependency aware version of" + print " --unmerge. When given one or more atoms, it will unmerge matched" + print " packages that have no reverse dependencies. Use --depclean" + print " together with --verbose to show reverse dependencies." print print " "+green("--info") print " Displays important portage variables that will be exported to" @@ -90,8 +97,9 @@ def help(myaction,myopts,havecolor=1): print " Removes all but the highest installed version of a package" print " from your system. This action doesn't verify the possible binary" print " compatibility between versions and can thus remove essential" - print " dependencies from your system." - print " The argument format is the same as for the "+bold("--clean")+" action." + print " dependencies from your system. Use --prune together with" + print " --verbose to show reverse dependencies or with --nodeps to" + print " ignore all dependencies." print print " "+green("--regen") print " Causes portage to check and update the dependency cache of all" @@ -137,9 +145,11 @@ def help(myaction,myopts,havecolor=1): print print " "+green("--unmerge")+" ("+green("-C")+" short option)" print " "+turquoise("WARNING: This action can remove important packages!") - print " Removes all matching packages "+bold("completely")+" from" - print " your system. Specify arguments using the dependency specification" - print " format described in the "+bold("--clean")+" action above." + print " Removes all matching packages. This does no checking of" + print " dependencies, so it may remove packages necessary for the proper" + print " operation of your system. Its arguments can be atoms or" + print " ebuilds. For a dependency aware version of --unmerge, use" + print " --depclean or --prune." print print " "+green("--update")+" ("+green("-u")+" short option)" print " Updates packages to the best version available, which may not"