Wine User Guide


Table of Contents
1. Introduction
Overview / About
Purpose of this document and intended audience
Burning questions and comments
Content overview / Steps to take
What is Wine?
Windows and Linux
What is Wine, and how can it help me?
Wine capabilities
Other, often "Enhanced" Wine offerings
Alternatives to Wine you might want to consider
VMWare
Win4Lin
Basic Wine Requirements
System requirements
2. Getting Wine
How to download Wine?
Which Wine form should I pick?
Getting a Wine package
Debian Linux
Linux Red Hat, Mandrake, SUSE, and Slackware
FreeBSD
Other systems
Getting Wine source code
Getting Wine Source Code from the official archives
Getting Wine Source Code from CVS
Updating the Wine CVS tree
Updating Wine with a Patch
3. Compiling the Wine Source
Compiling Wine
Requirements
Space required
Common problems
4. Installing or uninstalling Wine
Installing or uninstalling Wine packages
Debian Linux
Linux Red Hat, Mandrake, SUSE and other distributions using RPM
Installing or uninstalling a Wine source code tree
5. Configuring Wine
What are the requirements of a fully working Windows environment?
Easy configuration helper programs
WineSetupTk
wineinstall
Verification of correct configuration
The Wine Configuration File
Configuration File Introduction
Creating Or Modifying The Configuration File
What Does It Contain?
What If It Doesn't Work?
The Wine File System And Drive Layer
Extremely Important Prerequisites
Short Introduction
Windows Directory Structure
The [Drive x] Sections
File system settings in the [wine] section
More detailed explanation about file system differences
Installing Wine Without Windows
Installing Wine Using An Existing Windows Partition As Base
Dealing With FAT/VFAT Partitions
Drive labels and serial numbers
The Registry
The default registry
Using a Windows registry
The Registry
Registry structure
Wine registry data files
System administration
The [registry] section
DLL configuration
Introduction
Introduction To DLL Sections
DLL Overrides
System DLLs
Missing DLLs
Fetching native DLLs from a Windows CD
Configuring the graphics driver (x11drv, ttydrv etc.)
Configuring the x11drv graphics driver
Configuring the ttydrv graphics driver
Setting the Windows and DOS version value
How to configure the Windows and DOS version value Wine should return
Dealing with Fonts
Fonts
Setting up a TrueType Font Server
Printing in Wine
Printing
The Wine PostScript Driver
SCSI Support
Windows requirements
Linux requirements
Notes
Using ODBC
Using a Unix ODBC system with Wine
Using Windows ODBC drivers
6. Running Wine
Basic usage: applications and control panel applets
How to run Wine
Explorer-like graphical Wine environments
Wine Command Line Options
--debugmsg [channels]
--help
--version
wineserver Command Line Options
-d<n>
-h
-k[n]
-p[n]
-w
Setting Windows/DOS environment variables
Text mode programs (CUI: Console User Interface)
Configuration of CUI executables
7. Troubleshooting / Reporting bugs
What to do if some program still doesn't work?
Verify your wine configuration
Use different windows version settings
Use different startup paths
Fiddle with DLL configuration
Check your system environment !
Use different GUI (Window Manager) modes
Check your app !
Check your Wine environment !
Reconfigure Wine
Check out further information
Debug it!
How To Report A Bug
All Bug Reports
Crashes
Glossary
List of Tables
1-1. Various Wine offerings
6-1. Debug Channels
6-2. Basic differences in consoles
6-3. Wineconsole configuration options