On Ter, 2011-03-29 at 17:08 +0200, Amadeusz Żołnowski wrote: > Excerpts from justin's message of Tue Mar 29 16:24:57 +0200 2011: > > the descriptions of USE flags should explain what the USE is good for. > > In my opinion some thing like > > > > Enables foo intergration > > or > > Enables support for foo > > > > if it isn't totally clear what "foo" is, sucks!! There are many, many > > description which do not tell me as a user without googling what I > > could enable or not. That doesn't make gentoo very user friendly! > > > > So please enhance you descriptions!! > > I 100% agree with you! This is something what is always pissing me off > when reading equery uses foo to find out how to set flags. > > I'm actually describing even global USE flags in my package's > metadata.xml if their purpose might not be clear and I'd like to expect > that from others. It is not a problem to write one sentence for each > flag while you already know what flag does. > > Maybe it should even become our policy and not just recommendation?
Why do we have to turn everything into policies? This case would be easily solved by making a list of use flags that we find poorly described, then improving the description of each. - Angelo
