summaryrefslogtreecommitdiffstats
path: root/man/portage.5
diff options
context:
space:
mode:
authorZac Medico <zmedico@gentoo.org>2008-04-21 04:00:24 +0000
committerZac Medico <zmedico@gentoo.org>2008-04-21 04:00:24 +0000
commit81db3e467cd7f8bb94fcdf96d5fb4acf27bf382b (patch)
tree4307c7dbbdb26e455ec60aa34714fc89f62cebaa /man/portage.5
parentc829201cd5e92666b3610b46dec0391e62fbe16e (diff)
downloadportage-81db3e467cd7f8bb94fcdf96d5fb4acf27bf382b.tar.gz
portage-81db3e467cd7f8bb94fcdf96d5fb4acf27bf382b.tar.bz2
portage-81db3e467cd7f8bb94fcdf96d5fb4acf27bf382b.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. svn path=/main/trunk/; revision=9930
Diffstat (limited to 'man/portage.5')
-rw-r--r--man/portage.521
1 files changed, 9 insertions, 12 deletions
diff --git a/man/portage.5 b/man/portage.5
index 0599c5e09..792491b8e 100644
--- a/man/portage.5
+++ b/man/portage.5
@@ -384,18 +384,15 @@ override.
.I Example:
.nf
-portdbapi.auxdbmodule = portage.cache.metadata_overlay.database
-.fi
-
-The metadata_overlay cache module makes it possible to disable
-FEATURES="metadata-transfer" in \fBmake.conf\fR(5). When the user initially
-enables metadata_overlay in /etc/portage/modules, all of the cache files
-contained in /var/cache/edb/dep/${PORTDIR} must be manually removed in order
-to avoid unecessary cache regeneration. In addition, users of the
-metadata_overlay module must never modify eclasses in ${PORTDIR} because
-portage will not be able to detect that cache regeneration is necessary. If
-the user would like to modify eclasses, it is safe to use metadata_overlay
-together with PORTDIR_OVERLAY in \fBmake.conf\fR.
+portdbapi.auxdbmodule = portage.cache.sqlite.database
+.fi
+
+After changing the portdbapi.auxdbmodule setting, it may be necessary to
+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)).
.TP
.BR package.keywords
Per\-package KEYWORDS. Useful for mixing unstable packages in with a normally