path: root/man
diff options
authorZac Medico <>2006-05-12 21:13:38 +0000
committerZac Medico <>2006-05-12 21:13:38 +0000
commitef08e4db7221098e84bdd039498278697bf1c208 (patch)
tree612347fea2d0c21c99990bf6d62bb5fa94cee33a /man
parentRevert r3339 because r3301 makes it unnecessary. See bug #133055. (diff)
Add some documentation for /etc/portage/modules and metadata_overlay.
svn path=/main/trunk/; revision=3342
Diffstat (limited to 'man')
1 files changed, 23 insertions, 0 deletions
diff --git a/man/portage.5 b/man/portage.5
index 51e6f32d..f124a10d 100644
--- a/man/portage.5
+++ b/man/portage.5
@@ -37,6 +37,7 @@ virtuals
.BR /etc/portage/
@@ -300,6 +301,28 @@ virtual/aspell\-dict app\-dicts/aspell\-en
If needed, this file can be used to set up a special environment for ebuilds,
different from the standard root environment. The syntax is the same as for
any other bash script.
+.BR modules
+This file can be used to override the metadata cache implementation. In
+practice, portdbapi.auxdbmodule is the only variable that the user will want to
+.I Example:
+portdbapi.auxdbmodule = cache.metadata_overlay.database
+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.
.BR package.mask
A list of DEPEND atoms to mask. Useful if specific versions of packages do