Document FEATURES="metadata-transfer" changes some more.

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

diff --git a/RELEASE-NOTES b/RELEASE-NOTES
index 4b57835f109bcba34abaee746d3b21770e875b62..ead0d7f0f192f3d3bcf2ad360e2fe5f41af1fa61 100644 (file)
--- a/RELEASE-NOTES
+++ b/RELEASE-NOTES
@@ -35,6 +35,12 @@ portage-2.2
 portage-2.1.5
 ==================================
 
+* The metadata-transfer feature is now disabled by default. This disables the
+  "Updating Portage cache" routine that used to run at the tail end of each
+  `emerge --sync` operation. If you use something like the sqlite module and
+  want to keep all metadata in that format alone (useful for querying), enable
+  FEATURES="metadata-transfer" in make.conf.
+
 * The parallel-fetch feature is now enabled by default. It is optimized
   to avoid doing redundant checksums for previously downloaded files that have
   the correct size. Run `tail -f /var/log/emerge-fetch.log` in a

diff --git a/man/emerge.1 b/man/emerge.1
index 1e6b423929dd439aecb53625cfef8124bbd645a5..772a70a488716d830bf7b7b9074149e798305880 100644 (file)
--- a/man/emerge.1
+++ b/man/emerge.1
@@ -133,6 +133,8 @@ 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.
+In versions of portage >=2.1.5 the \-\-metadata action is totally unnecessary
+unless the user has enabled FEATURES="metadata-transfer" in \fBmake.conf\fR(5).
 .TP
 .BR "\-\-prune " (\fB\-P\fR)
 \fBWARNING: This action can remove important packages!\fR  Removes all but the

diff --git a/man/portage.5 b/man/portage.5
index 792491b8e0e03137178e9f93984e23c275086df8..9164ada887b7bcbb2be4796e45611d862c10b0b1 100644 (file)
--- a/man/portage.5
+++ b/man/portage.5
@@ -392,7 +392,9 @@ transfer or regenerate metadata cache. Users of the rsync tree need to
 run `emerge \-\-metadata` if they have enabled FEATURES="metadata-transfer"
 in \fBmake.conf\fR(5). In order to regenerate metadata for repositories
 listed in \fBPORTDIR_OVERLAY\fR or a cvs tree, run `emerge \-\-regen`
-(see \fBemerge\fR(1)).
+(see \fBemerge\fR(1)). If you use something like the sqlite module and want
+to keep all metadata in that format alone (useful for querying), enable
+FEATURES="metadata-transfer" in \fBmake.conf\fR(5).
 .TP
 .BR package.keywords
 Per\-package KEYWORDS.  Useful for mixing unstable packages in with a normally