loader: Fix wine manpage formatting.

This commit is contained in:
Frédéric Delanoy 2013-07-19 14:59:14 +02:00 committed by Alexandre Julliard
parent 426bb06baa
commit 5cbf173636
1 changed files with 60 additions and 78 deletions

View File

@ -2,8 +2,8 @@
.SH NAME .SH NAME
wine \- run Windows programs on Unix wine \- run Windows programs on Unix
.SH SYNOPSIS .SH SYNOPSIS
.BI "wine " program .B wine
[arguments ... ] .IR "program " [ arguments ]
.br .br
.B wine --help .B wine --help
.br .br
@ -47,27 +47,25 @@ or in Unix format
You may pass arguments to the program being executed by adding them to the You may pass arguments to the program being executed by adding them to the
end of the command line invoking end of the command line invoking
.B wine .B wine
(such as: wine notepad C:\(rs\(rsTEMP\(rs\(rsREADME.TXT). (such as: \fIwine notepad C:\(rs\(rsTEMP\(rs\(rsREADME.TXT\fR).
Note that you need to '\(rs' escape special characters (and spaces) when invoking Wine via Note that you need to '\(rs' escape special characters (and spaces) when invoking Wine via
a shell, e.g. a shell, e.g.
.PP .PP
wine C:\(rs\(rsProgram\(rs Files\(rs\(rsMyPrg\(rs\(rstest.exe wine C:\(rs\(rsProgram\(rs Files\(rs\(rsMyPrg\(rs\(rstest.exe
.PP .PP
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT
.B wine .B wine
makes the environment variables of the shell from which makes the environment variables of the shell from which it
.B wine is started accessible to the Windows/DOS processes started. So use the
is started accessible to the windows/dos processes started. So use the
appropriate syntax for your shell to enter environment variables you need. appropriate syntax for your shell to enter environment variables you need.
.TP .TP
.I WINEPREFIX .B WINEPREFIX
If set, the content of this variable is taken as the name of the directory where If set, the contents of this variable is taken as the name of the directory where
.B wine Wine stores its data (the default is
stores its data (the default is
.IR $HOME/.wine ). .IR $HOME/.wine ).
This directory is also used to identify the socket which is used to This directory is also used to identify the socket which is used to
communicate with the communicate with the
.IR wineserver . .BR wineserver .
All All
.B wine .B wine
processes using the same processes using the same
@ -75,34 +73,34 @@ processes using the same
(i.e.: same user) share certain things like registry, shared memory, (i.e.: same user) share certain things like registry, shared memory,
and config file. and config file.
By setting By setting
.I WINEPREFIX .B WINEPREFIX
to different values for different to different values for different
.B wine .B wine
processes, it is possible to run a number of truly independent processes, it is possible to run a number of truly independent
.B wine .B wine
processes. processes.
.TP .TP
.I WINESERVER .B WINESERVER
Specifies the path and name of the Specifies the path and name of the
.B wineserver .B wineserver
binary. If not set, Wine will try to load binary. If not set, Wine will try to load
.BR @bindir@/wineserver , .IR @bindir@/wineserver ,
and if this doesn't exist it will then look for a file named and if this doesn't exist it will then look for a file named
"wineserver" in the path and in a few other likely locations. "wineserver" in the path and in a few other likely locations.
.TP .TP
.I WINELOADER .B WINELOADER
Specifies the path and name of the Specifies the path and name of the
.B wine .B wine
binary to use to launch new Windows processes. If not set, Wine will binary to use to launch new Windows processes. If not set, Wine will
try to load try to load
.BR @bindir@/wine , .IR @bindir@/wine ,
and if this doesn't exist it will then look for a file named "wine" in and if this doesn't exist it will then look for a file named "wine" in
the path and in a few other likely locations. the path and in a few other likely locations.
.TP .TP
.I WINEDEBUG .B WINEDEBUG
Turns debugging messages on or off. The syntax of the variable is Turns debugging messages on or off. The syntax of the variable is
of the form of the form
.RI [ class ][+/-] channel [,[ class2 ][+/-] channel2 ]. .RI [ class ][\fB+\fR|\fB-\fR] channel [,[ class2 ][\fB+\fR|\fB-\fR] channel2 ]
.RS +7 .RS +7
.PP .PP
.I class .I class
@ -116,12 +114,11 @@ If
.I class .I class
is not specified, all debugging messages for the specified is not specified, all debugging messages for the specified
channel are turned on. Each channel will print messages about a particular channel are turned on. Each channel will print messages about a particular
component of component of Wine.
.BR wine . The following character can be either \fB+\fR or \fB-\fR to switch the specified
The following character can be either + or - to switch the specified
channel on or off respectively. If there is no channel on or off respectively. If there is no
.I class .I class
part before it, a leading + can be omitted. Note that spaces are not part before it, a leading \fB+\fR\fR can be omitted. Note that spaces are not
allowed anywhere in the string. allowed anywhere in the string.
.PP .PP
Examples: Examples:
@ -150,24 +147,21 @@ For more information on debugging messages, see the
chapter of the Wine User Guide. chapter of the Wine User Guide.
.RE .RE
.TP .TP
.I WINEDLLPATH .B WINEDLLPATH
Specifies the path(s) in which to search for builtin dlls and Winelib Specifies the path(s) in which to search for builtin dlls and Winelib
applications. This is a list of directories separated by ":". In applications. This is a list of directories separated by ":". In
addition to any directory specified in addition to any directory specified in
.IR WINEDLLPATH , .BR WINEDLLPATH ,
Wine will also look in Wine will also look in
.BR @dlldir@ . .IR @dlldir@ .
.TP .TP
.I WINEDLLOVERRIDES .B WINEDLLOVERRIDES
Defines the override type and load order of dlls used in the loading Defines the override type and load order of dlls used in the loading
process for any dll. There are currently two types of libraries that can be loaded process for any dll. There are currently two types of libraries that can be loaded
into a process' address space: native windows dlls into a process address space: native windows dlls
.RI ( native ), .RI ( native ") and Wine internal dlls (" builtin ).
.B wine
internal dlls
.RI ( builtin ).
The type may be abbreviated with the first letter of the type The type may be abbreviated with the first letter of the type
.RI ( n ", " b ). .RI ( n " or " b ).
The library may also be disabled (''). Each sequence of orders must be separated by commas. The library may also be disabled (''). Each sequence of orders must be separated by commas.
.RS .RS
.PP .PP
@ -181,9 +175,9 @@ different libraries by separating the entries by ";".
The load order for a 16-bit dll is always defined by the load order of The load order for a 16-bit dll is always defined by the load order of
the 32-bit dll that contains it (which can be identified by looking at the 32-bit dll that contains it (which can be identified by looking at
the symbolic link of the 16-bit .dll.so file). For instance if the symbolic link of the 16-bit .dll.so file). For instance if
ole32.dll is configured as builtin, storage.dll will be loaded as \fIole32.dll\fR is configured as builtin, \fIstorage.dll\fR will be loaded as
builtin too, since the 32-bit ole32.dll contains the 16-bit builtin too, since the 32-bit \fIole32.dll\fR contains the 16-bit
storage.dll. \fIstorage.dll\fR.
.PP .PP
Examples: Examples:
.TP .TP
@ -195,16 +189,16 @@ the builtin version if the native load fails.
WINEDLLOVERRIDES="comdlg32,shell32=n;c:\(rs\(rsfoo\(rs\(rsbar\(rs\(rsbaz=b" WINEDLLOVERRIDES="comdlg32,shell32=n;c:\(rs\(rsfoo\(rs\(rsbar\(rs\(rsbaz=b"
.br .br
Try to load the libraries comdlg32 and shell32 as native windows dlls. Furthermore, if Try to load the libraries comdlg32 and shell32 as native windows dlls. Furthermore, if
an application request to load c:\(rsfoo\(rsbar\(rsbaz.dll load the builtin library baz. an application request to load \fIc:\(rsfoo\(rsbar\(rsbaz.dll\fR load the builtin library \fIbaz\fR.
.TP .TP
WINEDLLOVERRIDES="comdlg32=b,n;shell32=b;comctl32=n;oleaut32=" WINEDLLOVERRIDES="comdlg32=b,n;shell32=b;comctl32=n;oleaut32="
.br .br
Try to load comdlg32 as builtin first and try the native version if Try to load comdlg32 as builtin first and try the native version if
the builtin load fails; load shell32 always as builtin and comctl32 the builtin load fails; load shell32 always as builtin and comctl32
always as native. Oleaut32 will be disabled. always as native; oleaut32 will be disabled.
.RE .RE
.TP .TP
.I WINEARCH .B WINEARCH
Specifies the Windows architecture to support. It can be set either to Specifies the Windows architecture to support. It can be set either to
.B win32 .B win32
(support only 32-bit applications), or to (support only 32-bit applications), or to
@ -214,76 +208,64 @@ Specifies the Windows architecture to support. It can be set either to
The architecture supported by a given Wine prefix is set at prefix The architecture supported by a given Wine prefix is set at prefix
creation time and cannot be changed afterwards. When running with an creation time and cannot be changed afterwards. When running with an
existing prefix, Wine will refuse to start if existing prefix, Wine will refuse to start if
.I WINEARCH .B WINEARCH
doesn't match the prefix architecture. doesn't match the prefix architecture.
.TP .TP
.I DISPLAY .B DISPLAY
Specifies the X11 display to use. Specifies the X11 display to use.
.TP .TP
OSS sound driver configuration variables OSS sound driver configuration variables:
.TP .TP
.I AUDIODEV .B AUDIODEV
Set the device for audio input / output. Default Set the device for audio input / output. Default
.BR /dev/dsp . .IR /dev/dsp .
.TP .TP
.I MIXERDEV .B MIXERDEV
Set the device for mixer controls. Default Set the device for mixer controls. Default
.BR /dev/mixer . .IR /dev/mixer .
.TP .TP
.I MIDIDEV .B MIDIDEV
Set the MIDI (sequencer) device. Default Set the MIDI (sequencer) device. Default
.BR /dev/sequencer . .IR /dev/sequencer .
.SH FILES .SH FILES
.TP .TP
.I @bindir@/wine .I @bindir@/wine
The The Wine program loader.
.B wine
program loader.
.TP .TP
.I @bindir@/wineconsole .I @bindir@/wineconsole
The The Wine program loader for CUI (console) applications.
.B wine
program loader for CUI (console) applications.
.TP .TP
.I @bindir@/wineserver .I @bindir@/wineserver
The The Wine server
.B wine .TP
server
.TP
.I @bindir@/winedbg .I @bindir@/winedbg
The The Wine debugger
.B wine .TP
debugger
.TP
.I @dlldir@ .I @dlldir@
Directory containing Directory containing Wine shared libraries
.BR wine
shared libraries
.TP .TP
.I $WINEPREFIX/dosdevices .I $WINEPREFIX/dosdevices
Directory containing the DOS device mappings. Each file in that Directory containing the DOS device mappings. Each file in that
directory is a symlink to the Unix device file implementing a given directory is a symlink to the Unix device file implementing a given
device. For instance, if COM1 is mapped to /dev/ttyS0 you'd have a device. For instance, if COM1 is mapped to \fI/dev/ttyS0\fR you'd have a
symlink of the form $WINEPREFIX/dosdevices/com1 -> /dev/ttyS0. symlink of the form \fI$WINEPREFIX/dosdevices/com1\fR -> \fI/dev/ttyS0\fR.
.br .br
DOS drives are also specified with symlinks; for instance if drive D: DOS drives are also specified with symlinks; for instance if drive D:
corresponds to the CDROM mounted at /mnt/cdrom, you'd have a symlink corresponds to the CDROM mounted at \fI/mnt/cdrom\fR, you'd have a symlink
$WINEPREFIX/dosdevices/d: -> /mnt/cdrom. The Unix device corresponding \fI$WINEPREFIX/dosdevices/d:\fR -> \fI/mnt/cdrom\fR. The Unix device corresponding
to a DOS drive can be specified the same way, except with '::' instead to a DOS drive can be specified the same way, except with '::' instead
of ':'. So for the previous example, if the CDROM device is mounted of ':'. So for the previous example, if the CDROM device is mounted
from /dev/hdc, the corresponding symlink would be from \fI/dev/hdc\fR, the corresponding symlink would be
$WINEPREFIX/dosdevices/d:: -> /dev/hdc. \fI$WINEPREFIX/dosdevices/d::\fR -> \fI/dev/hdc\fR.
.SH AUTHORS .SH AUTHORS
.B wine Wine is available thanks to the work of many developers. For a listing
is available thanks to the work of many developers. For a listing of the authors, please see the file
of the authors, please see the file .I AUTHORS
.B AUTHORS
in the top-level directory of the source distribution. in the top-level directory of the source distribution.
.SH COPYRIGHT .SH COPYRIGHT
.B wine Wine can be distributed under the terms of the LGPL license. A copy of the
can be distributed under the terms of the LGPL license. A copy of the
license is in the file license is in the file
.B COPYING.LIB .I COPYING.LIB
in the top-level directory of the source distribution. in the top-level directory of the source distribution.
.SH BUGS .SH BUGS
.PP .PP