Call For Volunteers: API test suite for Wine

To all Windows developers !

Subject: Internet-wide call (about 10000 people required)
	 for a small amount of help on Windows related development

About us
========

The Wine project (www.winehq.com), an Open Source (free) Windows compatibility
layer for UNIX (Linux, *BSD, ...), has had an astonishing amount of success
already at getting various Windows programs (e.g. Office, HalfLife,
Internet Explorer) to run on various Unix versions during its 8 years of
development.
Wine is a very ambitious and huge Open Source project, with contributions
of about 300 people:
together with Odin, which reuses large chunks of Wine's code, it's the *only*
viable true poject which seeks to rewrite a free implementation of Windows
from scratch.
The landscape is littered with dozens of bodies of proudly announced very
similar projects (Windows rewrites) that all found their way into failure
after a pretty short time.

Where dozens have failed, Wine will "win" (pun intended).


Where do YOU come into the picture ?
==================================

After 8 years of development, our project is pretty refined already.
However by simply testing whether specific programs run, we don't really have a
systematic approach of verifying the compatibility of the Windows functions
we implemented.
Thus there are often regressions (bugs introduced by changes to the code base)
that go unnoticed for several months sometimes, thus severely degrading
Wine's Windows program compatibility.

Having a systematic test suite specially designed to test *every single*
Windows function out there as tightly as possible would help a LOT in
reducing bugs before the next "official" development release of Wine,
simply by doing a run of the whole test suite before release, thus finding
almost every problematic code change.

Problem is: if you sum up the number of exported functions of public Windows
system DLLs, you easily get to a number which almost reaches 12000.
12000 Windows functions !!

The Wine project would have considerable problems if it was to implement
a whole test suite for this puzzling amount of Windows API functions
alongside the "real" implementation of these functions, which is already
overwhelming on its own.

This is where we desperately need your help: by implementing a test
for a specific Windows function that you're pretty familiar with (a matter
of about 1 or 2 hours for an experienced programmer) according to the
description given below, you'd help us tremenduously !
We'd also be glad to have companies donate some limited development time
to help us reach this goal.


So why should you be as naive as to help us ?
=============================================

Hmm, right. After all the operating system market is very healthy and
competitive, so why should I donate time for free for this "pet project" ?

Wrong.

The operating system market is everything but that (do you still manage to
remember OS/2, BeOS, ... ?).

That's why we think that it's EXTREMELY important to make sure that Linux
and other OSes gain close to 100% Windows compatibility in order to make
sure that a barrier to adoption of such OSes gets torn down almost completely.
After all just about every PC anywhere runs Windows programs, so you almost
*have* to be compatible with that.
This very worthwhile goal can only be achieved by rigorous compatibility
testing of Wine's implementation of Windows functions, thereby enabling
Wine to run almost all Windows programs.

Don't you think that the IT market has been under the lock of monopolistic
actions far too long, and that there might finally actually be some *real*
change for good if YOU get involved ?


Great, I'll help, now how to implement a test for a Windows function ?
======================================================================

The files listing the names of the Windows functions waiting to be tested
can be found at http://www.winehq.com/source/dlls/

The list at the end of this paragraph indicates the actual files to be found
there.
E.g. let's take kernel/kernel.spec as an example.
This would lead to the URL http://www.winehq.com/source/dlls/kernel/kernel.spec
In this file, you find the following entry:
type    win16
This means that this is a Win16 DLL, in contrast to win32, which would
indicate a Win32 DLL, and thus Win32 functions.
This entry:
45  pascal16 LoadModule(str ptr) LoadModule16
describes a function entry in Wine's builtin KERNEL.DLL file.
All you need to care about is the "LoadModule" entry, which is the
Windows function name. The "LoadModule16" entry simply indicates the
name of the corresponding Wine function, so it doesn't matter at all.
In case of Win32 functions, you could look up their documentation
at search.microsoft.com. In case of Win16 functions, check your (older ?)
own documentation.

Now that I described how to create a test for a particular function
(LoadModule), just choose one of the files below, choose a function belonging
to it and start coding a test for Wine's test suite ! :-)
Or in short: take ANY Windows function that you know pretty well and
write a test for it.

The following .spec files are available at WineHQ. Choose the one you like
best and choose your favourite function from it:

gdi/wing.spec
gdi/dispdib.spec
gdi/gdi.spec
gdi/gdi32.spec
mpr/mpr.spec
sti/sti.spec
url/url.spec
wsock32/wsock32.spec
icmp/icmp.spec
qcap/qcap.spec
user/ddeml.spec
user/user32.spec
user/keyboard.spec
user/user.spec
user/mouse.spec
user/display.spec
shfolder/shfolder.spec
commdlg/comdlg32.spec
commdlg/commdlg.spec
devenum/devenum.spec
oleaut32/ole2disp.spec
oleaut32/oleaut32.spec
oleaut32/typelib.spec
olepro32/olepro32.spec
ddraw/ddraw.spec
dplay/dplay.spec
glu32/glu32.spec
imm32/imm.spec
imm32/imm32.spec
msacm/msacm.spec
msacm/msacm32.spec
msdmo/msdmo.spec
ntdll/ntdll.spec
ole32/ole32.spec
ole32/ole2prox.spec
ole32/ole2.spec
ole32/storage.spec
ole32/compobj.spec
ole32/ole2conv.spec
ole32/ole2thk.spec
ole32/ole2nls.spec
psapi/psapi.spec
winmm/winmm.spec
winmm/mmsystem.spec
winmm/mcianim/mcianim.drv.spec
winmm/mciwave/mciwave.drv.spec
winmm/midimap/midimap.drv.spec
winmm/mciavi/mciavi.drv.spec
winmm/mcicda/mcicda.drv.spec
winmm/mciseq/mciseq.drv.spec
winmm/wavemap/msacm.drv.spec
winmm/sound.spec
winmm/joystick/joystick.drv.spec
winmm/wineoss/wineoss.drv.spec
wow32/wow32.spec
avicap32/avicap32.spec
avifil32/avifile.spec
avifil32/avifil32.spec
dciman32/dciman32.spec
shdocvw/shdocvw.spec
shell32/shell32.spec
shell32/shell.spec
shlwapi/shlwapi.spec
lzexpand/lzexpand.spec
lzexpand/lz32.spec
comctl32/comctl32.spec
crtdll/crtdll.spec
dinput/dinput.spec
dplayx/dplayx.spec
dsound/dsound.spec
richedit/riched32.spec
msimg32/msimg32.spec
msnet32/msnet32.spec
kernel/comm.spec
kernel/kernel32.spec
kernel/win87em.spec
kernel/kernel.spec
kernel/toolhelp.spec
kernel/windebug.spec
kernel/system.spec
kernel/stress.spec
msrle32/msrle32.spec
msvideo/msvfw32.spec
msvideo/msvideo.spec
rasapi32/rasapi16.spec
rasapi32/rasapi32.spec
mapi32/mapi32.spec
imagehlp/imagehlp.spec
msvcrt/msvcrt.spec
odbc32/odbc32.spec
olecli/olecli32.spec
olecli/olecli.spec
oledlg/oledlg.spec
olesvr/olesvr32.spec
olesvr/olesvr.spec
quartz/quartz.spec
x11drv/x11drv.spec
rpcrt4/rpcrt4.spec
winspool/winspool.drv.spec
wintrust/wintrust.spec
netapi32/netapi32.spec
tapi32/tapi32.spec
opengl32/opengl32.spec
version/version.spec
version/ver.spec
ttydrv/ttydrv.spec
urlmon/urlmon.spec
win32s/w32skrnl.spec
win32s/win32s16.spec
win32s/w32sys.spec
wineps/wineps.spec
wineps/wineps16.spec
winnls/winnls.spec
winnls/winnls32.spec
serialui/serialui.spec
setupapi/setupx.spec
setupapi/setupapi.spec
advapi32/advapi32.spec
winaspi/wnaspi32.spec
winaspi/winaspi.spec
wininet/wininet.spec
winsock/ws2_32.spec
winsock/winsock.spec

Now let me show you how to implement a program to test a certain function:

[add part here explaining my program]

Of course this gigantic effort has to be coordinated...

Indicate the Windows version that you ran/programmed your test on...

Test code should never "crash" on Windows...
Maybe make use of exception handlers to cause "crashes" that don't do harm...