aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2006-12-21 08:22:33 +0000
committerAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2006-12-21 08:22:33 +0000
commit9bfe015ea2cbd912d8df315f2f7c06a4a401d16f (patch)
treee53ba646c91d9279063422d22aa1f7bfc17c2789
parent6b75d062894dc7244e707391dda8e12033e7d6c7 (diff)
downloadpaludis-9bfe015ea2cbd912d8df315f2f7c06a4a401d16f.tar.gz
paludis-9bfe015ea2cbd912d8df315f2f7c06a4a401d16f.tar.xz
More faq work
-rw-r--r--doc/faq.html.skel51
-rw-r--r--doc/paludis.css2
2 files changed, 53 insertions, 0 deletions
diff --git a/doc/faq.html.skel b/doc/faq.html.skel
index 0daf3cc..66e23fda 100644
--- a/doc/faq.html.skel
+++ b/doc/faq.html.skel
@@ -122,6 +122,57 @@ resume the build.</p>
does, however, have <code>--show-install-reasons</code>, which we find to be
considerably more informative, useful and correct.</p>
+<h3 id="features">No <code>FEATURES</code> Equivalent</h3>
+
+<p>Paludis doesn't use the <code>FEATURES</code> variable. We find this to be
+a rather ugly way of handling things. We do have equivalents to most values:</p>
+
+<dl>
+ <dt>ccache</dt>
+ <dd>See <a href="#ccache">Using <code>ccache</code></a>.</dd>
+
+ <dt>collision-protect</dt>
+ <dd>There are various third party hooks that implement this. We might start
+ shipping one as a demo hook at some point.</dd>
+
+ <dt>distcc</dt>
+ <dd>See <a href="#ccache">Using <code>ccache</code></a>, and adapt it for
+ <code>distcc</code>. Additions to this FAQ entry are welcome.</dd>
+
+ <dt>keepwork, keeptemp, noclean</dt>
+ <dd>The <code>builtin_tidyup</code> phase does cleaning up. You can turn
+ this phase off using <code>export SKIP_FUNCTIONS="tidyup"</code>.</dd>
+
+ <dt>nodoc, noinfo, noman</dt>
+ <dd>You could write a hook that removes the relevant directories from
+ <code>$D</code>.</dd>
+
+ <dt>nostrip</dt>
+ <dd>Again, it's a function, so <code>export SKIP_FUNCTIONS="strip"</code>.</dd>
+
+ <dt>sandbox</dt>
+ <dd>Always on.</dd>
+
+ <dt>splitdebug</dt>
+ <dd>Use <code>--debug-build split</code>.</dd>
+
+ <dt>test</dt>
+ <dd>Always on. See <a href="#testfailures">Packages failing
+ <code>src_test</code></a>.</dd>
+</dl>
+
+<h3 id="ccache">Using <code>ccache</code></h3>
+
+<p>To enable <code>ccache</code>, simply set the relevant variables in your
+configuration <code>bashrc</code>:</p>
+
+<pre>
+export PATH="/usr/lib/ccache/bin/:${PATH}"
+export CCACHE_DIR="/var/tmp/ccache"
+export CC="/usr/lib/ccache/bin/gcc"
+export CXX="/usr/lib/ccache/bin/g++"
+</pre>
+
@FOOTER@
</body>
</html>
diff --git a/doc/paludis.css b/doc/paludis.css
index 9b3f3dc..7e1ec4d 100644
--- a/doc/paludis.css
+++ b/doc/paludis.css
@@ -18,6 +18,8 @@ h2 {
h3 {
font-size: large;
+ text-align: left;
+ border-bottom: 1px dashed #cccccc;
}
caption {