Add --help output for --unordered-display, and move man page docs from the

actions to the options section.

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

diff --git a/man/emerge.1 b/man/emerge.1
index bcdc747cafba5abae044c9e4705a3ab6a4dcb718..214abadbbbff5ab1d8e68eff9a05ccebf9e351cc 100644 (file)
--- a/man/emerge.1
+++ b/man/emerge.1
@@ -226,12 +226,6 @@ 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 "\-\-unordered-display "
-By default the displayed merge list is sorted using the order in
-which the packages will be merged. When \fB\-\-tree\fR is used together 
-with this option, this constraint is removed, hopefully leading to a 
-more readable dependency tree.
-.TP
 .BR "\-\-update " (\fB\-u\fR)
 Updates packages to the best version available, which may not always be the 
 highest version number due to masking for testing and development.
@@ -507,6 +501,13 @@ Shows the dependency tree for the given target by indenting dependencies.
 This is only really useful in combination with \fB\-\-emptytree\fR or 
 \fB\-\-update\fR and \fB\-\-deep\fR.
 .TP
+.BR "\-\-unordered\-display"
+By default the displayed merge list is sorted using the
+order in which the packages will be merged. When
+\fB\-\-tree\fR is used together with this option, this
+constraint is removed, hopefully leading to a more
+readable dependency tree.
+.TP
 .BR "\-\-use\-ebuild\-visibility[=n]"
 Use unbuilt ebuild metadata for visibility
 checks on built packages.

diff --git a/pym/_emerge/help.py b/pym/_emerge/help.py
index 346d77712a387ce19921aea36dad000ab4eb9a98..0a5e940842256181165dc0e64ccde8043a834497 100644 (file)
--- a/pym/_emerge/help.py
+++ b/pym/_emerge/help.py
@@ -538,6 +538,15 @@ def help(myopts, havecolor=1):
                print("              a package's dependencies follow the package. Only really useful")
                print("              in combination with --emptytree, --update or --deep.")
                print()
+               print("       " + green("--unordered-display"))
+               desc = "By default the displayed merge list is sorted using the " + \
+                       "order in which the packages will be merged. When " + \
+                       "--tree is used together with this option, this " + \
+                       "constraint is removed, hopefully leading to a more " + \
+                       "readable dependency tree."
+               for line in wrap(desc, desc_width):
+                       print(desc_indent + line)
+               print()
                print("       " + green("--use-ebuild-visibility") + "[=%s]" % turquoise("n"))
                desc = "Use unbuilt ebuild metadata for visibility " + \
                        "checks on built packages."