aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat (limited to 'general-concepts/features/text.xml')
-rw-r--r--general-concepts/features/text.xml68
1 files changed, 68 insertions, 0 deletions
diff --git a/general-concepts/features/text.xml b/general-concepts/features/text.xml
new file mode 100644
index 0000000..8227ea6
--- /dev/null
+++ b/general-concepts/features/text.xml
@@ -0,0 +1,68 @@
+<?xml version="1.0"?>
+<guide self="general-concepts/features/">
+<chapter>
+<title>FEATURES</title>
+
+<body>
+<p>
+The <c>FEATURES</c> variable specifies options which affect how portage operates
+and how packages are compiled. It is **not** used for settings which have a
+substantial effect upon the resulting generated package.
+</p>
+
+<p>
+Relevant <c>FEATURES</c> for developers include:
+</p>
+
+<table>
+ <tr>
+ <th>Feature</th>
+ <th>Explanation</th>
+ </tr>
+ <tr>
+ <ti><c>autoaddcvs</c></ti>
+ <ti>Automatically runs a <c>cvs add</c> for certain files.</ti>
+ </tr>
+ <tr>
+ <ti><c>collision-protect</c></ti>
+ <ti>
+ Raise an error if an installing package attempts to overwrite a file which
+ is provided by a different package.
+ </ti>
+ </tr>
+ <tr>
+ <ti><c>cvs</c></ti>
+ <ti>Generate proper digests even when <c>SRC_URI</c> has conditional elements.</ti>
+ </tr>
+ <tr>
+ <ti><c>sandbox</c></ti>
+ <ti>Enable the sandbox.</ti>
+ </tr>
+ <tr>
+ <ti><c>sign</c></ti>
+ <ti>GPG sign manifest files.</ti>
+ </tr>
+ <tr>
+ <ti><c>strict</c></ti>
+ <ti>
+ Do some extra checks for potentially dangerous situations (eg missing
+ <c>Manifest</c> files).
+ </ti>
+ </tr>
+ <tr>
+ <ti><c>test</c></ti>
+ <ti>Enable the <c>src_test</c> phase.</ti>
+ </tr>
+ <tr>
+ <ti><c>userpriv</c></ti>
+ <ti>Drop to non-root privileges for certain phases.</ti>
+ </tr>
+ <tr>
+ <ti><c>usersandbox</c></ti>
+ <ti>Enables the sandbox even when running non-privileged.</ti>
+ </tr>
+</table>
+
+</body>
+</chapter>
+</guide>