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:

+ + + Compress bundled Emacs Lisp source + Enable support for net-dns/hesiod + Add support for Emacs input methods + Build Emacs with MTA support + Enable sound + Use the selected toolkit's scrollbars in + preference to Emacs' own scrollbars + + +

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,