Index: profiles/use.desc/text.xml
===================================================================
--- profiles/use.desc/text.xml (Revision 155)
+++ profiles/use.desc/text.xml (Arbeitskopie)
@@ -11,9 +11,12 @@
-The use.local.desc file contains a list of all local USE flags, together
-with the relevant packages, and a short description. This file can be added to
-without general discussion.
+The use.local.desc file contains a list of all local USE
+flags, together with the relevant packages, and a short
+description. Those entries are automatically taken from
+the metadata.xml files and can be added without further
+discussion, see .
Index: general-concepts/use-flags/text.xml
===================================================================
--- general-concepts/use-flags/text.xml (Revision 155)
+++ general-concepts/use-flags/text.xml (Arbeitskopie)
@@ -135,9 +135,23 @@
All USE flags must be described in either use.desc or use.local.desc
-in the profiles/ directory. See man portage or the comments in these
-files for an explanation of the format. Remember to keep these files sorted.
+in the profiles/ directory. The latter is automatically
+generated in the official package tree from the metadata.xml
+files of all packages. So local flags need to be described there in
+the following syntax:
+
+
+
+
The exceptions to this are USE_EXPAND flags, which must be documented in the
profiles/desc/ directory. One file per USE_EXPAND variable is required,