- add documentation section to README
- updated HOWTO-winelib
- added native DLL config info to configuring.sgml
- greatly improve directory description of wine.conf man page
- add --debugmsg +all warning to wine man page
diff --git a/documentation/HOWTO-winelib b/documentation/HOWTO-winelib
index 7287e10..6241099 100644
--- a/documentation/HOWTO-winelib
+++ b/documentation/HOWTO-winelib
@@ -141,7 +141,7 @@
MFC. The first hurdle is how to legally get MFC source code on your
computer. MFC source code comes as a part of Visual Studio. The
license for Visual Studio implies it is a single product that can not
-be broken up into its components. The cleanest way to get MFC on you
+be broken up into its components. The cleanest way to get MFC on your
system is to use a dual boot Linux box with the windows partition
visible to the Linux OS. Boot into windows and install Visual
Studio. Since Visual Studio is installed on the computer, you have not
@@ -221,7 +221,7 @@
During the execution of your program, Wine prints error messages to
standard error. These error messages include "stubs", which are
windows API functions that have not been completely
-implemented. Depending on the the system call, these could be harmless
+implemented. Depending on the system call, these could be harmless
or crash your program. Most of the common windows API functions have
already been implemented, so you should have no missing API functions
or only a few missing functions. If you intend to continue with the
@@ -403,9 +403,7 @@
import winmm
If you need to list multiple DLLs, then the import specification can
-appear multiple times.
-
-FIXME: can multiple libraries appear on one import line?
+appear multiple times, one line per imported DLL.
VI. Compiling A Win32 Program With Resources
@@ -494,7 +492,7 @@
file <wine>/tools/winebuild/README for more details on the spec file
format.
-During the the compile process, a command like
+During the compile process, a command like
winebuild -fPIC -o winedll.spec.c -spec winedll.spec
will be executed to create the file winedll.spec.c from information in
the file winedll.spec. The file winedll.spec.c and winedll.c are
@@ -551,7 +549,7 @@
pointers. There is no need for any function ordinals unless your
program calls functions by the ordinal.
-During the the compile process, a command like
+During the compile process, a command like
winebuild -fPIC -o winedll.spec.c -spec winedll.spec
will be executed to create the file winedll.spec.c from information in
the file winedll.spec. The file winedll.spec.c and winedll.c are
@@ -559,7 +557,7 @@
Now that the shared library is compiled, you still need to compile
your program. Part of the compile process for your program will
-consist of a spec file for you program. For example,
+consist of a spec file for your program. For example,
name program
mode guiexe
type win32
@@ -571,7 +569,7 @@
winedll.dll. If this import line is not included, the "hidden" DLL
will not be loaded and the function pointers will not be initialized.
-During the the compile process, a command like
+During the compile process, a command like
winebuild -fPIC -o program.spec.c -spec program.spec
will be executed to create the file program.spec.c from information in
the file program.spec. The file program.spec.c and your source code are
@@ -596,7 +594,7 @@
shared library (what you renamed DllMain to). There is no need for any
function ordinals unless your program calls functions by the ordinal.
-During the the compile process, a command like
+During the compile process, a command like
winebuild -fPIC -o winedll.spec.c -spec winedll.spec
will be executed to create the file winedll.spec.c from information in
the file winedll.spec. The file winedll.spec.c and the source code for
@@ -611,7 +609,7 @@
init WinMain
import winedll.dll
-During the the compile process, a command like
+During the compile process, a command like
winebuild -fPIC -o program.spec.c -spec program.spec
will be executed to create the file program.spec.c from information in
the file program.spec. The file program.spec.c and your source code are
@@ -638,7 +636,7 @@
for quite some time, because:
1. It is difficult for us to support and it is impossible
- to do so prefectly without special compiler support,
+ to do so perfectly without special compiler support,
because of memory layout issues. For example Win16 int
is 16-bit and data is aligned 16-bit.
2. It is in almost all cases easier to port a
diff --git a/documentation/configuring.sgml b/documentation/configuring.sgml
index d933d07..0950a9e 100644
--- a/documentation/configuring.sgml
+++ b/documentation/configuring.sgml
@@ -1434,390 +1434,423 @@
</sect2>
</sect1>
- <sect1 id="dll-overrides">
- <title>Dll Overrides</title>
-
- <para>
- Written by &name-ove-kaaven; <email>&email-ove-kaaven;</email>
- </para>
- <para>
- (Extracted from <filename>wine/documentation/dll-overrides</filename>)
- </para>
-
- <para>
- The <filename>wine.conf</filename> directives [DllDefaults]
- and [DllOverrides] are the subject of some confusion. The
- overall purpose of most of these directives are clear enough,
- though - given a choice, should Wine use its own built-in
- DLLs, or should it use <filename>.DLL</filename> files found
- in an existing Windows installation? This document explains
- how this feature works.
- </para>
-
- <sect2>
- <title>DLL types</title>
- <variablelist>
- <varlistentry>
- <term>native</term>
- <listitem> <para>
- A "native" DLL is a <filename>.DLL</filename> file
- written for the real Microsoft Windows.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>builtin</term>
- <listitem> <para>
- A "builtin" DLL is a Wine DLL. These can either be a
- part of <filename>libwine.so</filename>, or more
- recently, in a special <filename>.so</filename> file
- that Wine is able to load on demand.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>elfdll</term>
- <listitem> <para>
- An "elfdll" is a Wine <filename>.so</filename> file
- with a special Windows-like file structure that is as
- close to Windows as possible, and that can also
- seamlessly link dynamically with "native" DLLs, by
- using special ELF loader and linker tricks. Bertho
- Stultiens did some work on this, but this feature has
- not yet been merged back into Wine (because of
- political reasons and lack of time), so this DLL type
- does not exist in the official Wine at this time. In
- the meantime, the "builtin" DLL type gained some of
- the features of elfdlls (such as dynamic loading), so
- it's possible that "elfdll" functionality will be
- folded into "builtin" at some point.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>so</term>
- <listitem> <para>
- A native Unix <filename>.so</filename> file, with
- calling convention conversion thunks generated on the
- fly as the library is loaded. This is mostly useful
- for libraries such as "glide" that have exactly the
- same API on both Windows and Unix.
- </para> </listitem>
- </varlistentry>
- </variablelist>
- </sect2>
-
- <sect2>
- <title>The [DllDefaults] section</title>
- <variablelist>
- <varlistentry>
- <term>DefaultLoadOrder</term>
- <listitem> <para>
- This specifies in what order Wine should search for
- available DLL types, if the DLL in question was not
- found in the [DllOverrides] section.
- </para> </listitem>
- </varlistentry>
- </variablelist>
- </sect2>
-
- <sect2>
- <title>The [DllPairs] section</title>
+ <sect1 id="dll-config">
+ <title>DLL configuration</title>
+ <sect2 id="dll-overrides">
+ <title>DLL Overrides</title>
+
<para>
- At one time, there was a section called [DllPairs] in the
- default configuration file, but this has been obsoleted
- because the pairing information has now been embedded into
- Wine itself. (The purpose of this section was merely to be
- able to issue warnings if the user attempted to pair
- codependent 16-bit/32-bit DLLs of different types.) If you
- still have this in your <filename>wine.conf</filename> or
- <filename>~/.wine/config</filename>, you may safely delete it.
- </para>
- </sect2>
-
- <sect2>
- <title>The [DllOverrides] section</title>
- <para>
- This section specifies how you want specific DLLs to be
- handled, in particular whether you want to use "native" DLLs
- or not, if you have some from a real Windows configuration.
- Because builtins do not mix seamlessly with native DLLs yet,
- certain DLL dependencies may be problematic, but workarounds
- exist in Wine for many popular DLL configurations. Also see
- WWN's [16]Status Page to figure out how well your favorite
- DLL is implemented in Wine.
+ Written by &name-ove-kaaven; <email>&email-ove-kaaven;</email>
</para>
<para>
- It is of course also possible to override these settings by
- explictly using Wine's <parameter>--dll</parameter>
- command-line option (see the man page for details). Some
- hints for choosing your optimal configuration (listed by
- 16/32-bit DLL pair):
+ (Extracted from <filename>wine/documentation/dll-overrides</filename>)
</para>
- <variablelist>
- <varlistentry>
- <term>krnl386, kernel32</term>
- <listitem> <para>
- Native versions of these will never work, so don't try. Leave
- at <literal>builtin</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>gdi, gdi32</term>
- <listitem> <para>
- Graphics Device Interface. No effort has been made at trying to
- run native GDI. Leave at <literal>builtin</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>user, user32</term>
- <listitem> <para>
- Window management and standard controls. It was
- possible to use Win95's <literal>native</literal>
- versions at some point (if all other DLLs that depend
- on it, such as comctl32 and comdlg32, were also run
- <literal>native</literal>). However, this is no longer
- possible after the Address Space Separation, so leave
- at <literal>builtin</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>ntdll</term>
- <listitem> <para>
- NT kernel API. Although badly documented, the
- <literal>native</literal> version of this will never
- work. Leave at <literal>builtin</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>w32skrnl</term>
- <listitem> <para>
- Win32s (for Win3.x). The <literal>native</literal>
- version will probably never work. Leave at
- <literal>builtin</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>wow32</term>
- <listitem> <para>
- Win16 support library for NT. The
- <literal>native</literal> version will probably never
- work. Leave at <literal>builtin</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>system</term>
- <listitem> <para>
- Win16 kernel stuff. Will never work
- <literal>native</literal>. Leave at
- <literal>builtin</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>display</term>
- <listitem> <para>
- Display driver. Definitely leave at <literal>builtin</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>toolhelp</term>
- <listitem> <para>
- Tool helper routines. This is rarely a source of problems.
- Leave at <literal>builtin</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>ver, version</term>
- <listitem> <para>
- Versioning. Seldom useful to mess with.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>advapi32</term>
- <listitem> <para>
- Registry and security features. Trying the
- <literal>native</literal> version of this may or may
- not work.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>commdlg, comdlg32</term>
- <listitem> <para>
- Common Dialogs, such as color picker, font dialog,
- print dialog, open/save dialog, etc. It is safe to try
- <literal>native</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>commctrl, comctl32</term>
- <listitem> <para>
- Common Controls. This is toolbars, status bars, list controls,
- the works. It is safe to try <literal>native</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>shell, shell32</term>
- <listitem> <para>
- Shell interface (desktop, filesystem, etc). Being one of the
- most undocumented pieces of Windows, you may have luck with the
- <literal>native</literal> version, should you need it.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>winsock, wsock32</term>
- <listitem> <para>
- Windows Sockets. The <literal>native</literal> version
- will not work under Wine, so leave at
- <literal>builtin</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>icmp</term>
- <listitem> <para>
- ICMP routines for wsock32. As with wsock32, leave at
- <literal>builtin</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>mpr</term>
- <listitem> <para>
- The <literal>native</literal> version may not work due
- to thunking issues. Leave at
- <literal>builtin</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>lzexpand, lz32</term>
- <listitem> <para>
- Lempel-Ziv decompression. Wine's
- <literal>builtin</literal> version ought to work fine.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>winaspi, wnaspi32</term>
- <listitem> <para>
- Advanced SCSI Peripheral Interface. The
- <literal>native</literal> version will probably never
- work. Leave at <literal>builtin</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>crtdll</term>
- <listitem> <para>
- C Runtime library. The <literal>native</literal>
- version will easily work better than Wine's on this
- one.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>winspool.drv</term>
- <listitem> <para>
- Printer spooler. You are not likely to have more luck
- with the <literal>native</literal> version.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>ddraw</term>
- <listitem> <para>
- DirectDraw/Direct3D. Since Wine does not implement the
- DirectX HAL, the <literal>native</literal> version
- will not work at this time.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>dinput</term>
- <listitem> <para>
- DirectInput. Running this <literal>native</literal>
- may or may not work.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>dsound</term>
- <listitem> <para>
- DirectSound. It may be possible to run this
- <literal>native</literal>, but don't count on it.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>dplay/dplayx</term>
- <listitem> <para>
- DirectPlay. The <literal>native</literal> version
- ought to work best on this, if at all.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>mmsystem, winmm</term>
- <listitem> <para>
- Multimedia system. The <literal>native</literal>
- version is not likely to work. Leave at
- <literal>builtin</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>msacm, msacm32</term>
- <listitem> <para>
- Audio Compression Manager. The
- <literal>builtin</literal> version works best, if you
- set msacm.drv to the same.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>msvideo, msvfw32</term>
- <listitem> <para>
- Video for Windows. It is safe (and recommended) to try
- <literal>native</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>mcicda.drv</term>
- <listitem> <para>
- CD Audio MCI driver.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>mciseq.drv</term>
- <listitem> <para>
- MIDI Sequencer MCI driver (<filename>.MID</filename>
- playback).
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>mciwave.drv</term>
- <listitem> <para>
- Wave audio MCI driver (<filename>.WAV</filename> playback).
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>mciavi.drv</term>
- <listitem> <para>
- AVI MCI driver (<filename>.AVI</filename> video
- playback). Best to use <literal>native</literal>.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>mcianim.drv</term>
- <listitem> <para>
- Animation MCI driver.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>msacm.drv</term>
- <listitem> <para>
- Audio Compression Manager. Set to same as msacm32.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>midimap.drv</term>
- <listitem> <para>
- MIDI Mapper.
- </para> </listitem>
- </varlistentry>
- <varlistentry>
- <term>wprocs</term>
- <listitem> <para>
- This is a pseudo-DLL used by Wine for thunking
- purposes. A <literal>native</literal> version of this
- doesn't exist.
- </para> </listitem>
- </varlistentry>
- </variablelist>
+
+ <para>
+ The <filename>wine.conf</filename> directives [DllDefaults]
+ and [DllOverrides] are the subject of some confusion. The
+ overall purpose of most of these directives are clear enough,
+ though - given a choice, should Wine use its own built-in
+ DLLs, or should it use <filename>.DLL</filename> files found
+ in an existing Windows installation? This document explains
+ how this feature works.
+ </para>
+
+ <sect3>
+ <title>DLL types</title>
+ <variablelist>
+ <varlistentry>
+ <term>native</term>
+ <listitem> <para>
+ A "native" DLL is a <filename>.DLL</filename> file
+ written for the real Microsoft Windows.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>builtin</term>
+ <listitem> <para>
+ A "builtin" DLL is a Wine DLL. These can either be a
+ part of <filename>libwine.so</filename>, or more
+ recently, in a special <filename>.so</filename> file
+ that Wine is able to load on demand.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>elfdll</term>
+ <listitem> <para>
+ An "elfdll" is a Wine <filename>.so</filename> file
+ with a special Windows-like file structure that is as
+ close to Windows as possible, and that can also
+ seamlessly link dynamically with "native" DLLs, by
+ using special ELF loader and linker tricks. Bertho
+ Stultiens did some work on this, but this feature has
+ not yet been merged back into Wine (because of
+ political reasons and lack of time), so this DLL type
+ does not exist in the official Wine at this time. In
+ the meantime, the "builtin" DLL type gained some of
+ the features of elfdlls (such as dynamic loading), so
+ it's possible that "elfdll" functionality will be
+ folded into "builtin" at some point.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>so</term>
+ <listitem> <para>
+ A native Unix <filename>.so</filename> file, with
+ calling convention conversion thunks generated on the
+ fly as the library is loaded. This is mostly useful
+ for libraries such as "glide" that have exactly the
+ same API on both Windows and Unix.
+ </para> </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect3>
+
+ <sect3>
+ <title>The [DllDefaults] section</title>
+ <variablelist>
+ <varlistentry>
+ <term>DefaultLoadOrder</term>
+ <listitem> <para>
+ This specifies in what order Wine should search for
+ available DLL types, if the DLL in question was not
+ found in the [DllOverrides] section.
+ </para> </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect3>
+
+ <sect3>
+ <title>The [DllPairs] section</title>
+ <para>
+ At one time, there was a section called [DllPairs] in the
+ default configuration file, but this has been obsoleted
+ because the pairing information has now been embedded into
+ Wine itself. (The purpose of this section was merely to be
+ able to issue warnings if the user attempted to pair
+ codependent 16-bit/32-bit DLLs of different types.) If you
+ still have this in your <filename>wine.conf</filename> or
+ <filename>~/.wine/config</filename>, you may safely delete it.
+ </para>
+ </sect3>
+
+ <sect3>
+ <title>The [DllOverrides] section</title>
+ <para>
+ This section specifies how you want specific DLLs to be
+ handled, in particular whether you want to use "native" DLLs
+ or not, if you have some from a real Windows configuration.
+ Because builtins do not mix seamlessly with native DLLs yet,
+ certain DLL dependencies may be problematic, but workarounds
+ exist in Wine for many popular DLL configurations. Also see
+ WWN's [16]Status Page to figure out how well your favorite
+ DLL is implemented in Wine.
+ </para>
+ <para>
+ It is of course also possible to override these settings by
+ explictly using Wine's <parameter>--dll</parameter>
+ command-line option (see the man page for details). Some
+ hints for choosing your optimal configuration (listed by
+ 16/32-bit DLL pair):
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>krnl386, kernel32</term>
+ <listitem> <para>
+ Native versions of these will never work, so don't try. Leave
+ at <literal>builtin</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>gdi, gdi32</term>
+ <listitem> <para>
+ Graphics Device Interface. No effort has been made at trying to
+ run native GDI. Leave at <literal>builtin</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>user, user32</term>
+ <listitem> <para>
+ Window management and standard controls. It was
+ possible to use Win95's <literal>native</literal>
+ versions at some point (if all other DLLs that depend
+ on it, such as comctl32 and comdlg32, were also run
+ <literal>native</literal>). However, this is no longer
+ possible after the Address Space Separation, so leave
+ at <literal>builtin</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>ntdll</term>
+ <listitem> <para>
+ NT kernel API. Although badly documented, the
+ <literal>native</literal> version of this will never
+ work. Leave at <literal>builtin</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>w32skrnl</term>
+ <listitem> <para>
+ Win32s (for Win3.x). The <literal>native</literal>
+ version will probably never work. Leave at
+ <literal>builtin</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>wow32</term>
+ <listitem> <para>
+ Win16 support library for NT. The
+ <literal>native</literal> version will probably never
+ work. Leave at <literal>builtin</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>system</term>
+ <listitem> <para>
+ Win16 kernel stuff. Will never work
+ <literal>native</literal>. Leave at
+ <literal>builtin</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>display</term>
+ <listitem> <para>
+ Display driver. Definitely leave at <literal>builtin</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>toolhelp</term>
+ <listitem> <para>
+ Tool helper routines. This is rarely a source of problems.
+ Leave at <literal>builtin</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>ver, version</term>
+ <listitem> <para>
+ Versioning. Seldom useful to mess with.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>advapi32</term>
+ <listitem> <para>
+ Registry and security features. Trying the
+ <literal>native</literal> version of this may or may
+ not work.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>commdlg, comdlg32</term>
+ <listitem> <para>
+ Common Dialogs, such as color picker, font dialog,
+ print dialog, open/save dialog, etc. It is safe to try
+ <literal>native</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>commctrl, comctl32</term>
+ <listitem> <para>
+ Common Controls. This is toolbars, status bars, list controls,
+ the works. It is safe to try <literal>native</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>shell, shell32</term>
+ <listitem> <para>
+ Shell interface (desktop, filesystem, etc). Being one of the
+ most undocumented pieces of Windows, you may have luck with the
+ <literal>native</literal> version, should you need it.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>winsock, wsock32</term>
+ <listitem> <para>
+ Windows Sockets. The <literal>native</literal> version
+ will not work under Wine, so leave at
+ <literal>builtin</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>icmp</term>
+ <listitem> <para>
+ ICMP routines for wsock32. As with wsock32, leave at
+ <literal>builtin</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>mpr</term>
+ <listitem> <para>
+ The <literal>native</literal> version may not work due
+ to thunking issues. Leave at
+ <literal>builtin</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>lzexpand, lz32</term>
+ <listitem> <para>
+ Lempel-Ziv decompression. Wine's
+ <literal>builtin</literal> version ought to work fine.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>winaspi, wnaspi32</term>
+ <listitem> <para>
+ Advanced SCSI Peripheral Interface. The
+ <literal>native</literal> version will probably never
+ work. Leave at <literal>builtin</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>crtdll</term>
+ <listitem> <para>
+ C Runtime library. The <literal>native</literal>
+ version will easily work better than Wine's on this
+ one.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>winspool.drv</term>
+ <listitem> <para>
+ Printer spooler. You are not likely to have more luck
+ with the <literal>native</literal> version.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>ddraw</term>
+ <listitem> <para>
+ DirectDraw/Direct3D. Since Wine does not implement the
+ DirectX HAL, the <literal>native</literal> version
+ will not work at this time.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>dinput</term>
+ <listitem> <para>
+ DirectInput. Running this <literal>native</literal>
+ may or may not work.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>dsound</term>
+ <listitem> <para>
+ DirectSound. It may be possible to run this
+ <literal>native</literal>, but don't count on it.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>dplay/dplayx</term>
+ <listitem> <para>
+ DirectPlay. The <literal>native</literal> version
+ ought to work best on this, if at all.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>mmsystem, winmm</term>
+ <listitem> <para>
+ Multimedia system. The <literal>native</literal>
+ version is not likely to work. Leave at
+ <literal>builtin</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>msacm, msacm32</term>
+ <listitem> <para>
+ Audio Compression Manager. The
+ <literal>builtin</literal> version works best, if you
+ set msacm.drv to the same.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>msvideo, msvfw32</term>
+ <listitem> <para>
+ Video for Windows. It is safe (and recommended) to try
+ <literal>native</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>mcicda.drv</term>
+ <listitem> <para>
+ CD Audio MCI driver.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>mciseq.drv</term>
+ <listitem> <para>
+ MIDI Sequencer MCI driver (<filename>.MID</filename>
+ playback).
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>mciwave.drv</term>
+ <listitem> <para>
+ Wave audio MCI driver (<filename>.WAV</filename> playback).
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>mciavi.drv</term>
+ <listitem> <para>
+ AVI MCI driver (<filename>.AVI</filename> video
+ playback). Best to use <literal>native</literal>.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>mcianim.drv</term>
+ <listitem> <para>
+ Animation MCI driver.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>msacm.drv</term>
+ <listitem> <para>
+ Audio Compression Manager. Set to same as msacm32.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>midimap.drv</term>
+ <listitem> <para>
+ MIDI Mapper.
+ </para> </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>wprocs</term>
+ <listitem> <para>
+ This is a pseudo-DLL used by Wine for thunking
+ purposes. A <literal>native</literal> version of this
+ doesn't exist.
+ </para> </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect3>
+ </sect2>
+ <sect2 id="dll-missing">
+ <title>Missing DLLs</title>
+
+ <para>
+ Written by &name-andreas-mohr; <email>&email-andreas-mohr;</email>
+ </para>
+
+ <para>
+ In case Wine complains about a missing DLL, you should check whether
+ this file is a publicly available DLL or a custom DLL belonging
+ to your program (by searching for its name on the internet).
+ If you managed to get hold of the DLL, then you should make sure
+ that Wine is able to find and load it.
+ DLLs usually get loaded according to the mechanism of the
+ SearchPath() function.
+ This function searches directories in the following order:
+
+ a) The directory the program was started from.
+ b) The current directory.
+ c) The Windows system directory.
+ d) The Windows directory.
+ e) The PATH variable directories.
+
+ In short: either put the required DLL into your application
+ directory (might be ugly), or usually put it into the Windows system
+ directory. Just find out its directory by having a look at the Wine
+ config File variable "System" (which indicates the location of the
+ Windows system directory) and the associated drive entry.
+ </para>
</sect2>
</sect1>
diff --git a/documentation/wine.conf.man.in b/documentation/wine.conf.man.in
index ef335c1..43263dc2 100644
--- a/documentation/wine.conf.man.in
+++ b/documentation/wine.conf.man.in
@@ -104,25 +104,30 @@
.br
default: "C:\\\\WINDOWS"
.br
-Used to specify a different Windows directory; make sure to double the
-backslashes.
-So if you previously configured drive C: to be at /dos, this now means that
-the windows directory should be at /dos/WINDOWS.
+Used to specify where Wine is supposed to have its Windows directory
+(which is an essential part of a Windows environment); make sure to double
+the backslashes.
+In case of e.g. C:\\WINDOWS, with drive C: being configured as
+/home/user/wine_c, the /home/user/wine_c/WINDOWS directory would be used for
+this.
.PP
.I format: """system""=""<directory>"""
.br
default: "C:\\\\WINDOWS\\\\System"
.br
-Used to specify a different system directory; make sure to double the
-backslashes.
-Again, given a drive C: at /dos, this would be at /dos/WINDOWS/System.
+Used to specify where Wine is supposed to have its Windows system directory
+(again, essential part of Windows environment); make sure to double the backslashes.
+Given a setting of C:\\WINDOWS\\System (the standard setting on Windows)
+and a C: drive again at /home/user/wine_c, the /home/user/wine_c/WINDOWS/System
+directory would be used for this.
.PP
.I format: """temp""=""<directory>"""
.br
default: "C:\\\\TEMP"
.br
Used to specify a directory where Windows applications can store
-temporary files.
+temporary files. E.g. with a C: drive at /home/user/wine_c, this would be
+the /home/user/wine_c/TEMP directory.
.PP
.I format: """profile""=""<directory>"""
.br
diff --git a/documentation/wine.man.in b/documentation/wine.man.in
index 88da2db..fb26a33 100644
--- a/documentation/wine.man.in
+++ b/documentation/wine.man.in
@@ -81,6 +81,8 @@
.br
.I --debugmsg +relay=advapi32
will only turn on relay messages into the ADVAPI32 code.
+Never ever use simply --debugmsg +all ! Way too much info, and it crashes
+way too easily, thus confusing unexperienced users.
.PP
The full list of names is:
all, accel, advapi, animate, aspi, atom, avifile, bitblt, bitmap, caret,
