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