Updated for change in config file name. Removed references to

obsolete global wine configuration file where appropriate.  Updated
config option format to match the new syntax.  Misc cleanups.
This commit is contained in:
Chris Morgan 2001-01-18 23:03:47 +00:00 committed by Alexandre Julliard
parent 16cbf4022c
commit 9a94980190
8 changed files with 188 additions and 233 deletions

View File

@ -50,7 +50,7 @@
<para>
This section will guide you through the process of making a
config file. Take a look at the file <filename>&lt;dirs to
wine>/wine.ini</filename>. It is organized by section.
wine>/documentation/samples/config</filename>. It is organized by section.
</para>
<informaltable frame="all">
@ -167,7 +167,7 @@
</para>
<para>
<programlisting>
Type=floppy|hd|cdrom|network &lt;--- the |'s mean Type=&lt;one of the options>
"Type" = "floppy|hd|cdrom|network" &lt;--- the |'s mean "Type = "&lt;one of the options>"
</programlisting>
</para>
<para>
@ -177,20 +177,20 @@ Type=floppy|hd|cdrom|network &lt;--- the |'s mean Type=&lt;one of the options>
<literal>network</literal>. They are self-explanatory.
</para>
<para>
<programlisting>Label=blah</programlisting> Defines the
<programlisting>"Label" = "blah"</programlisting> Defines the
drive label. Generally only needed for programs that look
for a special CD-ROM. Info on finding the lable is in
<literal>&lt;dirs to wine>/documentation/cdrom-labels</literal>.
The label may be up to 11 characters.
</para>
<para>
<programlisting>Serial=deadbeef</programlisting>
<programlisting>"Serial" = "deadbeef"</programlisting>
Tells Wine the serial number of the drive. A few programs with
intense protection for pirating might need this, but otherwise
don't use it. Up to 8 characters and hexadecimal.
</para>
<para>
<programlisting>Filesystem=msdos|win95|unix</programlisting>
<programlisting>"Filesystem" = "msdos|win95|unix"</programlisting>
Sets up the way Wine looks at files on the drive.
</para>
@ -235,7 +235,7 @@ Type=floppy|hd|cdrom|network &lt;--- the |'s mean Type=&lt;one of the options>
</varlistentry>
</variablelist>
<programlisting>Device=/dev/xx</programlisting>
<programlisting>"Device" = "/dev/xx"</programlisting>
<para>
Use this ONLY for floppy and cdrom devices. Using it on
Extended2 partitions can have dire results (when a windows
@ -256,25 +256,25 @@ Type=floppy|hd|cdrom|network &lt;--- the |'s mean Type=&lt;one of the options>
Here is a setup for Drive X, a generic hard drive:
<programlisting>
[Drive X]
Path=/dos-a
Type=hd
Label=Hard Drive
Filesystem=win95
"Path" = "/dos-a"
"Type" = "hd"
"Label" = "Hard Drive"
"Filesystem" = "win95"
This is a setup for Drive X, a generic CD-ROM drive:
[Drive X]
Path=/dos-d
Type=cdrom
Label=Total Annihilation
Filesystem=win95
Device=/dev/hdc
"Path" = "/dos-d"
"Type" = "cdrom"
"Label" = "Total Annihilation"
"Filesystem" = "win95"
"Device" = "/dev/hdc"
And here is a setup for Drive X, a generic floppy drive:
[Drive X]
Type=floppy
Path=/mnt/floppy
Label=Floppy Drive
Serial=87654321
Filesystem=win95
Device=/dev/fd0
"Type" = "floppy"
"Path" = "/mnt/floppy"
"Label" = "Floppy Drive"
"Serial" = "87654321"
"Filesystem" = "win95"
"Device" = "/dev/fd0"
</programlisting>
</para>
</sect3>
@ -289,15 +289,15 @@ Device=/dev/fd0
has a path of <filename>/dos</filename>, and your
<filename>windows</filename> directory is located in
<filename>/dos/windows</filename>, then use:
<programlisting>Windows=c:\windows</programlisting>
<programlisting>"Windows" = "c:\\windows"</programlisting>
</para>
<para>
This sets up the <filename>windows</filename> directory.
Make one if you don't already have one. NO TRAILING SLASH
(NOT <filename>C:\windows\</filename>)!
(NOT <filename>C:\\windows\</filename>)!
</para>
<para>
<programlisting>System=c:\windows\system</programlisting>
<programlisting>"System" = "c:\\windows\\system"</programlisting>
This sets up where the windows system files are. Should
reside in the directory used for the
<literal>Windows</literal> setting. If you don't have
@ -305,13 +305,13 @@ Device=/dev/fd0
files will go. Again, NO TRAILING SLASH!
</para>
<para>
<programlisting>Temp=c:\temp</programlisting> This should
<programlisting>"Temp" = "c:\\temp"</programlisting> This should
be the directory you want your temp files stored in. YOU
MUST HAVE WRITE ACCESS TO IT.
</para>
<para>
<programlisting>
Path=c:\windows;c:\windows\system;c:\blanco
"Path" = "c:\\windows;c:\\windows\\system;c:\\blanco"
</programlisting>
</para>
<para>
@ -324,21 +324,21 @@ Path=c:\windows;c:\windows\system;c:\blanco
current directory, wine will run that one). Make sure it
always has your <filename>windows</filename> directory and
system directory (For this setup, it must have
<filename>c:\windows;c:\windows\system</filename>).
<filename>"c:\\windows;c:\\windows\\system"</filename>).
</para>
<para>
<programlisting>SymbolTableFile=wine.sym</programlisting>
<programlisting>"SymbolTableFile" = "wine.sym"</programlisting>
Sets up the symbol table file for the wine debugger. You
probably don't need to fiddle with this. May be useful if
your wine is stripped.
</para>
<para>
<programlisting>printer=off|on</programlisting> Tells wine
<programlisting>"printer" = "off|on"</programlisting> Tells wine
whether to allow printer drivers and printing to work.
Using these things are pretty alpha, so you might want to
watch out. Some people might find it useful, however. If
you're not planning on working on printing, don't even add
this to your <filename>wine.ini</filename> (It probably
this to your <filename>~/.wine/config</filename> (It probably
isn't already in it). Check out the [spooler] and
[parallelports] sections too.
</para>
@ -462,14 +462,7 @@ Path=c:\windows;c:\windows\system;c:\blanco
These settings provide wine's default handling of DLL loading.
</para>
<para>
<programlisting>EXTRA_LD_LIBRARY_PATH=/dirs</programlisting>
</para>
<para>
The directory specified here is appended to the normal search
path for certain forms of DLL's (elfdll and .so).
</para>
<para>
<programlisting>DefaultLoadOrder = native, elfdll, so, builtin</programlisting>
<programlisting>"DefaultLoadOrder" =" native, so, builtin"</programlisting>
</para>
<para>
This setting is a comma-delimited list of which order to
@ -482,30 +475,15 @@ Path=c:\windows;c:\windows\system;c:\blanco
<sect3>
<title>The [DllPairs] Section</title>
<para>
This section is optional, but strongly recommended. If you
try to use native SHELL32, but builtin SHELL, you could
have some big problems (native and builtin/so/elfdll do
certain things in different ways). Using different forms
of a pair is a *very*, **very** bad idea. By specifying
DLL pairs here, wine will print out a message if you use
different forms of a pair. You shouldn't need to change
anything in this section, the following should work fine
in all cases:
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>
<programlisting>
[DllPairs]
kernel = kernel32
gdi = gdi32
user = user32
commdlg = comdlg32
commctrl= comctl32
ver = version
shell = shell32
lzexpand= lz32
winsock = wsock32
</programlisting>
</sect3>
<sect3>
<title>The [DllOverrides] Section</title>
<para>
@ -518,43 +496,62 @@ winsock = wsock32
For example, to load builtin KERNEL pair (case doesn't
matter here):
<programlisting>
kernel,kernel32 = builtin
"kernel,kernel32" = "builtin"
</programlisting>
</para>
<para>
To load the native COMMDLG pair, but if that doesn't work
try builtin:
<programlisting>
commdlg,comdlg32 = native,builtin
"commdlg,comdlg32" = "native,builtin"
</programlisting>
</para>
<para>
To load the native COMCTL32:
<programlisting>
comctl32 = native
"comctl32" = "native"
</programlisting>
</para>
<para>
Here is a good generic setup (As it is defined in wine.ini
Here is a good generic setup (As it is defined in config
that was included with your wine package):
<programlisting>
[DllOverrides]
kernel32, gdi32, user32 = builtin
kernel, gdi, user = builtin
toolhelp = builtin
comdlg32, commdlg = elfdll, builtin, native
version, ver = elfdll, builtin, native
shell32, shell = builtin, native
lz32, lzexpand = builtin, native
commctrl, comctl32 = builtin, native
wsock32, winsock = builtin
advapi32, crtdll, ntdll = builtin, native
mpr, winspool = builtin, native
ddraw, dinput, dsound = builtin, native
winmm, w32skrnl, msvfw32= builtin
wnaspi32, wow32 = builtin
system, display, wprocs = builtin
wineps = builtin
"commdlg" = "builtin, native"
"comdlg32" = "builtin, native"
"ver" = "builtin, native"
"version" = "builtin, native"
"shell" = "builtin, native"
"shell32" = "builtin, native"
"lzexpand" = "builtin, native"
"lz32" = "builtin, native"
"comctl32" = "builtin, native"
"commctrl" = "builtin, native"
"wsock32" = "builtin"
"winsock" = "builtin"
"advapi32" = "builtin, native"
"crtdll" = "builtin, native"
"mpr" = "builtin, native"
"winspool.drv" = "builtin, native"
"ddraw" = "builtin, native"
"dinput" = "builtin, native"
"dsound" = "builtin, native"
"mmsystem" = "builtin"
"winmm" = "builtin"
"msvcrt" = "native, builtin"
"msvideo" = "builtin, native"
"msvfw32" = "builtin, native"
"mcicda.drv" = "builtin, native"
"mciseq.drv" = "builtin, native"
"mciwave.drv" = "builtin, native"
"mciavi.drv" = "native, builtin"
"mcianim.drv" = "native, builtin"
"msacm.drv" = "builtin, native"
"msacm" = "builtin, native"
"msacm32" = "builtin, native"
"midimap.drv" = "builtin, native"
"wnaspi32" = "builtin"
"icmp" = "builtin"
</programlisting>
</para>
<note>
@ -574,7 +571,7 @@ wineps = builtin
</para>
<para>
<programlisting>
AllocSystemColors=100
"AllocSystemColors" = "100"
</programlisting>
System colors to allocate? Just leave it at 100.
</para>
@ -586,7 +583,7 @@ AllocSystemColors=100
This section sets up wine's font handling.
</para>
<para>
<programlisting>Resolution = 96</programlisting>
<programlisting>"Resolution" = "96"</programlisting>
</para>
<para>
Since the way X handles fonts is different from the way
@ -601,7 +598,7 @@ AllocSystemColors=100
working acceptably in wine.
</para>
<para>
<programlisting>Default = -adobe-times-</programlisting>
<programlisting>"Default" = "-adobe-times-"</programlisting>
The default font wine uses. Fool around with it if you'd like.
</para>
<para>
@ -612,7 +609,7 @@ OPTIONAL:
used in wine. This is good for apps that need a special font you don't have,
but a good replacement exists. The syntax is like so:
<programlisting>
AliasX = [Fake windows name],[Real X name]&lt;,optional "masking" section>
"AliasX" = "[Fake windows name],[Real X name]"&lt;,optional "masking" section>
</programlisting>
</para>
<para>
@ -630,14 +627,14 @@ AliasX = [Fake windows name],[Real X name]&lt;,optional "masking" section>
apps as "Google". When defining an alias in a config file, forget about my
comment text (The "&lt;-- blah" stuff)
<programlisting>
Alias0 = Foo,--google- &lt;-- Note the no spaces after the " = ". Important!
"Alias0" = "Foo,--google-" &lt;
</programlisting>
</para>
<para>
Here is an example with masking enabled. The font will show up as "Foo" in
windows apps.
<programlisting>
Alias1 = Foo,--google-,subst
"Alias1" = "Foo,--google-,subst"
</programlisting>
</para>
<para>
@ -655,7 +652,7 @@ Alias1 = Foo,--google-,subst
<para>
The [serialports] section tells wine what serial ports it
is allowed to use.
<programlisting>ComX=/dev/cuaY</programlisting>
<programlisting>"ComX" = "/dev/cuaY"</programlisting>
</para>
<para>
Replace <literal>X</literal> with the number of the COM
@ -666,7 +663,7 @@ Alias1 = Foo,--google-,subst
(<medialabel>/dev/modem</medialabel> is acceptable). It is
not always necessary to define any COM ports (An optional
setting). Here is an example:
<programlisting>Com1=/dev/cua0</programlisting>
<programlisting>"Com1" = "/dev/cua0"</programlisting>
</para>
<para>
Use as many of these as you like in the section to define
@ -675,7 +672,7 @@ Alias1 = Foo,--google-,subst
<para>
The [parallelports] section sets up any parallel ports
that will be allowed access under wine.
<programlisting>LptX=/dev/lpY</programlisting>
<programlisting>"LptX" = "/dev/lpY"</programlisting>
</para>
<para>
Sounds familiar? Syntax is just like the COM port setting.
@ -686,7 +683,7 @@ Alias1 = Foo,--google-,subst
to define a parallel port (AKA, it's optional). As with
the other section, LptX can equal any device (Maybe
<medialabel>/dev/printer</medialabel>). Here is an
example: <programlisting>Lpt1=/dev/lp0</programlisting>
example: <programlisting>"Lpt1" = "/dev/lp0"</programlisting>
</para>
<para>
The [spooler] section will inform wine where to spool
@ -696,12 +693,12 @@ Alias1 = Foo,--google-,subst
setting you use in this section works to map a port (LPT1,
for example) to a file or a command. Here is an example,
mapping LPT1 to the file <filename>out.ps</filename>:
<programlisting>LPT1:=out.ps</programlisting>
<programlisting>"LPT1:" = "out.ps"</programlisting>
</para>
<para>
The following command maps printing jobs to LPT1 to the
command <command>lpr</command>. Notice the |:
<programlisting>LPT1:=|lpr</programlisting>
<programlisting>"LPT1:" = "|lpr"</programlisting>
</para>
<para>
The [ports] section is usually useful only for people who
@ -709,11 +706,11 @@ Alias1 = Foo,--google-,subst
scanners. IF YOU DON'T NEED IT, DON'T USE IT!
</para>
<para>
<programlisting>read=0x779,0x379,0x280-0x2a0</programlisting>
<programlisting>"read" = "0x779,0x379,0x280-0x2a0"</programlisting>
Gives direct read access to those IO's.
</para>
<para>
<programlisting>write=0x779,0x379,0x280-0x2a0</programlisting>
<programlisting>"write" = "0x779,0x379,0x280-0x2a0"</programlisting>
Gives direct write access to those IO's. It's probably a
good idea to keep the values of the
<literal>read</literal> and <literal>write</literal>
@ -731,17 +728,17 @@ Alias1 = Foo,--google-,subst
REMOVE ANYTHING IN THIS SECTION TO YOUR CONFIG.
</para>
<para>
<programlisting>File=/blanco</programlisting>
<programlisting>"File" = "/blanco"</programlisting>
Sets the logfile for wine. Set to CON to log to standard out.
THIS IS RARELY USED.
</para>
<para>
<programlisting>Exclude=WM_SIZE;WM_TIMER;</programlisting>
<programlisting>"Exclude" = "WM_SIZE;WM_TIMER;"</programlisting>
Excludes debug messages about <constant>WM_SIZE</constant>
and <constant>WM_TIMER</constant> in the logfile.
</para>
<para>
<programlisting>Include=WM_SIZE;WM_TIMER;</programlisting>
<programlisting>"Include" = "WM_SIZE;WM_TIMER;"</programlisting>
Includes debug messages about <constant>WM_SIZE</constant>
and <constant>WM_TIMER</constant> in the logfile.
</para>
@ -752,19 +749,15 @@ Alias1 = Foo,--google-,subst
windows installation.
</para>
<para>
<programlisting>UserFileName=/dirs/to/user.reg</programlisting>
<programlisting>"UserFileName" = "/dirs/to/user.reg"</programlisting>
The location of your old <filename>user.reg</filename> file.
</para>
<para>
<programlisting>LocalMachineFileName=/dirs/to/system.reg</programlisting>
The location of your old <filename>system.reg</filename> file.
</para>
<para>
[tweak.layout] is devoted to wine's look. There is only
one setting for it.
</para>
<para>
<programlisting>WineLook=win31|win95|win98</programlisting>
<programlisting>"WineLook" = "win31|win95|win98"</programlisting>
Will change the look of wine from Windows 3.1 to Windows 95.
The <literal>win98</literal> setting behaves
just like <literal>win95</literal> most of the time.
@ -774,11 +767,11 @@ Alias1 = Foo,--google-,subst
special conditions.
</para>
<para>
<programlisting>Default=/program/to/execute.exe</programlisting>
<programlisting>"Default" = "/program/to/execute.exe"</programlisting>
Sets the program to be run if wine is started without specifying a program.
</para>
<para>
<programlisting>Startup=/program/to/execute.exe</programlisting>
<programlisting>"Startup" = "/program/to/execute.exe"</programlisting>
Sets the program to automatically be run at startup every time.
</para>
</sect3>
@ -794,11 +787,13 @@ Alias1 = Foo,--google-,subst
<term><filename>/usr/local/etc/wine.conf</filename></term>
<listitem><para>
A systemwide config file, used for anyone who doesn't
have their own.
have their own. NOTE: this file is currently unused as a
new global configuration mechanism is not in place at this
time
</para></listitem>
</varlistentry>
<varlistentry>
<term><filename>$HOME/.winerc</filename></term>
<term><filename>$HOME/.wine/config</filename></term>
<listitem><para>
Your own config file, that only is used for your user.
</para></listitem>
@ -807,7 +802,8 @@ Alias1 = Foo,--google-,subst
<para>
So copy your version of the <filename>wine.conf</filename> file to
<filename>/usr/local/etc/wine.conf</filename> or
<filename>$HOME/.winerc</filename> for wine to recognize it.
<filename>$HOME/.wine/config</filename> for wine to recognize
it.
</para>
</sect2>
@ -817,7 +813,8 @@ Alias1 = Foo,--google-,subst
There is always a chance that things will go wrong. If the
unthinkable happens, try the newsgroup,
<systemitem>comp.emulators.ms-windows.wine</systemitem>,
or the IRCnet channel <systemitem>#WineHQ</systemitem>.
or the IRCnet channel <systemitem>#WineHQ</systemitem> found on
irc.stealth.net:6668, or connected servers.
Make sure that you have looked over this document thoroughly,
and have also read:
</para>
@ -855,30 +852,30 @@ Alias1 = Foo,--google-,subst
Instead of compiling Wine for Win3.1 vs. Win95 using
<constant>#define</constant> switches, the code now looks in a
special [Tweak.Layout] section of
<filename>wine.conf</filename> for a
<literal>WineLook=Win95</literal> or
<literal>WineLook=Win98</literal> entry.
<filename>~/.wine/config</filename> for a
<literal>"WineLook" = "Win95"</literal> or
<literal>"WineLook" = "Win98"</literal> entry.
</para>
<para>
A few new sections and a number of entries have been added to
the <filename>wine.conf file</filename> -- these are for
the <filename>~/.wine/config</filename> file -- these are for
debugging the Win95 tweaks only and may be removed in a future
release! These entries/sections are:
</para>
<programlisting>
[Tweak.Fonts]
System.Height=&lt;point size> # Sets the height of the system typeface
System.Bold=[true|false] # Whether the system font should be boldfaced
System.Italic=[true|false] # Whether the system font should be italicized
System.Underline=[true|false] # Whether the system font should be underlined
System.StrikeOut=[true|false] # Whether the system font should be struck out
OEMFixed.xxx # Same parameters for the OEM fixed typeface
AnsiFixed.xxx # Same parameters for the Ansi fixed typeface
AnsiVar.xxx # Same parameters for the Ansi variable typeface
SystemFixed.xxx # Same parameters for the System fixed typeface
"System.Height" = "&lt;point size>" # Sets the height of the system typeface
"System.Bold" = "[true|false]" # Whether the system font should be boldfaced
"System.Italic" = "[true|false]" # Whether the system font should be italicized
"System.Underline" = "[true|false]" # Whether the system font should be underlined
"System.StrikeOut" = "[true|false]" # Whether the system font should be struck out
"OEMFixed.xxx" # Same parameters for the OEM fixed typeface
"AnsiFixed.xxx" # Same parameters for the Ansi fixed typeface
"AnsiVar.xxx" # Same parameters for the Ansi variable typeface
"SystemFixed.xxx" # Same parameters for the System fixed typeface
[Tweak.Layout]
WineLook=[Win31|Win95|Win98] # Changes Wine's look and feel
"WineLook" = "[Win31|Win95|Win98]" # Changes Wine's look and feel
</programlisting>
</sect1>
@ -901,9 +898,8 @@ WineLook=[Win31|Win95|Win98] # Changes Wine's look and feel
ncurses-based ttydrv, which he claims works for displaying
calc.exe). The display driver is chosen with the
<literal>GraphicsDriver</literal> option in the [wine] section
of <filename>wine.conf</filename> or
<filename>.winerc</filename>, but I will only cover the x11drv
driver in this article.
of <filename>~/.wine/config</filename>, but I will only cover the
x11drv driver in this article.
</para>
<sect2>
@ -1205,26 +1201,26 @@ WineLook=[Win31|Win95|Win98] # Changes Wine's look and feel
<para>
Reading labels and serial numbers just works automagically
if you specify a <literal>Device=</literal> line in the
[Drive X] section in your <filename>wine.conf</filename>.
[Drive X] section in your <filename>~/.wine/config</filename>.
Note that the device has to exist and must be accessible if
you do this, though.
</para>
<para>
If you don't do that, then you should give fixed
<literal>Label=</literal> or <literal>Serial=</literal>
entries in <filename>wine.conf</filename>, as Wine returns
<literal>"Label" =</literal> or <literal>"Serial" =</literal>
entries in <filename>~./wine/config</filename>, as Wine returns
these entries instead if no device is given. If they don't
exist, then Wine will return default values (label
<literal>Drive X</literal> and serial
<literal>12345678</literal>).
</para>
<para>
If you want to give a <literal>Device=</literal> entry
If you want to give a <literal>"Device" =</literal> entry
<emphasis>only</emphasis> for drive raw sector accesses,
but not for reading the volume info from the device (i.e. you want
a <emphasis>fixed</emphasis>, preconfigured label), you need
to specify <literal>ReadVolInfo=0</literal> to tell Wine to
skip the volume reading.
to specify <literal>"ReadVolInfo" = "0"</literal> to tell Wine
to skip the volume reading.
</para>
</sect2>
@ -1237,28 +1233,28 @@ WineLook=[Win31|Win95|Win98] # Changes Wine's look and feel
</para>
<screen>
[Drive A]
Path=/mnt/floppy
Type=floppy
Device=/dev/fd0
Filesystem=msdos
"Path" = "/mnt/floppy"
"Type" = "floppy"
"Device" = "/dev/fd0"
"Filesystem" = "msdos"
[Drive R]
Path=/mnt/cdrom
Type=cdrom
Device=/dev/hda1
Filesystem=win95
"Path" = "/mnt/cdrom"
"Type" = "cdrom"
"Device" = "/dev/hda1"
"Filesystem" = "win95"
</screen>
<para>
Here's an example of overriding the CD-ROM label:
</para>
<screen>
[Drive J]
Path=/mnt/cdrom
Type=cdrom
Label=X234GCDSE
"Path" = "/mnt/cdrom"
"Type" = "cdrom"
"Label" = "X234GCDSE"
; note that the device isn't really needed here as we have a fixed label
Device=/dev/cdrom
Filesystem=msdos
"Device" = "/dev/cdrom"
"Filesystem" = "msdos"
</screen>
</sect2>
@ -1361,19 +1357,6 @@ Filesystem=msdos
<sect2>
<title>The [DllDefaults] section</title>
<variablelist>
<varlistentry>
<term>EXTRA_LD_LIBRARY_PATH</term>
<listitem> <para>
This specifies the location of the Wine's DLL
<filename>.so</filename> files. Wine will search this
path when trying to locate a DLL of the type
<literal>builtin</literal> or
<literal>elfdll</literal>. (This does not apply to
<filename>libwine.so</filename>, since
<filename>libwine.so</filename> is not a DLL in this
sense.)
</para> </listitem>
</varlistentry>
<varlistentry>
<term>DefaultLoadOrder</term>
<listitem> <para>
@ -1395,7 +1378,7 @@ Filesystem=msdos
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>.winerc</filename>, you may safely delete it.
<filename>~/.wine/config</filename>, you may safely delete it.
</para>
</sect2>

View File

@ -66,7 +66,7 @@
</listitem>
<listitem>
<para>
Edit the <filename>wine.conf</filename> file to remove
Edit the <filename>~/.wine/config</filename> file to remove
aliases for the fonts you've just installed.
</para>
</listitem>
@ -112,7 +112,7 @@ STUB: AddFontResource( SOMEFILE.FON )
</sect2>
<sect2>
<title>How To Add Font Aliases To <filename>wine.conf</filename></title>
<title>How To Add Font Aliases To <filename>~/.wine/config</filename></title>
<para>
Many Windows applications assume that fonts included in
original Windows 3.1 distribution are always present. By
@ -331,7 +331,7 @@ Default = -adobe-times-
WINE stores detailed information about available fonts in
the <filename>~/.wine/.cachedmetrics</filename> file. You
can copy it elsewhere and add this entry to the [fonts]
section in your <filename>wine.conf</filename>:
section in your <filename>~/.wine/config</filename>:
</para>
<screen>
FontMetrics = &lt;file with metrics&gt;

View File

@ -361,7 +361,7 @@ die folgenden Programme und Dateien installiert sein:
gültige Konfigurationsdatei oder über eine benutzerspezifische
Datei im Heimatverzeichnis des betreffenden Benutzers konfiguriert
werden. Die benutzerspezifische Konfigurationsdatei trägt den
Namen .winerc. Wenn diese Datei existiert, wird die systemweit
Namen ~/.wine/config. Wenn diese Datei existiert, wird die systemweit
gültige Konfigurationsdatei (standardmäßig
/usr/local/etc/wine.conf) nicht beachtet und es werden alle
Einstellungen aus der Konfigurationsdatei des betreffenden
@ -410,7 +410,7 @@ die folgenden Programme und Dateien installiert sein:
diese Vorlage durch den folgenden Befehl an den richtigen Platz
kopiert werden:
cp ~/wine/wine.ini ~/.winerc
cp ~/wine/documentation/samples/config ~/.wine/config
Die Werte, welche Variablen in der Konfigurationsdatei zugewiesen
werden, lassen sich in drei Typen einteilen: Zeichenketten, Zahlen
@ -439,7 +439,7 @@ die folgenden Programme und Dateien installiert sein:
Weil Programme, die für DOS oder Windows geschrieben sind,
Laufwerksbuchstaben verwenden, um Dateien zu bezeichnen, muss WINE
diese Buchstaben auf das UNIX-Dateisystem abbilden. Das Problem ist
auf die folgende Art gelöst: In der Konfigurationsdatei (.winerc
auf die folgende Art gelöst: In der Konfigurationsdatei (~/.wine/config
oder /usr/local/etc/wine.conf) wird jedem Laufwerksbuchstaben ein
Verzeichnis im UNIX-Dateisystem zugeordnet. Dieses Verzeichnis
stellt dann (aus Sicht der Windows-Programme) das Basisverzeichnis
@ -892,8 +892,8 @@ die folgenden Programme und Dateien installiert sein:
WINE-Versionen oder den Windows-Versionen dieser Bibliotheken
funktioniert.
In der Datei .winerc bzw. wine.conf gibt es zwei Abschnitte mit
denen bestimmt wird, welche Bibliotheken aus einer
In der Datei ~/.wine/config bzw. wine.conf gibt es zwei Abschnitte
mit denen bestimmt wird, welche Bibliotheken aus einer
Windows-Installation geladen werden sollen. Darüberhinaus können
diese Einstellungen beim Aufruf von WINE an der Kommandozeile
überschrieben werden. Im allgemeinen empfiehlt es sich, die
@ -1222,7 +1222,7 @@ die folgenden Programme und Dateien installiert sein:
7.6.3 Font-Einstellungen in der WINEs Konfigurationsdatei
In der Konfigurationsdatei .winerc bzw. wine.conf stehen die
In der Konfigurationsdatei ~/.wine/config bzw. wine.conf stehen die
folgenden Variablen zur Verfügung, mit denen WINEs Umgang mit
Schriftarten beeinflusst werden kann:

View File

@ -139,15 +139,15 @@ WinNT/2000 directory for common 16-bit DLLs</literallayout></entry>
be (<filename>tools/wineinstall</filename> will even ask
you). If you choose, say, <filename>/var/wine</filename>, as
the root of your virtual drive <medialabel>C</medialabel>,
then you'd put this in your <filename>wine.conf</filename>:
then you'd put this in your <filename>~/.wine/config</filename>:
</para>
<programlisting>
[Drive C]
Path=/var/wine
Type=hd
Label=MS-DOS
Filesystem=win95
"Path" = "/var/wine"
"Type" = "hd"
"Label" = "MS-DOS"
"Filesystem" = "win95"
</programlisting>
<para>
@ -155,8 +155,8 @@ Filesystem=win95
"c:\windows\system" would map to
<filename>/var/wine/windows/system</filename> in the UNIX
filesystem. Note that you need to specify
<literal>Filesystem=win95</literal>, NOT
<literal>Filesystem=unix</literal>, to make Wine simulate a
<literal>"Filesystem" = "win95"</literal>, NOT
<literal>"Filesystem" = "unix"</literal>, to make Wine simulate a
Windows-compatible (case-insensitive) filesystem, otherwise
most apps won't work.
</para>
@ -235,11 +235,10 @@ Filesystem=win95
<listitem>
<para>
Point <medialabel>[Drive C]</medialabel> in
<filename>wine.conf</filename> or
<filename>.winerc</filename> to where you want
<filename>~/.wine/config</filename> to where you want
<filename>C:</filename> to be. Refer to the Wine man page
for more information. Remember to use
<userinput>filesystem=win95</userinput>!
<userinput>"Filesystem" = "win95"</userinput>!
</para>
</listitem>
<listitem>
@ -286,8 +285,7 @@ Filesystem=win95
<listitem>
<para>
Edit the <quote>[DllOverrides]</quote> section of
<filename>wine.conf</filename> or
<filename>.winerc</filename> to specify
<filename>~/.wine/config</filename> to specify
<quote>native</quote> before <quote>builtin</quote> for
the Windows DLLs you want to use. For more information
about this, see the Wine manpage.
@ -307,7 +305,7 @@ Filesystem=win95
only as pairs to your Wine directory (these DLLs are
<quote>clean</quote> to use). Make sure you have these
specified in the <quote>[DllPairs]</quote> section of
<filename>wine.conf</filename> or .winerc.
<filename>~/.wine/config</filename>.
</para>
</listitem>
<listitem>
@ -364,13 +362,13 @@ Filesystem=win95
Wine maps mounted FAT filesystems, such as
<filename>/c</filename>, to driver letters, such as
<quote>c:</quote>, as indicated by the
<filename>wine.conf</filename> file. The following excerpt
from a <filename>wine.conf</filename> file does this:
<filename>~/.wine/config</filename> file. The following excerpt
from a <filename>~/.wine/config</filename> file does this:
</para>
<programlisting>
[Drive C]
Path=/c
Type=hd
"Path" = "/c"
"Type" = "hd"
</programlisting>
<para>
Although VFAT filesystems are preferable to FAT filesystems
@ -682,17 +680,17 @@ THIS MAY TRASH YOUR SYSTEM IF USED CORRECTLY
<para>
For Win32 software (WNASPI32), Wine has auto-detection in place.
For Win16 software (WINASPI), you need to add a SCSI device entry
for your particular scanner to wine.conf. The format is
for your particular scanner to ~/.wine/config. The format is
<literal>[scsi cCtTdD]</literal> where
<literal>C=controller</literal>,
<literal>T=target</literal>, <literal>D=LUN</literal>
<literal>"C" = "controller"</literal>,
<literal>"T" = "target"</literal>, <literal>D=LUN</literal>
</para>
<para>
For example, I set mine up as controller <literal>0</literal>,
Target <literal>6</literal>, LUN <literal>0</literal>.
<programlisting>
[scsi c0t6d0]
Device=/dev/sgi
"Device" = "/dev/sgi"
</programlisting>
Yours will vary with your particular SCSI setup.
</para>

View File

@ -144,7 +144,7 @@
contexts, if you want to prevent the screen to flicker when
using OpenGL applications (all games are using double-buffered
contexts), you need to set the following option in your
<filename>.winerc</filename> / <filename>wine.ini</filename>
<filename>~/.wine/config</filename> file
in the [x11drv] section :
</para>
<programlisting>

View File

@ -44,15 +44,15 @@ printer=on
</screen>
<para>
to the [wine] section of <filename>wine.conf</filename> (or
<filename>~/.winerc</filename>). This lets
<filename>~/.wine/config</filename>). This lets
<function>CreateDC</function> proceed if its driver argument is a 16
bit driver. You will probably also need to add
</para>
<screen>
TTEnable=0 TTOnly=0
"TTEnable" = "0" "TTOnly" = "0"
</screen>
<para>
to the [TrueType] section of <filename>win.ini</filename>. The code for
to the [TrueType] section of <filename>~/.wine/config</filename>. The code for
the driver interface is in <filename>graphics/win16drv</filename>.
</para>
</sect2>
@ -76,7 +76,7 @@ TTEnable=0 TTOnly=0
example the following lines
</para>
<screen>
LPT1:=foo.ps LPT2:=|lpr
"LPT1:" = "foo.ps" "LPT2:" = "|lpr"
</screen>
<para>
map <systemitem>LPT1:</systemitem> to file <filename>foo.ps</filename>
@ -116,23 +116,23 @@ LPT1:=foo.ps LPT2:=|lpr
To install it add
</para>
<screen>
Wine PostScript Driver=WINEPS,LPT1:
"Wine PostScript Driver" = "WINEPS,LPT1:"
</screen>
<para>
to the [devices] section and
</para>
<screen>
Wine PostScript Driver=WINEPS,LPT1:,15,45
"Wine PostScript Driver" = "WINEPS,LPT1:,15,45"
</screen>
<para>
to the [PrinterPorts] section of <filename>win.ini</filename> and to set it
as the default printer also add
</para>
<screen>
device=Wine PostScript Driver,WINEPS,LPT1:
"device" = "Wine PostScript Driver,WINEPS,LPT1:"
</screen>
<para>
to the [windows] section of <filename>win.ini</filename> and ???
to the [windows] section of <filename>~/.wine/config</filename> and ???
<emphasis>[sic]</emphasis>
</para>
<para>
@ -161,10 +161,10 @@ device=Wine PostScript Driver,WINEPS,LPT1:
<para>
Then create a [afmfiles] section in your
<filename>wine.conf</filename> (or
<filename>~/.winerc</filename>) and add a line of the form
<filename>~/.wine/config</filename>) and add a line of the form
</para>
<screen>
file&lt;n&gt;=/unix/path/name/filename.afm
"file&lt;n&gt;" = "/unix/path/name/filename.afm"
</screen>
<para>
for each AFM file that you wish to use. [This might change in the future]
@ -176,10 +176,10 @@ file&lt;n&gt;=/unix/path/name/filename.afm
have a look in <ulink url="ftp://ftp.adobe.com/pub/adobe/printerdrivers/win/all/">
ftp://ftp.adobe.com/pub/adobe/printerdrivers/win/all/</ulink>. Create
a [psdrv] section in your <filename>wine.conf</filename> (or
<filename>~/.winerc</filename>) and add the following entry:
<filename>~/.wine/config</filename>) and add the following entry:
</para>
<screen>
ppdfile=/somewhere/file.ppd
"ppdfile" = "/somewhere/file.ppd"
</screen>
<para>
By default, the driver will look for a file named

View File

@ -81,8 +81,7 @@
<para>
If you point Wine at an existing MS Windows installation (by
setting the appropriate directories in
<filename>wine.conf</filename> or
<filename>.winerc</filename>), then Wine is able to load
<filename>~/.wine/config</filename>, then Wine is able to load
registry data from it. However, Wine will not save anything to
the real Windows registry, but rather to its own registry
files (see below). Of course, if a particular registry value
@ -249,8 +248,8 @@ ln -sf /usr/local/etc/wine.userreg wine.userreg
<title>The [registry] section</title>
<para>
With the above information fresh in mind, let's look at the
<filename>wine.conf</filename>/<filename>.winerc</filename>
With the above information fresh in mind, let's look at the
<filename>wine.conf</filename>/<filename>~/.wine/config</filename>
options for handling the registry.
</para>

View File

@ -26,7 +26,6 @@
Usage: ./wine [options] program_name [arguments]
Options:
--config name Specify config file to use
--debugmsg name Turn debugging-messages on or off
--desktop geom Use a desktop window of the given geometry
--display name Use the specified display
@ -49,12 +48,7 @@ Options:
up with a sensible set of defaults; in this case, you can run
<command>wine</command> without explicitly listing any
options. In rare cases, you might want to override certain
parameters on the command line. If you find yourself using
the same long set of command options with certain
applications, you might find it easier to work with multiple
config files, using the <link
linkend="config-parameter"><parameter>--config</parameter>
parameter</link> to specify a non-default configuration.
parameters on the command line.
</para>
<para>
After the options, you should put the name of the file you
@ -108,25 +102,6 @@ Options:
<sect1 id="command-line-options">
<title>Command-Line Options</title>
<sect2 id="config-parameter">
<title>--config</title>
<para>
The <parameter>--config</parameter> parameter allows you to
specify which configuration file you want to use for the
current invocation of <command>wine</command>. For example,
if you like to run a specific application or set of
applications with a different array of options than your
normal defaults, you might set up a different config file
for them, and use the <parameter>--config</parameter> option
to make use of it.
</para>
<para>
The default value of <parameter>--config</parameter> is
<filename>~/.winerc</filename>. This value is hardwired
into the Wine source code. In future versions of Wine, the
default may change to <filename>~/.wine/conf</filename>.
</para>
</sect2>
<sect2>
<title>--debugmsg [channels]</title>
<para>