Bug #309699 - Update --emptytree docs. Thanks to Ben Kohler <bkohler@gmail.com>

for wording suggestions.

svn path=/main/trunk/; revision=15831

diff --git a/man/emerge.1 b/man/emerge.1
index 7b232056dbfbec54bfb6b1eba5961febc876bf08..f451e2f67c2a9e904c3fdd70d11cdfc8042ba646 100644 (file)
--- a/man/emerge.1
+++ b/man/emerge.1
@@ -354,10 +354,10 @@ behavior with respect to build time dependencies that are not strictly
 required.
 .TP
 .BR "\-\-emptytree " (\fB\-e\fR)
-Reinstalls all world packages and their dependencies to the current USE 
-specifications while differing from the installed set of packages as 
-little as possible.  You should run with \fB\-\-pretend\fR first to make 
-sure the result is what you expect.
+Reinstalls target atoms and their entire deep
+dependency tree, as though no packages are currently
+installed. You should run this with \fB\-\-pretend\fR
+first to make sure the result is what you expect.
 .TP
 .BR "\-\-fail\-clean[=n]"
 Clean up temporary files after a build failure. This is

diff --git a/pym/_emerge/help.py b/pym/_emerge/help.py
index 409bbe2909ff351bf9a4c6a689ae3a9950dd0970..0a3cf3e6e60b5e8325ab9b9a154b1c5b1ba98c12 100644 (file)
--- a/pym/_emerge/help.py
+++ b/pym/_emerge/help.py
@@ -372,10 +372,12 @@ def help(myopts, havecolor=1):
                print("              dependencies that are not strictly required.")
                print() 
                print("       "+green("--emptytree")+" ("+green("-e")+" short option)")
-               print("              Virtually tweaks the tree of installed packages to contain")
-               print("              nothing. This is great to use together with --pretend. This makes")
-               print("              it possible for developers to get a complete overview of the")
-               print("              complete dependency tree of a certain package.")
+               desc = "Reinstalls target atoms and their entire deep " + \
+                       "dependency tree, as though no packages are currently " + \
+                       "installed. You should run this with --pretend " + \
+                       "first to make sure the result is what you expect."
+               for line in wrap(desc, desc_width):
+                       print(desc_indent + line)
                print()
                print("       "+green("--fail-clean[=n]"))
                desc = "Clean up temporary files after a build failure. This is " + \