From 0ff60a08dd167bc4bd991d7fb41e4cf6f348fb1a Mon Sep 17 00:00:00 2001 From: James Juran Date: Mon, 26 Apr 1999 14:57:06 +0000 Subject: [PATCH] Update to reflect recent changes and discussions. --- README | 37 ++++++++++++++++++++++++------------- documentation/wine.man | 31 +++++++++++++++++-------------- 2 files changed, 41 insertions(+), 27 deletions(-) diff --git a/README b/README index db8c956e007..47092114426 100644 --- a/README +++ b/README @@ -2,7 +2,7 @@ Wine is a program which allows running Microsoft Windows programs (including DOS, Windows 3.x and Win32 executables) on Unix. It -consists of a program loader which loads and executes an Microsoft +consists of a program loader which loads and executes a Microsoft Windows binary, and a library that implements Windows API calls using their Unix or X11 equivalents. The library may also be used for porting Win32 code into native Unix executables. @@ -12,22 +12,30 @@ is BSD style. Basically, you can do anything with it except claim that you wrote it. -2. COMPILATION +2. REQUIREMENTS -To compile and run Wine, you must have one of: +To compile and run Wine, you must have one of the following: Linux version 2.0.36 or above FreeBSD-current or FreeBSD 3.0 or later Solaris x86 2.5 or later -You also need to have libXpm installed on your system. The sources for -it are probably available on the ftp site where you got Wine. They can -also be found on ftp.x.org and all its mirror sites. If you are using -RedHat, install the xpm and xpm-devel packages. +Although Linux version 2.0.x will mostly work, certain features +(specifically LDT sharing) required for properly supporting Win32 +threads were not implemented until kernel version 2.2. If you get +consistent thread-related crashes, you may want to upgrade to 2.2. -On x86 Systems gcc >= 2.7.2 is required. You also need flex and yacc. -Bison will work as a replacement for yacc. If you are using RedHat, -install the flex and bison packages. +You also need to have libXpm installed on your system. The sources for +it are probably available on the FTP site where you got Wine. They can +also be found on ftp.x.org and all its mirror sites. If you are using +RedHat, install the xpm and xpm-devel packages. Debian users need +xpm4.7, xpm4g, and xpm4g-dev 3.4j. + +On x86 Systems gcc >= 2.7.2 is required. You also need flex version 2.5 +or later and yacc. Bison will work as a replacement for yacc. If you are +using RedHat, install the flex and bison packages. + +3. COMPILATION To build Wine, first run "./configure" and then run "make depend; make". This will build the library "libwine.a" and the program "wine". @@ -49,7 +57,7 @@ Wine-yymmdd.diff.gz). You can then re-run "./configure", and then run "make depend; make". -3. SETUP +4. SETUP Once Wine has been built correctly, you can do "make install"; this will install the wine executable, the Wine man page, and a few other @@ -66,7 +74,7 @@ and copied to one of the two locations mentioned above. See www.winehq.com/config.html for further configuration hints. -4. RUNNING PROGRAMS +5. RUNNING PROGRAMS When invoking Wine, you may specify the entire path to the executable, or a filename only. @@ -90,7 +98,7 @@ If you post a bug report, please read the file documentation/bugreports to see what information is required. -5. GETTING MORE INFORMATION +6. GETTING MORE INFORMATION FAQ: The Wine FAQ is located at http://www.winehq.com/faq.html. @@ -99,6 +107,9 @@ WWW: A great deal of information about Wine is available from WineHQ at are available on the wine-patches mailing list; see http://www.winehq.com/dev.html#ml for more information. +HOWTO: A pre-release version of the Wine HOWTO is available at + http://www.westfalen.de/witch/wine-HOWTO.txt . + Usenet: Please browse old messages on http://www.dejanews.com/ to check whether your problem is already fixed before posting a bug report to the newsgroup. diff --git a/documentation/wine.man b/documentation/wine.man index e5af0f888c5..89c710fa4b5 100644 --- a/documentation/wine.man +++ b/documentation/wine.man @@ -1,5 +1,5 @@ .\" -*- nroff -*- -.TH WINE 1 "February 3, 1999" "Version 990131" "Windows On Unix" +.TH WINE 1 "April 26, 1999" "Version 990328" "Windows On Unix" .SH NAME wine \- run Windows programs on Unix .SH SYNOPSIS @@ -21,22 +21,25 @@ Win95. Older, simpler applications work better than newer, more complex ones. A large percentage of the API has been implemented, although there are still several major pieces of work left to do. .SH REQUIREMENTS -At present, .B wine -will run under any Linux kernel more recent than 0.99.13, or -under recent releases of NetBSD/i386, FreeBSD and OpenBSD/i386. Some bugs -were fixed and additional features were added late in the Linux 2.0.x -series, so if you have an old Linux kernel, you may want to upgrade to the -latest 2.0.x release. If you have FreeBSD, make sure you have the USER_LDT, +requires kernel-level threads to run. Currently, only Linux version 2.0 +or later, FreeBSD-current or FreeBSD 3.0 or later, and Solaris x86 +version 2.5 or later are supported. Other operating systems which support +kernel threads may be supported in the future. +.PP +Although Linux version 2.0 will mostly work, certain features (specifically +LDT sharing) required for properly supporting Win32 threads were not +implemented until kernel version 2.2. If you get consistent thread-related +crashes, you may want to upgrade to 2.2. Also, some bugs were fixed and +additional features were added late in the Linux 2.0.x series, so if you have +a very old Linux kernel, you may want to upgrade to at least the latest 2.0.x +release. +.PP +If you have FreeBSD, make sure you have the USER_LDT, SYSVSHM, SYSVSEM, and SYSVMSG options turned on in your kernel. If you are building Wine on Solaris, you will most likely need to build Wine with the GNU toolchain (gcc, gas, etc.) .PP -The current support for multithreaded applications relies on the -.BR clone (2) -system call, which is currently only available on Linux. It should be -possible to implement this for other operating systems, however. -.PP .B X must be installed. To use Wine's support for multithreaded applications, your X libraries must be reentrant. If you have libc6 (glibc2), or you @@ -54,7 +57,7 @@ BUGS section to get it included in this man page. .PP .B gcc -2.7.x or later is required to build +2.7.2 or later is required to build .B wine. Versions earlier than 2.7.2.3 may have problems when certain files are compiled with optimization. @@ -63,7 +66,7 @@ pgcc currently doesn't work with wine. The cause of this problem is unknown. .PP .B flex -and +version 2.5 or later and .B yacc are required. Bison can be used in replace of yacc. If you have Redhat, make sure the bison and flex packages are installed.