| 1 |
Excerpts from justin's message of Tue Mar 29 16:24:57 +0200 2011: |
| 2 |
> the descriptions of USE flags should explain what the USE is good for. |
| 3 |
> In my opinion some thing like |
| 4 |
> |
| 5 |
> Enables foo intergration |
| 6 |
> or |
| 7 |
> Enables support for foo |
| 8 |
> |
| 9 |
> if it isn't totally clear what "foo" is, sucks!! There are many, many |
| 10 |
> description which do not tell me as a user without googling what I |
| 11 |
> could enable or not. That doesn't make gentoo very user friendly! |
| 12 |
> |
| 13 |
> So please enhance you descriptions!! |
| 14 |
|
| 15 |
I 100% agree with you! This is something what is always pissing me off |
| 16 |
when reading equery uses foo to find out how to set flags. |
| 17 |
|
| 18 |
I'm actually describing even global USE flags in my package's |
| 19 |
metadata.xml if their purpose might not be clear and I'd like to expect |
| 20 |
that from others. It is not a problem to write one sentence for each |
| 21 |
flag while you already know what flag does. |
| 22 |
|
| 23 |
Maybe it should even become our policy and not just recommendation? |
| 24 |
-- |
| 25 |
Amadeusz Żołnowski |
| 26 |
|
| 27 |
PGP key fpr: C700 CEDE 0C18 212E 49DA 4653 F013 4531 E1DB FAB5 |
Archives