From: Zac Medico <zmedico@gentoo.org>
Date: Mon, 21 Apr 2008 05:14:53 +0000 (-0000)
Subject: Document FEATURES="metadata-transfer" changes some more.
X-Git-Tag: v2.2_pre6~139
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=346feda72e1f9347926bc8a423475a01f31b0efd;p=portage.git

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

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

diff --git a/RELEASE-NOTES b/RELEASE-NOTES
index 4b57835f1..ead0d7f0f 100644
--- 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 1e6b42392..772a70a48 100644
--- 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 792491b8e..9164ada88 100644
--- 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