diff --git a/documentation/wine.man.in b/documentation/wine.man.in index e1640c9b8e5..2265d7f9dfa 100644 --- a/documentation/wine.man.in +++ b/documentation/wine.man.in @@ -1,5 +1,5 @@ .\" -*- 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 wine \- run Windows programs on Unix .SH SYNOPSIS @@ -21,9 +21,12 @@ For debugging wine, use instead. .PP .B wine -currently runs a growing list of applications written for Win3.1, -Win95, Win98, and Windows NT. Older, simpler applications work better than -newer, more complex ones. A large percentage of the API has been implemented, +currently runs a growing list of applications written for all kinds of +Windows versions >= Win2.0, e.g. Win3.1, Win95/98, NT. +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. .SH REQUIREMENTS .B wine @@ -85,6 +88,7 @@ or Debian, make sure the bison and flex packages are installed. .SH INSTALLATION To install .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 detect your specific setup and create the Makefiles. You can run "./configure --help" to see the available configuration options. Then do @@ -122,12 +126,15 @@ component of .B wine. # is required and can be either + or -. Note that 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 the case as names used in the relaylisting. You can do the same for snoop. .PP For instance: .PP +.I --debugmsg warn+all +will turn on all warning messages (recommended for debugging) +.br .I --debugmsg warn+dll,+heap will turn on DLL warning messages and all heap messages. .br @@ -142,26 +149,29 @@ EnterCriticalSection. .I --debugmsg +relay=ADVAPI32 will only turn on relay messages into the ADVAPI32 code. .PP -The full list of names is: all, accel, advapi, animate, aspi, atom, avifile, bitblt, -bitmap, caret, cdrom, class, clipboard, clipping, combo, comboex, comm, commctrl, -commdlg, console, crtdll, cursor, datetime, dc, ddeml, ddraw, debug, debugstr, delayhlp, -dialog, dinput, dll, dosfs, dosmem, dplay, driver, dsound, edit, elfdll, enhmetafile, -event, exec, file, fixup, font, gdi, global, graphics, header, heap, hook, hotkey, -icmp, icon, imagehlp, imagelist, imm, int, int10, int16, int17, int19, int21, int31, -io, ipaddress, joystick, key, keyboard, ldt, listbox, listview, local, mci, mcianim, -mciavi, mcicda, mcimidi, mciwave, mdi, menu, message, metafile, midi, mmaux, mmio, -mmsys, mmtime, module, monthcal, mpr, msacm, msg, msvideo, nativefont, nonclientntdll, -odbc, ole, pager, palette, pidl, print, process, profile, progress, prop, propsheet, -psapi, psdrv, ras, rebar, reg, region, relay, resource, scroll, 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, +The full list of names is: +all, accel, advapi, animate, aspi, atom, avifile, bitblt, bitmap, caret, +cdrom, class, clipboard, clipping, combo, comboex, comm, commctrl, commdlg, +console, crtdll, cursor, datetime, dc, ddeml, ddraw, debug, debugstr, +delayhlp, dialog, dinput, dll, dosfs, dosmem, dplay, driver, dsound, edit, +elfdll, enhmetafile, event, exec, file, fixup, font, gdi, global, graphics, +header, heap, hook, hotkey, icmp, icon, imagehlp, imagelist, imm, int, int10, +int16, int17, int19, int21, int31, io, ipaddress, joystick, key, keyboard, +ldt, listbox, listview, local, mci, mcianim, mciavi, mcicda, mcimidi, +mciwave, mdi, menu, message, metafile, midi, mmaux, mmio, mmsys, mmtime, +module, monthcal, mpr, msacm, msg, msvideo, nativefont, nonclient, ntdll, +odbc, ole, pager, palette, pidl, print, process, profile, progress, prop, +propsheet, psapi, psdrv, ras, rebar, reg, region, relay, resource, scroll, +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. .PP For more information on debugging messages, see the file .I documentation/debug-msgs -in the source distribution. +in the source distribution (FIXME: outdated). .RE .TP .I --desktop geom @@ -189,7 +199,7 @@ internal dlls ( ). Each sequence of orders must be separated by commas. .br 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 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 @@ -249,22 +259,22 @@ The program name may be specified in DOS format ( C:\(rs\(rsWINDOWS\(rs\(rsSOL.EXE) or in Unix format ( .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 .B wine (such as: wine notepad C:\(rs\(rsTEMP\(rs\(rsREADME.TXT). Command line processing goes as follows: first .B wine -checks, if one or more of the above mentioned +checks whether one or more of the above mentioned .B wine options have been specified. These are removed from the command line, which is passed to the windows program. You can use -the Parameter +the parameter .I -- -to indicate, that +to indicate that .B wine -should stop command line processing. This is needed, if a windows program understands -a option, which is usually interpreted (and thus removed from the command line) +should stop command line processing. This is needed in case a windows program understands +an option that is usually interpreted (and thus removed from the command line) by .B wine. For example, if you want to execute @@ -288,10 +298,9 @@ you must not pass program name and program option in one argument to .B wine. To run more -that one windows program, just execute +than one windows program, just execute .B wine -once with the name -of each program as argument. +once with the name of each program as argument. .SH ENVIRONMENT VARIABLES .B wine 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 appropriate syntax for your shell to enter environment variables you need. .TP .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 stores its data (usually .I $HOME/.wine @@ -308,9 +317,10 @@ stores its data (usually .I wineserver. All .B wine -processes, using the same +processes using the same .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 to different values for different .B wine @@ -327,7 +337,7 @@ expects a configuration file ( man page. A sample configuration file is wine.ini in the base directory of the .B wine source archive. Alternatively a configuration file with the name -.I.winerc +.I .winerc in the home directory of the user running .B wine can be used. The third option is to specify the name of the @@ -342,7 +352,7 @@ of the authors, please see the file in the top-level directory of the source distribution. .SH BUGS .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. Please add entries to this list for applications you currently run. .PP @@ -352,15 +362,15 @@ If you want to post a bug report, please read the file .I documentation/bugreports in the .B wine -source to see what information is necessary. +source to see what information is necessary (FIXME: outdated). .PP For problems and suggestions with this manpage, please send a note to James Juran . .SH AVAILABILITY The most recent public version of .B wine -can be obtained via FTP from metalab.unc.edu or tsx-11.mit.edu in the -/pub/linux/ALPHA/Wine/development directory. The releases are in the +can be obtained via FTP from ibiblio.org 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 from the previous release. .PP @@ -384,8 +394,8 @@ It is used for discussion of various .B wine end user aspects/help. .PP For further information about -.B wine development, you might want to -subscribe to the +.B wine +development, you might want to subscribe to the .B wine "cvs", "devel" and "patches" mailing lists at .I http://www.winehq.com/dev.html#ml. @@ -412,7 +422,7 @@ clipboard server .TP .I @prefix@/lib/ Directory containing -.B wines's +.B wine's shared libraries .TP .I @sysconfdir@/wine.conf