Wine

Wine (Wine Is Not an Emulator) is an application that allows Windows software to run on Linux. This article deals with installing, configuring and maintaining a general purpose Wine environment on Gentoo.

Installation
Enable the USE flags of choice and emerge :

To install the latest, development version, the package needs to be unmasked unless already running unstable:

Media
Many users are likely to want support for as much media as possible, in which cases the following flags are recommended.

Disabling the Menubuilder
To prevent Wine from adding menu entries and desktop links, the following dll override can be used.

Already added entries can be deleted by removing the corresponding files from.

Tools and Interfaces
Tools such as graphical interfaces for Wine for users who want an alternative to the command-line.
 * - Qt4 GUI configuration tool for Wine
 * - Wine-doors is a package manager for Wine
 * - Easy way to install DLLs needed to work around problems in Wine
 * - Set of scripts to easily install and use Windows games and software

Environment Variables
The environment variables of the shell that wine is started from are made accessible to the windows/dos processes. Some very useful Wine-specific variables include, but are not limited to, WINEPREFIX, WINEARCH, and WINEDEBUG.

See also the manual entries (man wine and man wineserver).

WINEPREFIX
To create a Wine prefix in a custom location without affecting the default:

The above would create the Windows installation in the home path of the user, under wine_testi.

WINEARCH
To create a 32-bit installation instead of the default (when built) 64-bit:

The Wine executable used could be anything that runs Wine, such as winecfg, which often makes sense while creating a clean, new prefix.

WINEDEBUG
Essential in finding out why an application is misbehaving when the basic terminal output or messages boxes are not enough. See Debugging for examples.

Debugging
When a user encounters a problem with an application, they should try the latest development version to see if the unwanted behavior still exists. If Wine has been built with options such as -fomit-frame-pointer or --hash-style=both, the Wine developers will likely be unable to help with the issue, and reports including output from such builds should not be reported to the Wine Bugzilla.

The custom-cflags USE flag should be enabled for debugging builds.

For more directions on reporting bugs, see Bugzilla and Bugs at wiki.winehq.