Win32 headers: Problem with COM interface indirection levels

[jcc7]

== Quote from Michael Butscher (mbutscher at gmx.de)'s article
> jcc7 wrote:
> > == Quote from Michael Butscher (mbutscher at gmx.de)'s article
> > > Carlos Santander wrote:
> > > > Michael Butscher escribió:
> > > [...]
> > ...
> > > I found out in the meantime that some headers (namely
> > > "d3d9.d") were modified already in a similar way, but it was not
> > > documented in the translation instructions.
> >
> > It's been mentioned on the wiki page at
> > http://www.prowiki.org/wiki4d/wiki.cgi?WindowsAPI, but I think you're right that
> > it's not in the "Translation instructions" section (and it probably should be
there).
> >
> > I get the feeling that the WindowsAPI page at Wiki4D has gotten way too big to be
> > efficient. I think that it should probably be split into subpages, but I would be
> > afraid of stepping on the toes of the WindowsAPI team by doing it myself.
> Personally I prefer one large page as I'm using a dialup connection, so
> I have to load only one page and can read it offline easily.

I understand the reason for your preference, but I still think the page is way too
long. Perhaps the instructions could stay on the main page, but the list of
contributor and the discussions could be kept on separate pages. Anyway, I don't
want to interfere with the project, so I'll let someone actually involved in the
project make that change if they want to take my (unsolicited) advice.

> > (Also, I wonder if it would work better to store the content that's current at
> > Wiki4D in the bindings wiki instead [http://www.dsource.org/projects/bindings],
> > since it is part of the bindings project and dsource wikis have a cool way of
> > formatting D source code.)
> At least there should be only one place for the instructions. Currently
> there exists also a readme file in the SVN-repository with similar
> instructions.

That does sound like a problem.


> Either the file should point to the wiki page(s) or vice versa.

I agree.

Personally, I would prefer to have a wiki page as the sole place due to the
greater options for formatting.

> [...]
> > > > Also, maybe this question is better suited in the Bindings project
> > > > Dsource forum?
> > > You are right. I only found forums a bit impractical, but that's not
> > > a good argument.
> >
> > Actually by my count, it's already been mentioned twice by other people in the
> > Bindings forum.
> >
> > http://www.dsource.org/forums/viewtopic.php?t=2458
> > http://www.dsource.org/forums/viewtopic.php?t=2253#14074
> I thought that somebody would have written it in the instructions if
> the problem was realized already therefore I didn't search for it in
> the forum.
> Michael

I don't know how the people API project are talking to each other. I assumed it
was via the wiki page, but for all I know they could be using IRC, AIM, or an
e-mail mailing list. I was just trying to make the point that apparently it
doesn't matter if anyone posts in the bindings forum because the people who might
want to know that information don't seem to even be reading that forum.

I'm not a leader in the API project (or even a member). I expect that the
leadership probably doesn't want just anyone editing their instructions section. I
suspect that why the people that posted on forum didn't edit the instructions
themselves. Or maybe they weren't aware of the Wiki4D page? (I'm not sure how the
API project is organized.)

I did at least make a comment on that page, but it's become such an unwieldy page
that I don't think anyone has read it from beginning to end recently.