Update emerge --metadata docs for more clarity.

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

diff --git a/man/emerge.1 b/man/emerge.1
index 671c2203df38c81f866940dff76b7ecdf35196db..1357d395328f871f4799f7ee808513eb201c9469 100644 (file)
--- a/man/emerge.1
+++ b/man/emerge.1
@@ -117,10 +117,12 @@ information when submitting a bug report.\fR  Expanded output can be obtained
 with the \fI\-\-verbose\fR option.
 .TP
 .BR \-\-metadata
-Causes portage to process all the metacache files as is normally done on the 
-tail end of an rsync update using \fBemerge \-\-sync\fR.  The processing 
-creates the cache database that portage uses for pre\-parsed lookups of 
-package data.
+Transfers metadata cache from ${PORTDIR}/metadata/cache/ to
+/var/cache/edb/dep/ as is normally done on the
+tail end of an rsync update using \fBemerge \-\-sync\fR.  This process
+populates the cache database that portage uses for pre-parsed lookups of
+package data.  It does not populate cache for the overlays listed in
+PORTDIR_OVERLAY.  In order to generate cache for overlays, use \fB\-\-regen\fR.
 .TP
 .BR "\-\-prune " (\fB\-P\fR)
 \fBWARNING: This action can remove important packages!\fR  Prune looks at each

diff --git a/pym/emergehelp.py b/pym/emergehelp.py
index e9949dd2ae983111602bab9e328ac76360ac7ff0..e7f87aacf42fed3b75c153df3258ca96b4c0bc1b 100644 (file)
--- a/pym/emergehelp.py
+++ b/pym/emergehelp.py
@@ -80,10 +80,13 @@ def help(myaction,myopts,havecolor=1):
                print "              run with the '--verbose' flag."
                print
                print "       "+green("--metadata")
-               print "              Causes portage to process all the metacache files as is normally "
-               print "              done on the tail end of an rsync update using "+bold("emerge --sync")+"."
-               print "              This processing creates the cache database that portage uses for"
-               print "              pre-parsed lookups of package data."
+               print "              Transfers metadata cache from ${PORTDIR}/metadata/cache/ to"
+               print "              /var/cache/edb/dep/ as is normally done on the tail end of an"
+               print "              rsync update using " + bold("emerge --sync") + ". This process populates the"
+               print "              cache database that portage uses for pre-parsed lookups of"
+               print "              package data.  It does not populate cache for the overlays"
+               print "              listed in PORTDIR_OVERLAY.  In order to generate cache for"
+               print "              overlays, use " + bold("--regen") + "."
                print
                print "       "+green("--prune")+" ("+green("-P")+" short option)"
                print "              "+turquoise("WARNING: This action can remove important packages!")