summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorZac Medico <zmedico@gentoo.org>2006-05-12 21:13:38 +0000
committerZac Medico <zmedico@gentoo.org>2006-05-12 21:13:38 +0000
commitef08e4db7221098e84bdd039498278697bf1c208 (patch)
tree612347fea2d0c21c99990bf6d62bb5fa94cee33a
parent5ecd101875bcceca468b0d4ab9a88d7379335a63 (diff)
downloadportage-ef08e4db7221098e84bdd039498278697bf1c208.tar.gz
portage-ef08e4db7221098e84bdd039498278697bf1c208.tar.bz2
portage-ef08e4db7221098e84bdd039498278697bf1c208.zip
Add some documentation for /etc/portage/modules and metadata_overlay.
svn path=/main/trunk/; revision=3342
-rw-r--r--man/portage.523
1 files changed, 23 insertions, 0 deletions
diff --git a/man/portage.5 b/man/portage.5
index 51e6f32d8..f124a10d2 100644
--- a/man/portage.5
+++ b/man/portage.5
@@ -37,6 +37,7 @@ virtuals
.BR /etc/portage/
.nf
bashrc
+modules
package.mask
package.unmask
package.keywords
@@ -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.
+
+.TP
+.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
+override.
+
+.I Example:
+.nf
+portdbapi.auxdbmodule = 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.
+
.TP
.BR package.mask
A list of DEPEND atoms to mask. Useful if specific versions of packages do