| 1 | GLEP: 56 |
1 | GLEP: 56 |
| 2 | Title: USE flag descriptions in metadata |
2 | Title: USE flag descriptions in metadata |
| 3 | Version: $Revision: 1.2 $ |
3 | Version: $Revision: 1.3 $ |
| 4 | Last-Modified: $Date: 2008/07/10 18:15:05 $ |
4 | Last-Modified: $Date: 2008/07/10 22:13:45 $ |
| 5 | Author: Doug Goldstein <cardoe@gentoo.org> |
5 | Author: Doug Goldstein <cardoe@gentoo.org> |
| 6 | Status: Draft |
6 | Status: Accepted |
| 7 | Type: Standards Track |
7 | Type: Standards Track |
| 8 | Content-Type: text/x-rst |
8 | Content-Type: text/x-rst |
| 9 | Created: 03-Jun-2008 |
9 | Created: 03-Jun-2008 |
| 10 | Post-History: 13-Jun-2008 |
10 | Post-History: 05-June-2008, 13-Jun-2008 |
| 11 | |
11 | |
| 12 | Abstract |
12 | Abstract |
| 13 | ======== |
13 | ======== |
| 14 | |
14 | |
| 15 | This GLEP proposes to add per-package USE flag descriptions to each package's |
15 | This GLEP proposes to add per-package USE flag descriptions to each package's |
| … | |
… | |
| 53 | |
53 | |
| 54 | * e.g. "video_cards_i810" or "alsa" |
54 | * e.g. "video_cards_i810" or "alsa" |
| 55 | |
55 | |
| 56 | - Each ``<flag>`` XML tag allows 0 or more nested ``<pkg>`` XML tags whose |
56 | - Each ``<flag>`` XML tag allows 0 or more nested ``<pkg>`` XML tags whose |
| 57 | character data is a valid CP or CPV as defined by the |
57 | character data is a valid CP or CPV as defined by the |
| 58 | `Gentoo Development Guide - Ebuild File Format` [#devmanual]_. |
58 | `Gentoo Development Manual - Ebuild File Format` [#devmanual]_. |
| 59 | |
59 | |
| 60 | - Each ``<flag>`` XML tag allows 0 or more nested ``<cat>`` XML tags whose |
60 | - Each ``<flag>`` XML tag allows 0 or more nested ``<cat>`` XML tags whose |
| 61 | character data is a valid category. |
61 | character data is a valid category. |
| 62 | |
62 | |
| 63 | - The ``<use>`` XML tag may appear multiple times inside of the |
63 | - The ``<use>`` XML tag may appear multiple times inside of the |
| … | |
… | |
| 65 | attribute value. |
65 | attribute value. |
| 66 | |
66 | |
| 67 | * The ``lang`` attribute follows the documented ``lang`` attribute in the |
67 | * The ``lang`` attribute follows the documented ``lang`` attribute in the |
| 68 | `Gentoo Developer Handbook` [#devhandbook]_. |
68 | `Gentoo Developer Handbook` [#devhandbook]_. |
| 69 | |
69 | |
| 70 | Documentation for the Developer Manual and the metadata.dtd can be found in |
70 | Documentation for the `Gentoo Developer Handbook` [#devhandbook]_ and the |
| 71 | Gentoo's Bugzilla [#use-flag-metadata-bug]_ bug #199788. |
71 | metadata.dtd can be found in Gentoo's Bugzilla [#use-flag-metadata-bug]_ |
|
|
72 | bug #199788. |
| 72 | |
73 | |
| 73 | The following are two concrete examples in tree, [#use-flag-metadata-example1]_ |
74 | The following are two concrete examples in tree, [#use-flag-metadata-example1]_ |
| 74 | and [#use-flag-metadata-example2]_. |
75 | and [#use-flag-metadata-example2]_. |
| 75 | |
76 | |
| 76 | And the following is an embedded example and not from a real package:: |
77 | And the following is an embedded example and not from a real package:: |
Parent Directory
| 
Revision Log
| 
Patch