The WineAPI wiki.

Max TenEyck Woodbury max at mtew.isa-geek.net
Mon Aug 2 10:48:46 CDT 2010


On 08/02/2010 11:25 AM, Dmitry Timoshkov wrote:
> Max TenEyck Woodbury<max at mtew.isa-geek.net>  wrote:
>
>>>> Further, there is a little confusing and incorrect information in the
>>>> Microsoft documentation. Bluntly, the Microsoft documentation is what
>>>> they want it to be. We need to document what it really is.
>>>
>>> Regardless of the quality of Microsoft documentation it's still Win32 API,
>>> not a Wine API.
>>>
>> And it is Microsoft's documentation and nominally documents their code.
>> We have to document *our* code. There will be differences. Differences
>> that I expect will be removed when found unless we can show that the
>> Microsoft documentation is, in fact, incorrect.
>
> An API is Application Programming Interface, not the code or implementation
> details. The API is for application programmers, not for system's analists.
> If the Wine implementaion of win32 differs from Microsoft one - that's a bug,
> it's not worth documenting, it's worth a bug report and fixing.
>
Your implication that I do not know wat 'API' stands for comes very
close to being an insult. Please stop.

The readable title is 'Wine API *and related documentation*'.
Documentation is used for many purposes. Application programmers use
it, but system's analysts also use it. Telling me that it can not be
used any way but your way is arrogant.

Implementation and documentation are two different things. Bugs can,
and in some cases should, be documented. I am not asking you to do
anything in particular. That would be arrogance on my part.

- Max



More information about the wine-devel mailing list