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