Attachment 224987 Details for Bug 309963 – Updated patch

[patch] Updated patch

devmanual_use_local_desc.patch (text/plain), 2.49 KB, created by Christian Faulhammer (RETIRED) on 2010-03-23 23:05:49 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Christian Faulhammer (RETIRED)

Created: 2010-03-23 23:05:49 UTC

Size: 2.49 KB

patch

obsolete

>Index: profiles/use.desc/text.xml
>===================================================================
>--- profiles/use.desc/text.xml	(Revision 155)
>+++ profiles/use.desc/text.xml	(Arbeitskopie)
>@@ -11,9 +11,12 @@
> 
> 
> 
>-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.
>+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. Those entries are automatically taken from
>+the <c>metadata.xml</c> files and can be added without further
>+discussion, see <uri link="::general-concepts/use-flags#USE Flag
>+Descriptions"/>.
> 
> 
> 
>Index: general-concepts/use-flags/text.xml
>===================================================================
>--- general-concepts/use-flags/text.xml	(Revision 155)
>+++ general-concepts/use-flags/text.xml	(Arbeitskopie)
>@@ -134,11 +134,31 @@
> <title>USE Flag Descriptions</title>
> <body>
> 
>-All USE flags must be described in either <c>use.desc</c> or <c>use.local.desc</c>
>-in the <c>profiles/</c> directory. See <c>man portage</c> or the comments in these
>-files for an explanation of the format. Remember to keep these files sorted.
>+All USE flags must be described in <c>use.desc</c> or <c>use.local.desc</c>
>+in the <c>profiles/</c> directory. The latter is automatically
>+generated in the official package tree from the <c>metadata.xml</c>
>+files of all packages. So local flags need to be described there in
>+the following syntax:
> 
>+<codesample>
>+<use>
>+ <flag name='gzip-el'>Compress bundled Emacs Lisp source</flag>
>+ <flag name='hesiod'>Enable support for <pkg>net-dns/hesiod</pkg></flag>
>+ <flag name='leim'>Add support for Emacs input methods</flag>
>+ <flag name='sendmail'>Build Emacs with MTA support</flag>
>+ <flag name='sound'>Enable sound</flag>
>+ <flag name='toolkit-scroll-bars'>Use the selected toolkit's scrollbars in
>+ preference to Emacs' own scrollbars</flag>
>+</use>
>+</codesample>
>+
> 
>+If a global flag needs more information in the description than the
>+generic one from <c>use.desc</c> it is possible to handle it like a
>+local flag in <c>metadata.xml</c>.
>+
>+
>+
> The exceptions to this are <c>USE_EXPAND</c> flags, which must be documented in the 
> <c>profiles/desc/</c> directory. One file per <c>USE_EXPAND</c> variable is required,
> which must contain descriptions of the possible values this variable can take. See the

Actions: View | Diff

Attachments on bug 309963: 224023 | 224987