On 9 déc. 04, at 06:46, Colin Putney wrote:

> Hi Stéphane,
>
> I won't reply to each point in your last message, because the amount 
> of quoted text is getting to be too unwieldy. So here's a much shorter 
> version:
:)
>
> About class comments. I agree that class comments are important, but I 
> don't think what I posted earlier in this thread should go into them. 
> I like to keep the class comment focused on the class its self - its 
> responsibilities and the other objects it collaborates with. 
> Big-picture explanations and tutorials can go elsewhere. I have some 
> ideas for an active essay I'd like to write soon, and the OmniBrowser 
> wiki also has documentation.

Sure but think about the poor guys in the train (like me) or over a 
really slow modem lost in the french country side (like me too). 
Because having a readme file on a key class can really help. I prefer 
having more comments than less.

> Although it hasn't been updated recently, it's still accurate; the 
> core of OB hasn't changed in quite a while. (See 
> http://www.wiresong.ca/OmniBrowser/Docs/)
>
> About categorizing methods: I don't think there are very many 
> uncategorized methods in OB. I'm really annoyed by that, so I tend to 
> categorize them as I go. Also, I've made Ned's ENH available in 
> OmniBrowser. I think the menu item is something like "categorize 
> automatically."

Cool. So this is in the image then because I was planning to chase it 
for seaside. :)

> About the hierarchy browser: I wonder if you were thinking of 
> OBInheritanceBrowser. It displays the inheritance of methods, not 
> classes.

Ok.

Stef