From: Zac Medico <zmedico@gentoo.org>
Date: Mon, 21 Apr 2008 05:16:24 +0000 (-0000)
Subject: Document FEATURES="metadata-transfer" changes some more. (trunk r9934)
X-Git-Tag: v2.1.5~156
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=a465a04d7b59e00d20547051f67022432ec7bee5;p=portage.git

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 0ee4869ce..28e34b2e2 100644
--- 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 db7b409e9..6d7534122 100644
--- 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 5d953db83..aabff9f88 100644
--- 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