quick-docs/en-US/wine.adoc

= Wine

'''

[IMPORTANT]
======

This page was automatically converted from https://fedoraproject.org/wiki/Wine

It is probably

* Badly formatted
* Missing graphics and tables that do not convert well from mediawiki
* Out-of-date
* In need of other love

Please fix it, remove this notice, and then add to `_topic_map.yml`

Pull requests accepted at https://pagure.io/fedora-docs/quick-docs

Once that is live, go to the original wiki page and add an `{{old}}`
tag, followed by a note like

....
{{admon/note|This page has a new home!|
This wiki page is no longer maintained. Please find the up-to-date
version at: https://docs.fedoraproject.org/whatever-the-url
}}
....

======

'''


http://winehq.org/[Wine] is an open source implementation of the Windows
API on top of X and OpenGL.

[[packages]]
Packages
~~~~~~~~

Fedora's Wine packages are split up to allow for smaller installations.
The `wine` meta package will bring with it the most important components
of Wine. Expert users may want to pick specific components from the list
below:

[cols=",",]
|=======================================================================
|*name* |''' summary '''

|_wine_ |Meta package

|_wine-alsa_ |ALSA sound support for wine

|_wine-arial-fonts_ |Arial fonts provided by wine-staging

|_wine-capi_ |ISDN support for wine

|_wine-cms_ |Color Management for wine

|_wine-common_ |Common wine files and scripts

|_wine-core_ |Wine core package

|_wine-courier-fonts_ |Wine Courier font family

|_wine-desktop_ |Desktop integration features

|_wine-devel_ |Wine development environment

|_wine-filesystem_ |Filesystem directories and basic configuration for
wine

|_wine-fixedsys-fonts_ |Wine Fixedsys font family

|_wine-fonts_ |Wine font meta package

|_wine-ldap_ |LDAP support for wine

|_wine-marlett-fonts_ |Wine Marlett font family

|_wine-ms-sans-serif-fonts_ |Wine MS Sans Serif font family

|_wine-openal_ |OpenAL sound support for wine

|_wine-opencl_ |OpenCL support for wine

|_wine-pulseaudio_ |PulseAudio support for wine

|_wine-small-fonts_ |Wine Small font family

|_wine-symbol-fonts_ |Wine Symbol font family

|_wine-systemd_ |Systemd configuration for the wine binfmt handler

|_wine-system-fonts_ |Wine System font family

|_wine-sysvinit_ |SysV initscript for the wine binfmt handler

|_wine-tahoma-fonts_ |Wine Tahoma font family

|_wine-tahoma-fonts-system_ |Wine Tahoma font family system integration

|_wine-twain_ |Twain (image scanning) support for wine

|_wine-wingdings-fonts_ |Wine Wingdings font family

|_wine-wingdings-fonts-system_ |Wine Wingdings font family system
integration
|=======================================================================

Additional documentation is provided via the ''wine-docs '' package.

[[available-versions]]
Available versions
~~~~~~~~~~~~~~~~~~

Fedora applies fixes and features from the *wine-staging* project. EPEL
packages do not use wine-staging patches.

*Current versions of Wine in Fedora:*

[cols=",",]
|=================
|Fedora 25 |1.9.21
|Fedora 24 |1.9.20
|EPEL 7 |1.8.5
|EPEL 6 |1.8.5
|EPEL 5 |1.0.1
|=================

Newer versions may be available in the corresponding `updates-testing`
repositories.

[[testing-versions]]
Testing Versions
~~~~~~~~~~~~~~~~

[cols=",",]
|=================
|Fedora 25 |1.9.22
|Fedora 24 |1.9.22
|EPEL 7 |-
|EPEL 6 |-
|EPEL 5 |-
|=================

[[bugs-and-problems]]
Bugs and problems
~~~~~~~~~~~~~~~~~

Before reporting bugs against Wine please make sure your system is fully
up to date.

....
dnf update
....

Also check if a newer version is available in updates-testing.

....
dnf --enablerepo=updates-testing update wine
....

If you are using the proprietary graphics drivers please remove them
from your system and try again, as they are known to cause problems.

When debugging Wine, your goal is to determine if the issue is one of
_code functionality_ or _packaging in Fedora_.

Check the http://appdb.winehq.org[Wine Application Database] to see if
your application is supported, or if there are known issues that match
yours. Anything that falls into this category is a bug in upstream code
functionality.

The next step is to see if the problem persists with a clean ~/.wine
folder. To try this without losing your old configuration:

....
mv ~/.wine ~/.wine-save
....

Afterwards try to trigger the bug again. Your original wine folder can
be restored with:

....
rm -fr ~/.wine; mv ~/.wine-save ~/.wine
....

If your application still does not work but has been working in a
previous version of wine it is probably a regression. Consider filling a
bug in the upstream https://bugs.wine-staging.com/[Wine-staging bug
tracking system]. *Do not* file bugs in the Winehq.org bugzilla unless
told to do so.

If you really think that your bug is Fedora-related, file a bug against
the Wine component in https://bugzilla.redhat.com[Fedora's bug tracking
system].

[[updates-testing]]
Updates-Testing
~~~~~~~~~~~~~~~

If you use the version of wine in the updates-testing repository then
please log into https://admin.fedoraproject.org/updates[bodhi] and
comment on the build, including any problems that may be in the
packaging, naming, or elsewhere. The build needs positive karma to be
pushed to the updates repository.
'''

See a typo, something missing or out of date, or anything else which can be
improved? Edit this document at https://pagure.io/fedora-docs/quick-docs.