From 21da7e187d6fc161d61d8139166d197ade6dfd83 Mon Sep 17 00:00:00 2001 From: Zac Medico Date: Tue, 3 Jun 2008 23:33:54 +0000 Subject: Update --depclean and package.provided docs to indicate interaction between them. svn path=/main/trunk/; revision=10563 --- pym/_emerge/help.py | 47 +++++++++++++++++++++++++++++++---------------- 1 file changed, 31 insertions(+), 16 deletions(-) (limited to 'pym/_emerge') diff --git a/pym/_emerge/help.py b/pym/_emerge/help.py index 1e3f54aff..1996a61ab 100644 --- a/pym/_emerge/help.py +++ b/pym/_emerge/help.py @@ -65,22 +65,37 @@ def help(myaction,myopts,havecolor=1): print " file setup or other similar setups that the user may wish to run." print print " "+green("--depclean") - print " Cleans the system by removing packages that are not associated" - print " with explicitly merged packages. Depclean works by creating the" - 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. 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." + paragraph = "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 and world sets, " + \ + "then comparing it to installed packages. Packages installed, but " + \ + "not part of the dependency tree, will be uninstalled by depclean. " + \ + "Inexperienced users are advised to use --pretend " + \ + "with this option in order to see a preview of which packages " + \ + "will be uninstalled." + for line in wrap(paragraph, desc_width): + print desc_indent + line + print + + paragraph = "WARNING: Removing some " + \ + "packages may cause packages which link to the removed package " + \ + "to stop working and complain about missing libraries. " + \ + "Rebuild the complaining package to fix this issue. Also see " + \ + "--with-bdeps for behavior with respect to build time dependencies that " + \ + "are not strictly required. Note that packages listed in " + \ + "package.provided (see portage(5)) may be removed by " + \ + "depclean, even if they are part of the world set." + for line in wrap(paragraph, desc_width): + print desc_indent + line + print + + paragraph = "Depclean serves as a dependency aware " + \ + "version of --unmerge. When given one or more atoms, it will " + \ + "unmerge matched packages that have no reverse dependencies. Use " + \ + "--depclean together with --verbose to show reverse " + \ + "dependencies." + for line in wrap(paragraph, desc_width): + print desc_indent + line print print " "+green("--info") print " Displays important portage variables that will be exported to" -- cgit v1.2.3-1-g7c22