From 7f666283b970518d97cf3a657b4150392c54cecc Mon Sep 17 00:00:00 2001 From: Zac Medico Date: Sun, 22 Jul 2007 06:33:51 +0000 Subject: Document --depclean and --prune enhancements. svn path=/main/trunk/; revision=7345 --- pym/emerge/help.py | 28 +++++++++++++++++++--------- 1 file changed, 19 insertions(+), 9 deletions(-) (limited to 'pym/emerge') diff --git a/pym/emerge/help.py b/pym/emerge/help.py index def367fd5..d7000aa15 100644 --- a/pym/emerge/help.py +++ b/pym/emerge/help.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" -- cgit v1.2.3-1-g7c22