The WineAPI wiki.
Max TenEyck Woodbury
max at mtew.isa-geek.net
Wed Aug 4 14:39:32 CDT 2010
On 08/04/2010 03:15 PM, Francois Gouget wrote:
> On Mon, 2 Aug 2010, Max TenEyck Woodbury wrote:
> [...]
>> This has been discussed elsewhere on this mailing list.
>>
>> There is a lot of information specific to Wine, particularly its
>> internal structure, that is not shared with Microsoft's product.
>> 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.
>
> I think such documentation should be open to all projects involved in
> the Win32 space such as Mingw, React OS, as well as Windows software
> developpers whenever they are irritated by an MSDN deficiency.
>
> Sure there will be differences between how each project implements a
> given API, just like there are differences between the Windows 98, 2000
> or Vista implementations. But I expect most of the documentation to be
> common to all so that the best approach would be to describe the
> reference behavior and then have notes describing the platform-specific
> differences.
>
> However calling the Wiki 'WineAPI' is not very welcoming to other
> contributors and it would be a shame if each project ended up
> duplicating this huge effort just because of a naming issue.
>
That is a very good point!
There several things that have to be coordinated however:
- This is not just the API documentation. It includes a great deal of
information about the meta-structure of the Wine project. Easy access
to that meta-information might be one of the more useful aspects of
this sub-project.
- The detailed information is, at least initially, coming out of the
Wine code. It is being generated using scripts. The scripts are very
likely to be rerun when a file in the Wine repository changes. It may
take a lot of effort to merge the new information with information
from other sources.
- If the licenses are compatible, it should be possible to copy
articles between projects. Also, the page tree structure is based on
the structure of the Wine repository. Since the Wine repository
structure is fairly stable, (new parts are added fairly often, but
once a piece is in place for a while, it usually stays where it is.
I could definitely be wrong about this!) links into the WineAPI wiki
should also be stable.
- Max
More information about the wine-devel
mailing list