Document FEATURES="metadata-transfer" changes some more. (trunk r9934)

svn path=/main/branches/2.1.2/; revision=9935

diff --git a/RELEASE-NOTES b/RELEASE-NOTES
index 0ee4869ce5b3d4343357b99568f083baec8a1458..28e34b2e21e15072573c4d817ec7e7eb51e58ef3 100644 (file)
--- a/RELEASE-NOTES
+++ b/RELEASE-NOTES
@@ -4,6 +4,12 @@ Features/major bugfixes are listed in NEWS
 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 db7b409e99763ceafac961f17d796254ffe3d4c1..6d75341223b17bf71e669237d14a8c4bb5248568 100644 (file)
--- a/man/emerge.1
+++ b/man/emerge.1
@@ -131,6 +131,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 5d953db83a476d1b2f3bd9d659f8e5d7d24ac5e3..aabff9f888a1e966be0e69f80d5020e3362438ea 100644 (file)
--- a/man/portage.5
+++ b/man/portage.5
@@ -395,7 +395,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