Add note in --depclean docs about link level dependency breakage.

svn path=/main/branches/2.1.6/; revision=12088

diff --git a/man/emerge.1 b/man/emerge.1
index c707496cf9754ca34101496eeab138f775016296..3598dacd50a55f73b435c52e4d94f13187ab89cb 100644 (file)
--- a/man/emerge.1
+++ b/man/emerge.1
@@ -119,7 +119,10 @@ option in order to see a preview of which packages
 will be uninstalled. Always study the list of packages
 to be cleaned for any obvious mistakes. Note that packages listed in
 package.provided (see \fBportage\fR(5)) may be removed by
-depclean, even if they are part of the world set.
+depclean, even if they are part of the world set. Also note that
+depclean may break link level dependencies. Thus, it is
+recommended to use a tool such as \fBrevdep-rebuild\fR(1)
+in order to detect such breakage.
 
 Depclean serves as a dependency aware
 version of \fB\-\-unmerge\fR. When given one or more atoms, it will

diff --git a/pym/_emerge/help.py b/pym/_emerge/help.py
index fe034afe011a92afb5cfd5a678308fda06d88377..34c0e1d29206943e8682139e3b87c41177607c31 100644 (file)
--- a/pym/_emerge/help.py
+++ b/pym/_emerge/help.py
@@ -91,7 +91,10 @@ def help(myaction,myopts,havecolor=1):
                "packages will be uninstalled. Always study the list of packages " + \
                "to be cleaned for any obvious mistakes. Note that packages " + \
                "listed in package.provided (see portage(5)) may be removed by " + \
-               "depclean, even if they are part of the world set."
+               "depclean, even if they are part of the world set. Also note that " + \
+               "depclean may break link level dependencies. Thus, it is " + \
+               "recommended to use a tool such as revdep-rebuild(1) " + \
+               "in order to detect such breakage."
 
                for line in wrap(paragraph, desc_width):
                        print desc_indent + line