aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2007-10-22 22:19:29 +0000
committerAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2007-10-22 22:19:29 +0000
commit2d8a8fc45833a532a8b37f025c79a59c308f8b4c (patch)
tree9442e4abc4e0bc5ff71a9a8de6bee244cc2560c1
parent1cae1267f780527671a3ce9728f921a8c0264148 (diff)
downloadpaludis-2d8a8fc45833a532a8b37f025c79a59c308f8b4c.tar.gz
paludis-2d8a8fc45833a532a8b37f025c79a59c308f8b4c.tar.xz
package_mask.conf
-rw-r--r--doc/configuration/Makefile.am13
-rw-r--r--doc/configuration/packagemask.html.part.in31
2 files changed, 44 insertions, 0 deletions
diff --git a/doc/configuration/Makefile.am b/doc/configuration/Makefile.am
index 151baba..31f1bf9 100644
--- a/doc/configuration/Makefile.am
+++ b/doc/configuration/Makefile.am
@@ -19,6 +19,8 @@ CLEANFILES = *~ gmon.out *.gcov *.gcno *.gcda \
environment.html.part \
keywords.html \
keywords.html.part \
+ package_mask.html \
+ package_mask.html.part \
use.html \
use.html.part \
licenses.html \
@@ -40,6 +42,7 @@ EXTRA_DIST = \
specpath.html.part.in \
environment.html.part.in \
keywords.html.part.in \
+ package_mask.html.part.in \
mirrors.html.part.in \
use.html.part.in \
paludisenvironmentonly.html.part \
@@ -57,6 +60,7 @@ paludisconfigurationhtml_DATA = \
specpath.html \
environment.html \
keywords.html \
+ package_mask.html \
mirrors.html \
licenses.html \
use.html \
@@ -137,6 +141,12 @@ keywords.html.part : $(srcdir)/keywords.html.part.in $(srcdir)/paludisenvironmen
-e 's,###PALUDISENVIRONMENTONLY###,,g' \
< $(srcdir)/keywords.html.part.in > keywords.html.part
+package_mask.html.part : $(srcdir)/package_mask.html.part.in $(srcdir)/paludisenvironmentonly.html.part
+ sed \
+ -e '/###PALUDISENVIRONMENTONLY###/r $(srcdir)/paludisenvironmentonly.html.part' \
+ -e 's,###PALUDISENVIRONMENTONLY###,,g' \
+ < $(srcdir)/package_mask.html.part.in > package_mask.html.part
+
mirrors.html.part : $(srcdir)/mirrors.html.part.in $(srcdir)/paludisenvironmentonly.html.part
sed \
-e '/###PALUDISENVIRONMENTONLY###/r $(srcdir)/paludisenvironmentonly.html.part' \
@@ -167,6 +177,9 @@ environment.html : header.html.part environment.html.part footer.html.part
keywords.html : header.html.part keywords.html.part footer.html.part
cat header.html.part keywords.html.part footer.html.part > $@
+package_mask.html : header.html.part package_mask.html.part footer.html.part
+ cat header.html.part package_mask.html.part footer.html.part > $@
+
mirrors.html : header.html.part mirrors.html.part footer.html.part
cat header.html.part mirrors.html.part footer.html.part > $@
diff --git a/doc/configuration/packagemask.html.part.in b/doc/configuration/packagemask.html.part.in
new file mode 100644
index 0000000..0451d5c
--- /dev/null
+++ b/doc/configuration/packagemask.html.part.in
@@ -0,0 +1,31 @@
+<!-- vim: set tw=120 ft=html sw=4 sts=4 et : -->
+
+<h1>package_mask.conf and package_unmask.conf</h1>
+
+###PALUDISENVIRONMENTONLY###
+
+<p>The <code>package_mask.conf</code> file allows a packages to be explicitly masked. The
+<code>package_unmask.conf</code> file allows repository and profile masked packages to be unmasked. Both are standard
+configuration files which may be bash files and which may use a <code>.conf.d/</code> directory.</p>
+
+<p>Each line in the file consists of a specification.</p>
+
+<h2>Example</h2>
+
+<p>An example <code>package_mask.conf</code>:</p>
+
+<pre>
+# Mask gcc 4.2 for now
+sys-devel/gcc:4.2
+
+# Mask all versions of Portage
+sys-apps/portage
+</pre>
+
+<p>And an example <code>package_unmask.conf</code>:</p>
+
+<pre>
+# Ignore repository and profile masks for things in the toolchain overlay
+*/*::toolchain
+</pre>
+