Re: C++ attributes ?

[Marc Espie <espie at tetto dot liafa dot jussieu dot fr>]

On Tue, Aug 31, 1999 at 11:44:05AM -0700, Mike Stump wrote:
> > Date: Tue, 31 Aug 1999 19:35:05 +0200
> > From: Marc Espie <espie@tetto.liafa.jussieu.fr>
> 
> > How about writing some proper documentation for 
> > __attribute__((init_priority)) and __attribute__((com_interface)) ?
> 
> ?  The above might be misread a rude.  This is a volunteer project.
> If you don't like the documentation, feel free to contribute.

I don't want to be rude to *Jason*, who's made some astounding contributions
to the compiler.  Please take the above comment tongue-in-cheek.

On the other hand, I don't buy the `volunteer project' part, especially as
I do contribute.   Sorry, but I can't write documentation for stuff
I don't understand.

> Also, it is not unreasonable to get a feature working first, then
> after it works, to document it.  I suspect that com_interface is even
> newer than init_priority.

More often than not, when documentation is not written  at the same time
as the code, it never is... 
We know of some parts of the compiler which took forever to document, some
which are not documented, or understood by about four people on Earth.
I'd very much would prefer newer stuff *not* to be in the same boat.

> > I can about figure out what init_priority is for, but com_interface
> > is a large mystery for me...

> You can try a book store and look for the title COM and DCOM and find
> out more about com.  I suspect that com_interface is heavily related.

If you know what com_interface is about, why don't you enlighten me ?

I can even write part of the documentation up, once I understand what
this is about...