FAQ Search Today's Posts Mark Forums Read
» Video Reviews

» Linux Archive

Linux-archive is a website aiming to archive linux email lists and to make them easily accessible for linux users/developers.


» Sponsor

» Partners

» Sponsor

Go Back   Linux Archive > Gentoo > Gentoo Development

 
 
LinkBack Thread Tools
 
Old 11-24-2007, 06:53 PM
Jeroen Roovers
 
Default New USE flags documentation

On Sat, 24 Nov 2007 15:10:58 +0100
Thilo Bangert <bangert@gentoo.org> wrote:

> the idea is really great
>
> [...]
>
> now this needs to be [...] made mandatory for all ebuilds.

Uh, what?

Why? If the idea is that great, then why does it need to be mandatory?


Kind regards,
JeR
--
gentoo-dev@gentoo.org mailing list
 
Old 11-26-2007, 12:13 PM
"Alec Warner"
 
Default New USE flags documentation

On 11/24/07, Jose Luis Rivero <yoswink@gentoo.org> wrote:
> Hi all:
>
> I've read on the planet the recently included support to document USE
> flags in metadata. Seems like it was an idea from flameeyes and cardoe,
> discussed on the planet [1][2] and performed by -infra (bug #199788).
>
> While planet is a good medium to share ideas and get contributors, seems to
> me like we need a more official way to discuss this kind of 'global'
> ideas before make them real. Or at least drop a note on -dev-announce
> explaining the new feature and telling devs and users this is now
> officially supported.
>
> I'm not asking for an extra overhead of 'bureaucracy' (write specs,
> mailling @dev, send to the council, etc.) but a bit more of communication
> would be appreciated:

Maybe you aren't but I am. It takes all of 20 minutes to write a
short GLEP. It takes 5 minutes to write an e-mail telling everyone
that you are doing something new before you do it. Thanks for
considering everyone in your changes.

>
> Is the feature ready to be used? Is there any kind of documentation
> (aside of DTD)? It will replace use.desc?
>
> Thanks.
>
> [1] http://farragut.flameeyes.is-a-geek.org/articles/2007/11/24/proposing-more-use-flag-documentation
> [2] http://blog.cardoe.com/archives/2007/11/23/metadataxml-updates-examples/
>
> --
> Jose Luis Rivero <yoswink@gentoo.org>
> Gentoo/Doc Gentoo/Alpha
>
> --
> gentoo-dev@gentoo.org mailing list
>
>
--
gentoo-dev@gentoo.org mailing list
 
Old 11-26-2007, 12:13 PM
"Alec Warner"
 
Default New USE flags documentation

On 11/24/07, Jose Luis Rivero <yoswink@gentoo.org> wrote:
> Hi all:
>
> I've read on the planet the recently included support to document USE
> flags in metadata. Seems like it was an idea from flameeyes and cardoe,
> discussed on the planet [1][2] and performed by -infra (bug #199788).
>
> While planet is a good medium to share ideas and get contributors, seems to
> me like we need a more official way to discuss this kind of 'global'
> ideas before make them real. Or at least drop a note on -dev-announce
> explaining the new feature and telling devs and users this is now
> officially supported.
>
> I'm not asking for an extra overhead of 'bureaucracy' (write specs,
> mailling @dev, send to the council, etc.) but a bit more of communication
> would be appreciated:

Maybe you aren't but I am. It takes all of 20 minutes to write a
short GLEP. It takes 5 minutes to write an e-mail telling everyone
that you are doing something new before you do it. Thanks for
considering everyone in your changes.

>
> Is the feature ready to be used? Is there any kind of documentation
> (aside of DTD)? It will replace use.desc?
>
> Thanks.
>
> [1] http://farragut.flameeyes.is-a-geek.org/articles/2007/11/24/proposing-more-use-flag-documentation
> [2] http://blog.cardoe.com/archives/2007/11/23/metadataxml-updates-examples/
>
> --
> Jose Luis Rivero <yoswink@gentoo.org>
> Gentoo/Doc Gentoo/Alpha
>
> --
> gentoo-dev@gentoo.org mailing list
>
>
--
gentoo-dev@gentoo.org mailing list
 
Old 11-26-2007, 12:34 PM
"José Luis Rivero (yoswink)"
 
Default New USE flags documentation

Jose Luis Rivero wrote:


I'm not asking for an extra overhead of 'bureaucracy' (write specs,
mailling @dev, send to the council, etc.) but a bit more of communication
would be appreciated:


Seems like everyone who contact me/us about this thread is agree about
the needed of write a GLEP before doing this kind of global changes. So
I would like to add a couple of considerations:


1. Dear gentoo devs, in the future, please, write a GLEP for global
changes affecting all of us and post them to -dev. This way you can get
some feedback, improve the original idea and inform everybody about the
new feature (all-in-one).


2. With respect to the new metadata USE flag implementation, I think
that reverting the changes could be quite radical so my vote goes for:
leave the thingy as it (stop adding use flags to metadata for now),
write a quick GLEP and go through the process. When it's done, migrate
the current data (if needed) and enjoy.


Thanks.

--
Jose Luis Rivero <yoswink@gentoo.org>
Gentoo/Doc Gentoo/Alpha
--
gentoo-dev@gentoo.org mailing list
 
Old 11-26-2007, 02:10 PM
"Alec Warner"
 
Default New USE flags documentation

On 11/26/07, Diego 'Flameeyes' Pettenò <flameeyes@gmail.com> wrote:
> CCing council so that the other members can express their feeling about this;
> basically the only people I actually care about getting the feeling about
> this at all.
>
> On Monday 26 November 2007, you wrote:
> > Seems like everyone who contact me/us about this thread is agree about
> > the needed of write a GLEP before doing this kind of global changes.

Er, I think your statement here is wrong, as Diego pointed out

>
> Everyone who contacted who? Why would people contact YOU about this thread?
> They should, if anybody, contact me and Doug, if they think we did it the
> wrong way, or the council, if they thought the proposal was to be stopped (in
> which case I would have notice, being in the council myself). Even better
> they should have opened a bug for the council to stop it.
>
> So. let's face it, the only people who agree on the need for a GLEP is Alec
> and Ciaran. The rest of the thread (which by the way I had to dig up on Gmane
> because I didn't really give a damn) is composed by Thilo who think is a
> great idea, and by Jer who answered to Thilo saying, afaics, that he doesn't
> see the reason to make it *mandatory*. Then there is Doug.

I never said I disliked your idea. I disliked the way it was rolled
out as it sets bad precedent for future ideas, which can now use this
as an example to do random crap to the tree and not get feedback about
it until it is too late.

>
> Oh wait, everybody who contacted _me_ thinks it's a great idea, or nearly
> everybody. The difference is that people who contacted me did so in the blog,
> so you can read the comments at [1]. Yes I know they don't really count much,
> but counts more of your "everybody who contacted me/us" to me, considering I
> see only Antarus agreeing with you.
>
> On the proper matter, whether a GLEP is needed or not, well, I already said
> before I think the GLEP process is totally broken, and I don't think that
> waiting for months to get the GLEP approved would help users at all. For what
> it's worth, there is already a GLEP on metadata extension, GLEP 5.. yes FIVE.
> Status: deferred.
>
> I think a markup change is not a problem of GLEPs, I don't think a lot of
> stuff that gone into GLEP process should have, and should just have been
> realised.
>

So to address the only real problem I have with this aside from
setting poor precedent is updating the tools that parse metadata. If
this, as Doug alluded to in an earlier comment, begins to replace
use.local.desc then I'd like to see the tools fixed to support it.
But maybe this is just another one of those pesky process problems
where someone releases a new change over a holiday and I will wake up
tomorrow with a bug filed against gentoolkit that requests parsing
this new metadata

> And as for Alec's "20 minutes" comment, I would like to remind him that we
> have a lot of people getting obnoxious when you make even a spelling mistake,
> so for a non-native English speaker like I am, the 20 minutes figure is
> totally wrong. And this is also my reason not to write GLEPs ever in my life,
> I don't want to spend two weeks just to get the spelling right. That's a
> waste of my time, and as I'm not devoting my whole life to Gentoo, it ends up
> hurting users again.

Then e-mail the glep to one of the GLEP editors (hey thats me!) and
they will fix all the grammar problems and you can focus on the
content of the thing.

>
> At any rate, if you have any comment regarding the way some dev act, I'd
> suggest you, mostly for good life of both you and the dev involved, to ask
> him BEFORE crapping on him in public. The announcement thing you referred to,
> as Doug explained, was just a time problem, and as we're all volunteer, I
> don't think Doug was forced to find the time to fix the stuff.
>
> So, as I don't really want to waste even more time on this thing that I think
> it's totally a non-issue and just a time wasting thing, I would just ask the
> opinion of the other members of the council. If they think we can proceed, I
> won't stop to add documentation that users can use; if they want to discuss
> it next meeting, I'll wait for it before doing anything; if they think it has
> to be removed and discusse, I'll comment out my metadata (I won't REMOVE
> them, users needs to have proper documentation of USE flags, so as I don't
> find it good for them to remove it, I'll remove it from the semantic of
> metadata until a new syntax could be made official - note that we NEED such
> documentation; if going through GLEP process means making this another
> deferred GLEP and thus giving up on documenting the USE flags for another
> year or two, then I'll be ready to fight the decision until devrel removes me
> from my position).

I don't think a rollback is necessary. If necessary I will write up
the GLEP and get it approved as I'd like to have some record of the
change besides the cvs logs for the metadata.dtd (things like
rationale and thoughts on backwards compatabilty are nice to have
written down)

>
> [1]
> http://farragut.flameeyes.is-a-geek.org/articles/2007/11/19/lets-actually-get-some-metadata#comments
>
> --
> Diego "Flameeyes" Pettenò
> http://farragut.flameeyes.is-a-geek.org/
>
>
>
--
gentoo-dev@gentoo.org mailing list
 
Old 11-26-2007, 02:21 PM
Ciaran McCreesh
 
Default New USE flags documentation

On 11/26/07, Diego 'Flameeyes' Pettenò <flameeyes@gmail.com> wrote:
> So. let's face it, the only people who agree on the need for a GLEP
> is Alec and Ciaran. The rest of the thread (which by the way I had
> to dig up on Gmane because I didn't really give a damn) is composed
> by Thilo who think is a great idea, and by Jer who answered to
> Thilo saying, afaics, that he doesn't see the reason to make it
> *mandatory*. Then there is Doug.

Er, I don't think it's a bad idea. Heck, I suggested it several years
back. What I do think is that there are several less than ideal aspects
of the way it's proposed that could easily be fixed by someone spending
a few hours going through the GLEP process. These aren't difficult
changes, but they will substantially improve the end result.

And no, the GLEP process isn't broken. Well thought out proposals can
be approved very quickly, and the GLEP process helps iron out any
problems in the proposals.

--
Ciaran McCreesh
 
Old 11-26-2007, 04:16 PM
"Fernando J. Pereda"
 
Default New USE flags documentation

[ I'm answering diego's mail here because I didn't get a copy of it
through gentoo-dev, I guess the list missed me or my spam filter killed
it ]

On Mon, Nov 26, 2007 at 07:10:40AM -0800, Alec Warner wrote:
> On 11/26/07, Diego 'Flameeyes' Pettenò <flameeyes@gmail.com> wrote:
> > CCing council so that the other members can express their feeling about this;
> > basically the only people I actually care about getting the feeling about
> > this at all.

So you do not care about the rest of the dev community... great.

> > Oh wait, everybody who contacted _me_ thinks it's a great idea, or nearly
> > everybody. The difference is that people who contacted me did so in the blog,
> > so you can read the comments at [1]. Yes I know they don't really count much,
> > but counts more of your "everybody who contacted me/us" to me, considering I
> > see only Antarus agreeing with you.

Your proposal is no better just because people agree with you. Moreover,
it doesn't even address some of the concerns that were raised when it
was first brought up. *Brillant*.

> > On the proper matter, whether a GLEP is needed or not, well, I already said
> > before I think the GLEP process is totally broken, and I don't think that
> > waiting for months to get the GLEP approved would help users at all. For what
> > it's worth, there is already a GLEP on metadata extension, GLEP 5.. yes FIVE.
> > Status: deferred.
> >
> > I think a markup change is not a problem of GLEPs, I don't think a lot of
> > stuff that gone into GLEP process should have, and should just have been
> > realised.

This means that anobody who thinks that the 'put your favourite rule
here' rule is broken is hereby allowed to break it. Right?

> > And as for Alec's "20 minutes" comment, I would like to remind him that we
> > have a lot of people getting obnoxious when you make even a spelling mistake,
> > so for a non-native English speaker like I am, the 20 minutes figure is
> > totally wrong. And this is also my reason not to write GLEPs ever in my life,
> > I don't want to spend two weeks just to get the spelling right. That's a
> > waste of my time, and as I'm not devoting my whole life to Gentoo, it ends up
> > hurting users again.

And not caring about the whole development and user community by
bypassing its rules hurts all of us even more.

> > At any rate, if you have any comment regarding the way some dev act, I'd
> > suggest you, mostly for good life of both you and the dev involved, to ask
> > him BEFORE crapping on him in public. The announcement thing you referred to,
> > as Doug explained, was just a time problem, and as we're all volunteer, I
> > don't think Doug was forced to find the time to fix the stuff.

You are the only one that crapped yourself in public with this
completely uncalled for response.

You acted without asking the community so if people raise concerns about
how you acted, just face it. Don't play the "contact me before saying I
fucked up in public" thing.

- ferdy

--
Fernando J. Pereda Garcimartín
20BB BDC3 761A 4781 E6ED ED0B 0A48 5B0C 60BD 28D4
 
Old 12-09-2007, 12:19 PM
Thilo Bangert
 
Default New USE flags documentation

Jeroen Roovers <jer@gentoo.org> said:
> On Sat, 24 Nov 2007 15:10:58 +0100
>
> Thilo Bangert <bangert@gentoo.org> wrote:
> > the idea is really great
> >
> > [...]
> >
> > now this needs to be [...] made mandatory for all ebuilds.
>
> Uh, what?
>
> Why? If the idea is that great, then why does it need to be mandatory?

This is one more way the maintainer can document the functionality of the
ebuild. IMHO this documentation is so usefull that every ebuild should
provide it.

see the recent blogpost by nichoj
http://technicalpickles.com/posts/pidgin-idle-time
which supports this reasoning.

regards
Thilo

>
>
> Kind regards,
> JeR
 
Old 12-09-2007, 01:04 PM
"Santiago M. Mola"
 
Default New USE flags documentation

On Nov 24, 2007 4:19 PM, Doug Goldstein <cardoe@gentoo.org> wrote:
> Jose Luis Rivero wrote:
> > I'm not asking for an extra overhead of 'bureaucracy' (write specs,
> > mailling @dev, send to the council, etc.) but a bit more of communication
> > would be appreciated:
> >
> All the above is completely unnecessary and I would be happy to discuss
> details with you off list.

I'm not against the changes in metadata but I felt a bit angry when
the changes were made bypassing established processes and skipping the
feedback-rethinking cycle (as other people pointer out... ignoring the
community). So, I agree with people asking for freezing the use of the
new features until a GLEP is proposed, discussed and approved.

Regards,
Santiago

--
Santiago M. Mola
Jabber ID: cooldwind@gmail.com
--
gentoo-dev@gentoo.org mailing list
 

Thread Tools




All times are GMT. The time now is 04:33 AM.

VBulletin, Copyright ©2000 - 2014, Jelsoft Enterprises Ltd.
Content Relevant URLs by vBSEO ©2007, Crawlability, Inc.
Copyright ©2007 - 2008, www.linux-archive.org