summaryrefslogtreecommitdiffstats
path: root/man/make.conf.5
diff options
context:
space:
mode:
authorZac Medico <zmedico@gentoo.org>2008-04-21 04:18:12 +0000
committerZac Medico <zmedico@gentoo.org>2008-04-21 04:18:12 +0000
commitbad09aeb4a4267cae3b320b4ad992575aab9c824 (patch)
tree4d4fe75800449327009cd97e3d7e2f2b21f0534f /man/make.conf.5
parentfd21c4439d5922802ba8d4e8362fabd0c73ecba3 (diff)
downloadportage-bad09aeb4a4267cae3b320b4ad992575aab9c824.tar.gz
portage-bad09aeb4a4267cae3b320b4ad992575aab9c824.tar.bz2
portage-bad09aeb4a4267cae3b320b4ad992575aab9c824.zip
* Make portdbapi.aux_get() automatically pull pre-generated metadata
directly from the metadata/cache/ directory when metadata-transfer is not enabled in FEATURES. This makes all cache modules behave similar to existing metadata_overlay module, except when FEATURES="metadata-transfer" has been explicitly enabled. * Remove metadata-transfer from FEATURES in make.globals so that it's no longer enabled by default. Users will be happy about this since the "Updating Portage cache" part of emerge --sync can be more time consuming than the rsync run itself. It's also nicer when when using PORTDIR over nfs or bind mounted in a chroot since there's no need to run emerge --metadata. * Update FEATURES="metadata-transfer" docs to warn users of the rsync tree to modify eclases in PORTDIR_OVERLAY if necessary instead of doing it directly in the rsync tree. * Relevant updates to /etc/portage/modules docs. (trunk r9930) svn path=/main/branches/2.1.2/; revision=9931
Diffstat (limited to 'man/make.conf.5')
-rw-r--r--man/make.conf.510
1 files changed, 10 insertions, 0 deletions
diff --git a/man/make.conf.5 b/man/make.conf.5
index 4d012c060..0d0f8549c 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -215,6 +215,16 @@ when \fImirror\fR is also in the \fBebuild\fR(5) \fBRESTRICT\fR variable.
.TP
.B metadata\-transfer
Automatically perform a metadata transfer when `emerge \-\-sync` is run.
+In versions of portage greater than 2.1.5, this feature is disabled by
+default. When metadata\-transfer is disabled, metadata cache from the
+${PORTDIR}/metadata/cache/ directory will be used directly (if available)
+and eclasses in ${PORTDIR}/eclass/ must not be modified except by
+`emerge \-\-sync` operations since the cache validation mechanism
+will not recognize eclass modifications. Normally, this issue only
+pertains to users of the rsync tree since the cvs tree does not contain
+a metadata/cache/ directory. Users of the rsync tree who want to modify
+eclasses should use \fBPORTDIR_OVERLAY\fR in order for the cache
+validation mechanism to work correctly.
.TP
.B mirror
Fetch everything in \fBSRC_URI\fR regardless of \fBUSE\fR settings,