Rewrote Unix process launching to allow passing startup information to
[wine/multimedia.git] / documentation / no-windows
blobba62a5725d4472fc8fb96943852123d36d2e80ee
1                         Wine without Windows
2                         ====================
4 A major goal of Wine is to allow users to run Windows programs without
5 having to install Windows on their machine. Wine implements the
6 functionality of the main DLL's usually provided with Windows.
7 Therefore, once Wine is finished, you will not need to have windows
8 installed to use Wine.
10 Wine has already made enough progress that it may be possible to run
11 your target applications without Windows installed. If you want to try
12 it, follow these steps:
14 1. Create empty C:\windows, C:\windows\system, C:\windows\Start Menu,
15    and C:\windows\Start Menu\Programs directories.
16    Do not point Wine to a Windows directory full of old installations
17    and a messy registry. (Wine creates a special registry in your home
18    directory, in $HOME/.wine/*.reg. Perhaps you have to remove these
19    files).
21 2. Point [Drive C] in wine.conf or .winerc to where you want C: to be.
22    Refer to the Wine man page for more information. Remember to use
23    filesystem=win95 !
25 3. Use tools/wineinstall to compile Wine and install the default
26    registry. Or if you prefer to do it yourself, compile programs/regapi,
27    and run:   programs/regapi/regapi setValue < winedefault.reg
29 4. Run and/or install your applications.
32 Because Wine is not yet complete, some programs will work better
33 with native Windows DLL's than with Wine's replacements. Wine has been
34 designed to make this possible. Here are some tips by Juergen Schmied
35 (and others) on how to proceed. This assumes that your C:\windows
36 directory in the configuration file does not point to a native Windows
37 installation but is in a separate Unix file system. (For instance,
38 C:\windows is really /home/ego/wine/drives/c).
40 - Run the application with   -debugmsg +module,+file   to find out
41   which files are needed. Copy the required DLL's one by one to the
42   C:\windows\system directory. Do not copy KERNEL/KERNEL32, GDI/GDI32,
43   or USER/USER32. These implement the core functionality of the
44   Windows API, and the Wine internal versions must be used.
46 - Edit the [DllOverrides] section of wine.conf or .winerc to specify
47   'native' before 'builtin' for the Windows DLL's you want to use.
48   For more information about this, see the Wine manpage.
50 - Note that some network DLL's are not needed even though Wine is
51   looking for them. The Windows MPR.DLL currently does not work; you
52   must use the internal implementation.
54 - Copy SHELL/SHELL32 and COMDLG/COMDLG32 COMMCTRL/COMCTL32
55   only as pairs to your Wine directory (these DLL's are
56   "clean" to use).  Make sure you have these specified in the
57   [DllPairs] section of wine.conf or .winerc.
59 - Be consistent: Use only DLL's from the same Windows version
60   together.
62 - Put regedit.exe in the C:\windows directory (office95 imports
63   a *.reg file when it runs with a empty registry, don't know
64   about office97).
66 - Also add winhelp.exe and winhlp32.exe if you want to be able to browse
67   through your programs' help function.