aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMark Loeser <halcy0n@gentoo.org>2006-03-09 03:41:25 +0000
committerMark Loeser <halcy0n@gentoo.org>2006-03-09 03:41:25 +0000
commitbbfb28e736823048a90981ef1fa350ed9ddb463a (patch)
treec2ab8f116041ed201426123d09c38ddfd62e63c2 /profiles/use.desc/text.xml
parentAdd the eclass writing guide (diff)
downloaddevmanual-bbfb28e736823048a90981ef1fa350ed9ddb463a.tar.gz
devmanual-bbfb28e736823048a90981ef1fa350ed9ddb463a.tar.bz2
devmanual-bbfb28e736823048a90981ef1fa350ed9ddb463a.zip
Add profiles/
git-svn-id: svn+ssh://svn.gentoo.org/var/svnroot/devmanual/trunk@16 176d3534-300d-0410-8db8-84e73ed771c3
Diffstat (limited to 'profiles/use.desc/text.xml')
-rw-r--r--profiles/use.desc/text.xml32
1 files changed, 32 insertions, 0 deletions
diff --git a/profiles/use.desc/text.xml b/profiles/use.desc/text.xml
new file mode 100644
index 0000000..5ac2524
--- /dev/null
+++ b/profiles/use.desc/text.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0"?>
+<guide self="profiles/use.desc/">
+<chapter>
+<title>Profiles <c>use.desc</c> and <c>use.local.desc</c> Files</title>
+<body>
+
+<p>
+The <c>use.desc</c> file contains a list of all global non-expanded <c>USE</c> flags,
+together with a short description. This file should not be modified without
+discussion on the <c>gentoo-dev</c> list.
+</p>
+
+<p>
+The <c>use.local.desc</c> file contains a list of all local <c>USE</c> flags, together
+with the relevant packages, and a short description. This file can be added to
+without general discussion.
+</p>
+
+<p>
+Having a small number of packages using identically named local <c>USE</c> flags is
+allowed. If the number starts to grow substantially, it may be worth proposing
+that the flag becomes a global <d /> see
+<uri link="::general-concepts/use-flags#Local and Global USE Flags"/>.
+</p>
+
+<p>
+All non-expand flags must be listed in exactly one of these files.
+</p>
+
+</body>
+</chapter>
+</guide>