| 1. INTRODUCTION |
| |
| Wine is a program that allows running MS-Windows programs under X11. |
| It consists of a program loader, that loads and executes an |
| MS-Windows binary, and of an emulation library that translates Windows |
| API calls to their Unix/X11 equivalent. |
| |
| Wine is free software. See the file LICENSE for the details. |
| Basically, you can do anything with it, except claim that you wrote it. |
| |
| |
| 2. COMPILATION |
| |
| You must have one of: |
| |
| Linux version 0.99.13 or above |
| NetBSD-current |
| FreeBSD-current or FreeBSD 1.1 |
| |
| You also need to have libXpm installed on your system. The sources for |
| it are probably available on the ftp site where you got Wine. They can |
| also be found on ftp.x.org and all its mirror sites. |
| |
| To build Wine, first do a "./Configure" and then a "make" (or "gmake" |
| if you're running *BSD). The executable "wine" will be built. "wine" |
| will load and run 16-bit Windows executables. |
| |
| To upgrade to a new release by using a patch file, first cd to the |
| top-level directory of the release (the one containing this README |
| file). Then do a "make clean", and patch the release with: |
| |
| gunzip -c patch-file | patch -p1 |
| |
| where "patch-file" is the name of the patch file (something like |
| Wine-yymmdd.diff.gz). You can then re-run "./Configure", and then |
| run "make". |
| |
| |
| 3. SETUP |
| |
| Wine requires you to have a file /usr/local/etc/wine.conf (you can |
| supply a different name when configuring wine) or a file called .winerc |
| in your home directory. |
| |
| The format of this config file is just like a Windows .ini file. |
| The file wine.ini contains a config file example. |
| |
| Here's an explanation of each section: |
| |
| * [drives] |
| |
| format: <driveletter> = <rootdirectory> |
| default: none |
| |
| This section is used to specify the root directory of each `dos'drive |
| as Windows' applications require a dos/mswindows based diskdrive & |
| directory scheme. |
| |
| If you mounted your dos-partition as /dos and installed Microsoft Windows |
| in c:\windows than you should specify c=/dos in the drives section. |
| |
| * [wine] |
| |
| format: windows = <directory> |
| default: c:\windows |
| |
| Used to specify an different windows directory. |
| |
| format: system = <directory> |
| default: c:\windows\system |
| |
| Used to specify an different system directory. |
| |
| format: temp = <directory> |
| default: c:\temp |
| |
| Used to specify a directory where Windows applications can store temporary |
| files. |
| |
| format: path = <directories separated by semi-colons> |
| default: c:\windows;c:\windows\system |
| |
| Used to specify the path which will be used to find executables and DLL's. |
| |
| format: symboltablefile = <filename> |
| default: wine.sym |
| |
| Used to specify the path and file name of the symbol table used by the |
| built-in debugger. |
| |
| * [serialports] |
| |
| format: com[12345678] = <devicename> |
| default: none |
| |
| Used to specify the devices which are used as com1 - com8. |
| |
| * [parallelports] |
| |
| format: lpt[12345678] = <devicename> |
| default: none |
| |
| Used to specify the devices which are used as lpt1 - lpt8. |
| |
| * [spy] |
| |
| format: file = <filename or CON when logging to stdout> |
| default: none |
| |
| used to specify the file which will be used as logfile. |
| |
| format: exclude = <message names separated by semicolons> |
| default: none |
| |
| Used to specify which messages will be excluded from the logfile. |
| |
| format: include = <message names separated by semicolons> |
| default: none |
| |
| Used to specify which messages will be included in the logfile. |
| |
| |
| 4. RUNNING PROGRAMS |
| |
| When invoking Wine, you must specify the entire path to the executable, |
| or a filename only. |
| |
| For example: to run Windows' solitaire: |
| |
| wine sol (using the searchpath to locate the file) |
| wine sol.exe |
| |
| wine c:\\windows\\sol.exe (using a dosfilename) |
| |
| wine /usr/windows/sol.exe (using a unixfilename) |
| |
| Note: the path of the file will also be added to the path when |
| a full name is supplied on the commandline. |
| |
| Have a nice game of solitaire, but be careful. Emulation isn't perfect. |
| So, occasionally it may crash. |
| |
| |
| 5. GETTING MORE INFORMATION |
| |
| The best place to get help or to report bugs is the Usenet newsgroup |
| comp.emulators.ms-windows.wine. The Wine FAQ is posted there every |
| month. |
| |
| If you add something, or fix a bug, please send a patch to |
| wine-new@amscons.com for inclusion in the next release. |
| |
| -- |
| Alexandre Julliard |
| julliard@lamisun.epfl.ch |