Commit ff96f919 authored by Andreas Mohr's avatar Andreas Mohr Committed by Alexandre Julliard

Updated man page.

parent 8310aab3
.\" -*- nroff -*- .\" -*- nroff -*-
.TH WINE 1 "July 16, 1999" "Version 20000326" "Windows On Unix" .TH WINE 1 "Nov 27, 2000" "Version 20001026" "Windows On Unix"
.SH NAME .SH NAME
wine \- run Windows programs on Unix wine \- run Windows programs on Unix
.SH SYNOPSIS .SH SYNOPSIS
...@@ -21,9 +21,12 @@ For debugging wine, use ...@@ -21,9 +21,12 @@ For debugging wine, use
instead. instead.
.PP .PP
.B wine .B wine
currently runs a growing list of applications written for Win3.1, currently runs a growing list of applications written for all kinds of
Win95, Win98, and Windows NT. Older, simpler applications work better than Windows versions >= Win2.0, e.g. Win3.1, Win95/98, NT.
newer, more complex ones. A large percentage of the API has been implemented, Older, simpler applications work better than newer, more complex ones.
Using Windows ME or Win2000 components with Wine is more problematic than
using none at all or the ones from older Windows versions.
A large percentage of the API has been implemented,
although there are still several major pieces of work left to do. although there are still several major pieces of work left to do.
.SH REQUIREMENTS .SH REQUIREMENTS
.B wine .B wine
...@@ -85,6 +88,7 @@ or Debian, make sure the bison and flex packages are installed. ...@@ -85,6 +88,7 @@ or Debian, make sure the bison and flex packages are installed.
.SH INSTALLATION .SH INSTALLATION
To install To install
.B wine, .B wine,
run either "tools/wineinstall" (recommended), or do it the hard way:
run "./configure" in the top-level directory of the source, which will run "./configure" in the top-level directory of the source, which will
detect your specific setup and create the Makefiles. You can run detect your specific setup and create the Makefiles. You can run
"./configure --help" to see the available configuration options. Then do "./configure --help" to see the available configuration options. Then do
...@@ -122,12 +126,15 @@ component of ...@@ -122,12 +126,15 @@ component of
.B wine. .B wine.
# is required and can be either + or -. Note that # is required and can be either + or -. Note that
there is not a space after the comma between names. yyy are either the there is not a space after the comma between names. yyy are either the
name of a whole DLL or a single API entry by Name you either name of a whole DLL or a single API entry by name you either
want to include or exclude from the relay listing. These names must be in want to include or exclude from the relay listing. These names must be in
the case as names used in the relaylisting. You can do the same for snoop. the case as names used in the relaylisting. You can do the same for snoop.
.PP .PP
For instance: For instance:
.PP .PP
.I --debugmsg warn+all
will turn on all warning messages (recommended for debugging)
.br
.I --debugmsg warn+dll,+heap .I --debugmsg warn+dll,+heap
will turn on DLL warning messages and all heap messages. will turn on DLL warning messages and all heap messages.
.br .br
...@@ -142,26 +149,29 @@ EnterCriticalSection. ...@@ -142,26 +149,29 @@ EnterCriticalSection.
.I --debugmsg +relay=ADVAPI32 .I --debugmsg +relay=ADVAPI32
will only turn on relay messages into the ADVAPI32 code. will only turn on relay messages into the ADVAPI32 code.
.PP .PP
The full list of names is: all, accel, advapi, animate, aspi, atom, avifile, bitblt, The full list of names is:
bitmap, caret, cdrom, class, clipboard, clipping, combo, comboex, comm, commctrl, all, accel, advapi, animate, aspi, atom, avifile, bitblt, bitmap, caret,
commdlg, console, crtdll, cursor, datetime, dc, ddeml, ddraw, debug, debugstr, delayhlp, cdrom, class, clipboard, clipping, combo, comboex, comm, commctrl, commdlg,
dialog, dinput, dll, dosfs, dosmem, dplay, driver, dsound, edit, elfdll, enhmetafile, console, crtdll, cursor, datetime, dc, ddeml, ddraw, debug, debugstr,
event, exec, file, fixup, font, gdi, global, graphics, header, heap, hook, hotkey, delayhlp, dialog, dinput, dll, dosfs, dosmem, dplay, driver, dsound, edit,
icmp, icon, imagehlp, imagelist, imm, int, int10, int16, int17, int19, int21, int31, elfdll, enhmetafile, event, exec, file, fixup, font, gdi, global, graphics,
io, ipaddress, joystick, key, keyboard, ldt, listbox, listview, local, mci, mcianim, header, heap, hook, hotkey, icmp, icon, imagehlp, imagelist, imm, int, int10,
mciavi, mcicda, mcimidi, mciwave, mdi, menu, message, metafile, midi, mmaux, mmio, int16, int17, int19, int21, int31, io, ipaddress, joystick, key, keyboard,
mmsys, mmtime, module, monthcal, mpr, msacm, msg, msvideo, nativefont, nonclientntdll, ldt, listbox, listview, local, mci, mcianim, mciavi, mcicda, mcimidi,
odbc, ole, pager, palette, pidl, print, process, profile, progress, prop, propsheet, mciwave, mdi, menu, message, metafile, midi, mmaux, mmio, mmsys, mmtime,
psapi, psdrv, ras, rebar, reg, region, relay, resource, scroll, segment, seh, selector, module, monthcal, mpr, msacm, msg, msvideo, nativefont, nonclient, ntdll,
sendmsg, server, setupx, shell, snoop, sound, static, statusbar, storage, stress, string, odbc, ole, pager, palette, pidl, print, process, profile, progress, prop,
syscolor, system, tab, tape, tapi, task, text, thread, thunk, timer, toolbar, toolhelp, propsheet, psapi, psdrv, ras, rebar, reg, region, relay, resource, scroll,
tooltips, trackbar, treeview, ttydrv, tweak, typelib, updown, ver, virtual, vxd, wave, segment, seh, selector, sendmsg, server, setupx, shell, snoop, sound,
static, statusbar, storage, stress, string, syscolor, system, tab, tape,
tapi, task, text, thread, thunk, timer, toolbar, toolhelp, tooltips,
trackbar, treeview, ttydrv, tweak, typelib, updown, ver, virtual, vxd, wave,
win, win16drv, win32, winedbg, wing, winsock, winspool, wnet, x11 and x11drv. win, win16drv, win32, winedbg, wing, winsock, winspool, wnet, x11 and x11drv.
.PP .PP
For more information on debugging messages, see the file For more information on debugging messages, see the file
.I documentation/debug-msgs .I documentation/debug-msgs
in the source distribution. in the source distribution (FIXME: outdated).
.RE .RE
.TP .TP
.I --desktop geom .I --desktop geom
...@@ -189,7 +199,7 @@ internal dlls ( ...@@ -189,7 +199,7 @@ internal dlls (
). Each sequence of orders must be separated by commas. ). Each sequence of orders must be separated by commas.
.br .br
Each dll may have its own specific load order. The load order determines Each dll may have its own specific load order. The load order determines
which verion of the dll is attempted to be loaded into the address space. If which version of the dll is attempted to be loaded into the address space. If
the first fails, then the next is tried and so on. Different load orders can the first fails, then the next is tried and so on. Different load orders can
be specified by separating the entries with a plus sign. Multiple libraries be specified by separating the entries with a plus sign. Multiple libraries
with the same load order can be separated with commas. It is also possible to with the same load order can be separated with commas. It is also possible to
...@@ -249,22 +259,22 @@ The program name may be specified in DOS format ( ...@@ -249,22 +259,22 @@ The program name may be specified in DOS format (
C:\(rs\(rsWINDOWS\(rs\(rsSOL.EXE) C:\(rs\(rsWINDOWS\(rs\(rsSOL.EXE)
or in Unix format ( or in Unix format (
.I /msdos/windows/sol.exe .I /msdos/windows/sol.exe
). The program being executed may be passed arguments by adding them on ). You may pass arguments to the program being executed by adding them
to the end of the command line invoking to the end of the command line invoking
.B wine .B wine
(such as: wine notepad C:\(rs\(rsTEMP\(rs\(rsREADME.TXT). Command line processing goes as (such as: wine notepad C:\(rs\(rsTEMP\(rs\(rsREADME.TXT). Command line processing goes as
follows: first follows: first
.B wine .B wine
checks, if one or more of the above mentioned checks whether one or more of the above mentioned
.B wine .B wine
options have been specified. These options have been specified. These
are removed from the command line, which is passed to the windows program. You can use are removed from the command line, which is passed to the windows program. You can use
the Parameter the parameter
.I -- .I --
to indicate, that to indicate that
.B wine .B wine
should stop command line processing. This is needed, if a windows program understands should stop command line processing. This is needed in case a windows program understands
a option, which is usually interpreted (and thus removed from the command line) an option that is usually interpreted (and thus removed from the command line)
by by
.B wine. .B wine.
For example, if you want to execute For example, if you want to execute
...@@ -288,10 +298,9 @@ you must not pass ...@@ -288,10 +298,9 @@ you must not pass
program name and program option in one argument to program name and program option in one argument to
.B wine. .B wine.
To run more To run more
that one windows program, just execute than one windows program, just execute
.B wine .B wine
once with the name once with the name of each program as argument.
of each program as argument.
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
.B wine .B wine
makes the environment variables of the shell from which makes the environment variables of the shell from which
...@@ -300,7 +309,7 @@ is started accessible to the windows/dos processes started. So use the ...@@ -300,7 +309,7 @@ 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 .I WINEPREFIX
If set, the content of this variable is taken as the name of the directory, where If set, the content of this variable is taken as the name of the directory where
.B wine .B wine
stores its data (usually stores its data (usually
.I $HOME/.wine .I $HOME/.wine
...@@ -308,9 +317,10 @@ stores its data (usually ...@@ -308,9 +317,10 @@ stores its data (usually
.I wineserver. .I wineserver.
All All
.B wine .B wine
processes, using the same processes using the same
.B wineserver .B wineserver
share certain things like registry and shared memory. By setting (i.e.: same user) share certain things like registry and shared memory.
By setting
.I WINEPREFIX .I WINEPREFIX
to different values for different to different values for different
.B wine .B wine
...@@ -327,7 +337,7 @@ expects a configuration file ( ...@@ -327,7 +337,7 @@ expects a configuration file (
man page. A sample configuration file is wine.ini in the base directory of the man page. A sample configuration file is wine.ini in the base directory of the
.B wine .B wine
source archive. Alternatively a configuration file with the name source archive. Alternatively a configuration file with the name
.I.winerc .I .winerc
in the home directory of the user running in the home directory of the user running
.B wine .B wine
can be used. The third option is to specify the name of the can be used. The third option is to specify the name of the
...@@ -342,7 +352,7 @@ of the authors, please see the file ...@@ -342,7 +352,7 @@ of the authors, please see the file
in the top-level directory of the source distribution. in the top-level directory of the source distribution.
.SH BUGS .SH BUGS
.PP .PP
A status report on many appplications is available from A status report on many applications is available from
.I http://www.winehq.com/Apps. .I http://www.winehq.com/Apps.
Please add entries to this list for applications you currently run. Please add entries to this list for applications you currently run.
.PP .PP
...@@ -352,15 +362,15 @@ If you want to post a bug report, please read the file ...@@ -352,15 +362,15 @@ If you want to post a bug report, please read the file
.I documentation/bugreports .I documentation/bugreports
in the in the
.B wine .B wine
source to see what information is necessary. source to see what information is necessary (FIXME: outdated).
.PP .PP
For problems and suggestions with this manpage, please send a note to For problems and suggestions with this manpage, please send a note to
James Juran <jrj120@psu.edu>. James Juran <jrj120@psu.edu>.
.SH AVAILABILITY .SH AVAILABILITY
The most recent public version of The most recent public version of
.B wine .B wine
can be obtained via FTP from metalab.unc.edu or tsx-11.mit.edu in the can be obtained via FTP from ibiblio.org in the
/pub/linux/ALPHA/Wine/development directory. The releases are in the /pub/Linux/ALPHA/Wine/development directory. The releases are in the
format 'Wine-yyyymmdd.tar.gz', or 'Wine-yyyymmdd.diff.gz' for the diff's format 'Wine-yyyymmdd.tar.gz', or 'Wine-yyyymmdd.diff.gz' for the diff's
from the previous release. from the previous release.
.PP .PP
...@@ -384,8 +394,8 @@ It is used for discussion of various ...@@ -384,8 +394,8 @@ It is used for discussion of various
.B wine end user aspects/help. .B wine end user aspects/help.
.PP .PP
For further information about For further information about
.B wine development, you might want to .B wine
subscribe to the development, you might want to subscribe to the
.B wine .B wine
"cvs", "devel" and "patches" mailing lists at "cvs", "devel" and "patches" mailing lists at
.I http://www.winehq.com/dev.html#ml. .I http://www.winehq.com/dev.html#ml.
...@@ -412,7 +422,7 @@ clipboard server ...@@ -412,7 +422,7 @@ clipboard server
.TP .TP
.I @prefix@/lib/ .I @prefix@/lib/
Directory containing Directory containing
.B wines's .B wine's
shared libraries shared libraries
.TP .TP
.I @sysconfdir@/wine.conf .I @sysconfdir@/wine.conf
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment