[MSCOREE]
[reactos.git] / reactos / media / doc / README.WINE
1 # ReactOS WINE porting guide for 0.3
2 # Update this file when you port a dll/program from WINE.
3
4 The ReactOS Project shares quite a bit of code with the WINE project.
5 This document should provide a compleate reference for all of the
6 locations in the ReactOS source tree where code is shared between the
7 two projects. If you find something is missing from this documentation
8 please add it.
9
10 If you find that a function in ReactOS that is not implemented properly
11 and is based on WINE sources, check the latest Winehq CVS and see if
12 it has been fixed there. If so, please submit a patch to
13 ros-dev@reactos.org. Otherwise please send a patch to both
14 wine-patches@winehq.com and ros-dev@reactos.org
15
16 When porting a new DLL from Wine to ReactOS, please do the following steps
17 - Create a new directory in dll/win32/ of the same name as the new Wine DLL
18 - Add a new entry in dll/win32/win32.rbuild
19 - Follow the guide "Update process for autosync DLLs" at the bottom of this file
20
21
22 The following build tools are shared with Wine.
23
24 reactos/tools/unicode # Synced to Wine-1.3.37
25 reactos/tools/widl # Synced to Wine-1.3.26
26 reactos/tools/winebuild # Synced to Wine-1_1_13
27 reactos/tools/wmc # Synced to Wine-20081105 (~Wine-1.1.7)
28 reactos/tools/wpp # Synced to Wine-1.3.26
29 reactos/tools/wrc # Synced to Wine-1.3.26
30
31 The following libraries are shared with Wine.
32
33 reactos/dll/directx/amstream # Synced to Wine-1.3.37
34 reactos/dll/directx/dinput # Synced to Wine-20090208
35 reactos/dll/directx/dinput8 # Synced to Wine-20090208
36 reactos/dll/directx/dmusic # Synced to Wine-1_1_23
37 reactos/dll/directx/dplay # Synced to Wine-0_9_5
38 reactos/dll/directx/dplayx # Synced to Wine-0_9_5
39 reactos/dll/directx/dxdiagn # Synced to Wine-0_9_5
40 reactos/dll/directx/msdmo # Autosync
41 reactos/dll/directx/qedit # Autosync
42 reactos/dll/directx/quartz # Autosync
43 reactos/dll/win32/advpack # Synced to Wine-1.3.37
44 reactos/dll/win32/atl # Synced to Wine-1.3.37
45 reactos/dll/win32/avifil32 # Synced to Wine-1.3.37
46 reactos/dll/win32/bcrypt # Synced to Wine-1.3.37
47 reactos/dll/win32/browseui # Out of sync
48 reactos/dll/win32/cabinet # Synced to Wine-1.3.37
49 reactos/dll/win32/clusapi # Synced to Wine-1.3.37
50 reactos/dll/win32/comcat # Synced to Wine-1.3.37
51 reactos/dll/win32/comctl32 # Synced to Wine 1.3.37
52 reactos/dll/win32/comdlg32 # Synced to Wine 1.3.37
53 reactos/dll/win32/compstui # Synced to Wine-1.3.37
54 reactos/dll/win32/credui # Synced to Wine-1.3.37
55 reactos/dll/win32/crypt32 # Synced to Wine-1.3.37
56 reactos/dll/win32/cryptdlg # Synced to Wine-1.3.37
57 reactos/dll/win32/cryptdll # Synced to Wine-1.3.37
58 reactos/dll/win32/cryptnet # Synced to Wine-1.3.37
59 reactos/dll/win32/cryptui # Synced to Wine-1.3.37
60 reactos/dll/win32/dbghelp # Synced to Wine-1.3.37
61 reactos/dll/win32/dciman32 # Synced to Wine-1.3.37
62 reactos/dll/win32/dwmapi # Synced to Wine-1.3.37
63 reactos/dll/win32/fusion # Synced to Wine-1.5.4
64 reactos/dll/win32/gdiplus # Synced to Wine-1.5.4
65 reactos/dll/win32/hhctrl.ocx # Autosync
66 reactos/dll/win32/hlink # Synced to Wine-1.5.4
67 reactos/dll/win32/hnetcfg # Synced to Wine-1.3.37
68 reactos/dll/win32/httpapi # Synced to Wine-1.3.37
69 reactos/dll/win32/iccvid # Autosync
70 reactos/dll/win32/icmp # Synced to Wine-0_9_10
71 reactos/dll/win32/imaadp32.acm # Synced to Wine-1.3.37
72 reactos/dll/win32/imagehlp # Synced to Wine-1.3.37
73 reactos/dll/win32/imm32 # Synced to Wine-1.3.37
74 reactos/dll/win32/inetcomm # Synced to Wine-1.3.37
75 reactos/dll/win32/inetmib1 # Synced to Wine-1.3.37
76 reactos/dll/win32/initpki # Synced to Wine-1.3.37
77 reactos/dll/win32/inseng # Synced to Wine-1.3.37
78 reactos/dll/win32/iphlpapi # Out of sync
79 reactos/dll/win32/itircl # Synced to Wine-1.3.37
80 reactos/dll/win32/itss # Synced to Wine-1.5.4
81 reactos/dll/win32/jscript # Autosync
82 reactos/dll/win32/localspl # Autosync
83 reactos/dll/win32/localui # Autosync
84 reactos/dll/win32/lz32 # Synced to Wine-1.3.37
85 reactos/dll/win32/mapi32 # Autosync
86 reactos/dll/win32/mciavi32 # Synced to Wine-1.3.37
87 reactos/dll/win32/mcicda # Synced to Wine-1.3.37
88 reactos/dll/win32/mciqtz32 # Synced to Wine-1.5.4
89 reactos/dll/win32/mciseq # Synced to Wine-1.3.37
90 reactos/dll/win32/mciwave # Synced to Wine-1.5.4
91 reactos/dll/win32/mlang # Synced to Wine-1.3.37
92 reactos/dll/win32/mpr # Autosync
93 reactos/dll/win32/mprapi # Synced to Wine-1.3.37
94 reactos/dll/win32/msacm32 # Autosync
95 reactos/dll/win32/msadp32.acm # Synced to Wine-1.3.37
96 reactos/dll/win32/mscat32 # Synced to Wine-1.3.37
97 reactos/dll/win32/mscms # Synced to Wine-1.5.4
98 reactos/dll/win32/mscoree # Synced to Wine-1.5.4
99 reactos/dll/win32/msctf # Synced to Wine-1.3.37
100 reactos/dll/win32/msftedit # Synced to Wine-1.3.37
101 reactos/dll/win32/msg711.acm # Synced to Wine-1.3.37
102 reactos/dll/win32/msgsm32.acm # Synced to Wine-1.3.37
103 reactos/dll/win32/mshtml # Autosync
104 reactos/dll/win32/mshtml.tlb # Autosync
105 reactos/dll/win32/msi # Synced to Wine-1.5.4
106 reactos/dll/win32/msimg32 # Synced to Wine-1.3.37
107 reactos/dll/win32/msimtf # Synced to Wine-1.3.37
108 reactos/dll/win32/msisip # Synced to Wine-1.3.37
109 reactos/dll/win32/msisys.ocx # Synced to Wine-1.3.37
110 reactos/dll/win32/msnet32 # Synced to Wine-1.3.37
111 reactos/dll/win32/msrle32 # Autosync
112 reactos/dll/win32/mssign32 # Synced to Wine-1.5.4
113 reactos/dll/win32/mssip32 # Synced to Wine-1.3.37
114 reactos/dll/win32/mstask # Synced to Wine-1.3.37
115 reactos/dll/win32/msvcrt20 # Autosync
116 reactos/dll/win32/msvfw32 # Autosync
117 reactos/dll/win32/msvidc32 # Autosync
118 reactos/dll/win32/msxml3 # Autosync
119 reactos/dll/win32/nddeapi # Synced to Wine-1.3.37
120 reactos/dll/win32/netapi32 # Autosync
121 reactos/dll/win32/ntdsapi # Synced to Wine-1.3.37
122 reactos/dll/win32/ntprint # Synced to Wine-1.3.37
123 reactos/dll/win32/objsel # Synced to Wine-1.3.37
124 reactos/dll/win32/odbc32 # Out of sync. Depends on port of Linux ODBC.
125 reactos/dll/win32/odbccp32 # Synced to Wine-1.3.37
126 reactos/dll/win32/ole32 # Synced to Wine-1.5.4
127 reactos/dll/win32/oleacc # Autosync
128 reactos/dll/win32/oleaut32 # Autosync
129 reactos/dll/win32/olecli32 # Synced to Wine-1.3.37
130 reactos/dll/win32/oledlg # Autosync
131 reactos/dll/win32/olepro32 # Autosync
132 reactos/dll/win32/olesvr32 # Synced to Wine-1.3.37
133 reactos/dll/win32/olethk32 # Synced to Wine-1.3.37
134 reactos/dll/win32/pdh # Autosync
135 reactos/dll/win32/pidgen # Synced to Wine-1.3.37
136 reactos/dll/win32/powrprof # Forked at Wine-1.0rc5
137 reactos/dll/win32/printui # Synced to Wine-1.3.37
138 reactos/dll/win32/pstorec # Synced to Wine-1.5.4
139 reactos/dll/win32/query # Synced to Wine-1.3.37
140 reactos/dll/win32/rasapi32 # Synced to Wine-1.3.37
141 reactos/dll/win32/resutils # Synced to Wine-1.3.37
142 reactos/dll/win32/riched20 # Synced to Wine-1.5.4
143 reactos/dll/win32/riched32 # Synced to Wine-1.3.37
144 reactos/dll/win32/rpcrt4 # Synced to Wine-1.3.26
145 reactos/dll/win32/rsabase # Autosync
146 reactos/dll/win32/rsaenh # Synced to Wine-1.5.4
147 reactos/dll/win32/sccbase # Synced to Wine-1.3.37
148 reactos/dll/win32/schannel # Synced to Wine-1.3.37
149 reactos/dll/win32/secur32 # Forked
150 reactos/dll/win32/security # Forked (different .spec)
151 reactos/dll/win32/sensapi # Synced to Wine-1.3.37
152 reactos/dll/win32/setupapi # Forked at Wine-20050524
153 reactos/dll/win32/shell32 # Forked at Wine-20071011
154 reactos/dll/win32/shdocvw # Autosync
155 reactos/dll/win32/shfolder # Autosync
156 reactos/dll/win32/shlwapi # Autosync
157 reactos/dll/win32/slbcsp # Synced to Wine-1.3.37
158 reactos/dll/win32/snmpapi # Synced to Wine-1.3.37
159 reactos/dll/win32/softpub # Synced to Wine-1.3.37
160 reactos/dll/win32/spoolss # Synced to Wine-1.5.4
161 reactos/dll/win32/stdole2.tlb # Synced to Wine-1.3.37
162 reactos/dll/win32/stdole32.tlb # Synced to Wine-1.3.37
163 reactos/dll/win32/sti # Synced to Wine-1.5.4
164 reactos/dll/win32/sxs # Synced to Wine-1.5.4
165 reactos/dll/win32/tapi32 # Autosync
166 reactos/dll/win32/traffic # Synced to Wine-1.5.4
167 reactos/dll/win32/twain_32 # Out of sync
168 reactos/dll/win32/updspapi # Synced to Wine-1.3.37
169 reactos/dll/win32/url # Synced to Wine-1.5.4
170 reactos/dll/win32/urlmon # Autosync
171 reactos/dll/win32/usp10 # Synced to Wine-1.5.4
172 reactos/dll/win32/uxtheme # Forked
173 reactos/dll/win32/version # Autosync
174 reactos/dll/win32/wer # Autosync
175 reactos/dll/win32/windowscodecs # Autosync
176 reactos/dll/win32/winemp3.acm # Synced to Wine-1.3.37
177 reactos/dll/win32/winhttp # Autosync
178 reactos/dll/win32/wininet # Autosync
179 reactos/dll/win32/winmm # Forked at Wine-20050628
180 reactos/dll/win32/winmm/midimap # Forked at Wine-20050628
181 reactos/dll/win32/winmm/wavemap # Forked at Wine-20050628
182 reactos/dll/win32/wintrust # Autosync
183 reactos/dll/win32/wldap32 # Autosync
184 reactos/dll/win32/wmi # Synced to Wine-1.3.37
185 reactos/dll/win32/wtsapi32 # Synced to Wine-1.3.37
186 reactos/dll/win32/wuapi # Autosync
187 reactos/dll/win32/xinput1_1 # Synced to Wine-1.3.37
188 reactos/dll/win32/xinput1_2 # Synced to Wine-1.3.37
189 reactos/dll/win32/xinput1_3 # Autosync
190 reactos/dll/win32/xinput9_1_0 # Synced to Wine-1.3.37
191 reactos/dll/win32/xmllite # Synced to Wine-1.3.37
192
193 reactos/dll/cpl/inetcpl # Synced to Wine-1.3.21
194
195 ReactOS shares the following programs with Winehq.
196
197 reactos/base/applications/cmdutils/xcopy # Synced to Wine-1.3.37
198 reactos/base/applications/games/winmine # Forked at Wine-1_3_5
199 reactos/base/applications/extrac32 # Autosync
200 reactos/base/applications/iexplore # Autosync
201 reactos/base/applications/notepad # Forked at Wine-20041201
202 reactos/base/applications/reg # Autosync
203 reactos/base/applications/regedit # Out of sync
204 reactos/base/applications/winhlp32 # Autosync
205 reactos/base/applications/wordpad # Autosync
206 reactos/base/services/rpcss # Synced to Wine-20081105
207 reactos/base/system/expand # Autosync
208 reactos/base/system/msiexec # Autosync
209 reactos/modules/rosapps/winfile # Autosync
210
211 In addition the following libs, dlls and source files are mostly based on code ported
212 from Winehq CVS. If you are looking to update something in these files
213 check Wine current souces first as it may already be fixed.
214
215 reactos/lib/sdk/uuid # Synced to Wine-1.1.42
216
217 advapi32 -
218 reactos/dll/win32/advapi32/crypt/*.c # Unknown
219 reactos/dll/win32/advapi32/sec/cred.c # Out of Sync
220 reactos/dll/win32/advapi32/sec/sid.c # Out of Sync
221
222 gdi32 -
223 reactos/dll/win32/gdi32/objects/linedda.c # Synced at 20090410
224
225 kernel32 -
226 reactos/dll/win32/kernel32/misc/errormsg.c # Out of sync
227 reactos/dll/win32/kernel32/misc/profile.c # Out of sync
228 reactos/dll/win32/kernel32/misc/lcformat.c # Synced to Wine-1_3
229 reactos/dll/win32/kernel32/misc/lzexpand.c # Synced to Wine-1_1_23
230
231 msvcrt -
232 reactos/lib/sdk/crt/except/cpp.c # Synced at 20080528
233 reactos/lib/sdk/crt/except/cppexcept.c # Synced at 20071111
234 reactos/lib/sdk/crt/string/scanf.c/h # Synced to Wine-1_1_27
235 reactos/lib/sdk/crt/strings/wcs.c # Synced at 20080611
236 reactos/lib/sdk/crt/wine/heap.c # Synced at 20080529
237 reactos/lib/sdk/crt/wine/undname.c # Synced at 20081130
238 reactos/lib/sdk/crt/thread/thread.c # Synced at 20080604
239
240 snmpapi -
241 reactos/dll/win32/snmpapi/main.c # Synced at 20090222
242
243 User32 -
244 reactos/dll/win32/user32/controls/button.c # Synced to Wine-1_1_39
245 reactos/dll/win32/user32/controls/combo.c # Synced to Wine-1_1_39
246 reactos/dll/win32/user32/controls/edit.c # Synced to Wine-1_1_40
247 reactos/dll/win32/user32/controls/icontitle.c # Synced to Wine-1_1_39
248 reactos/dll/win32/user32/controls/listbox.c # Synced to Wine-1_1_39
249 reactos/dll/win32/user32/controls/scrollbar.c # Forked
250 reactos/dll/win32/user32/controls/static.c # Synced to Wine-1_1_39
251
252 reactos/dll/win32/user32/include/dde_private.h # Synced to wine 1.1.24
253
254 reactos/dll/win32/user32/misc/dde.c # Synced to wine 1.1.24 (dde_misc.c)
255 reactos/dll/win32/user32/misc/ddeclient.c # Synced to Wine-1_1_23
256 reactos/dll/win32/user32/misc/ddeserver.c # Synced to Wine-1_1_23
257 reactos/dll/win32/user32/misc/exticon.c # Synced to Wine-1_1_22
258 reactos/dll/win32/user32/misc/resources.c # Forked?
259 reactos/dll/win32/user32/misc/winhelp.c # Last sync date unknown
260 reactos/dll/win32/user32/misc/wsprintf.c # Synced to Wine-1_1_23
261
262 reactos/dll/win32/user32/windows/cursoricon # Forked from wine 1.2-rc7
263 reactos/dll/win32/user32/windows/defwnd.c # Forked
264 reactos/dll/win32/user32/windows/draw.c # Forked at Wine-20020904 (uitools.c)
265 reactos/dll/win32/user32/windows/mdi.c # Synced to Wine-1_1_40
266 reactos/dll/win32/user32/windows/menu.c # Forked
267 reactos/dll/win32/user32/windows/messagebox.c # Forked
268 reactos/dll/win32/user32/windows/rect.c # Forked (uitools.c)
269 reactos/dll/win32/user32/windows/spy.c # Synced to Wine-1_1_40
270 reactos/dll/win32/user32/windows/text.c # Forked (lstr.c)
271 reactos/dll/win32/user32/windows/winpos.c # Forked
272
273 Update process for autosync DLLs
274
275 *** This process can only be done on Microsoft Windows ***
276 - Download wineimport.cmd at svn://svn.reactos.org/project-tools/trunk/
277 - Download cvs command line program and be sure to put it in your path
278 (available at http://ftp.gnu.org/non-gnu/cvs/binary/stable/x86-woe/ )
279 - Download svn command line program and be sure to put it in your path
280 (available at http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91 )
281 - Download patch command line program and be sure to put it in your path
282 (available at http://gnuwin32.sourceforge.net/packages/patch.htm )
283 - Optionally, download junction.exe and put it in your path
284 (available at http://www.sysinternals.com/Utilities/Junction.html )
285 - Cd to the directory containing wineimport.cmd
286 - Run
287 "wineimport.cmd fullprocessing {path_to_your_reactos_directory} {name_of_the_wine_dll}"
288 - In case of error, you can
289 1) add missing definitions to ReactOS headers
290 2) fix {name_of_the_wine_dll}_ros.diff patch file, by removing outdated changes
291 3) or modify Wine code, by adding a {name_of_the_wine_dll}_ros.diff patch,
292 which will be applied after Wine source checkout
293 DO NOT DIRECTLY MODIFY WINE SOURCE CODE
294 - Once Wine DLL compiles, install and run ReactOS and search for regressions
295 - In case of regression, you can
296 1) Fix ReactOS code (not in the shared DLL)
297 2) or update the {name_of_the_wine_dll}_ros.diff patch file
298 - Commit your changes with the "Autosyncing with Wine HEAD" commit message