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.3.37
  64 reactos/dll/win32/gdiplus         # Synced to Wine-1.3.37
  65 reactos/dll/win32/hhctrl.ocx      # Autosync
  66 reactos/dll/win32/hlink           # Synced to Wine-1.3.37
  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.3.37
  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        # Autosync
  89 reactos/dll/win32/mciseq          # Synced to Wine-1.3.37
  90 reactos/dll/win32/mciwave         # Synced to Wine-1.3.37
  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.3.37
  98 reactos/dll/win32/mscoree         # Synced to Wine-1.3.37
  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.3.37
 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.3.37
 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           # Autosync
 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.3.37
 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.3.37
 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          # Autosync
 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         # Autosync
 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             # Autosync
 164 reactos/dll/win32/sxs             # Synced to Wine-1.3.37
 165 reactos/dll/win32/tapi32          # Autosync
 166 reactos/dll/win32/traffic         # Autosync
 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             # Autosync
 170 reactos/dll/win32/urlmon          # Autosync
 171 reactos/dll/win32/usp10           # Synced to Wine-1.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