From: Zachary Petzinger zepetzi@gmail.com
Convert README to Markdown and apply formatting enhancements --- readme.md | 179 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 179 insertions(+) create mode 100644 readme.md
diff --git a/readme.md b/readme.md new file mode 100644 index 00000000000..4087118c1d3 --- /dev/null +++ b/readme.md @@ -0,0 +1,179 @@ +# 1. Introduction + +Wine is a program which allows running Microsoft Windows programs (including DOS, Windows 3.x, Win32, and Win64 executables) on Unix. It consists of a program loader which loads and executes a Microsoft Windows binary, and a library (called Winelib) that implements Windows API calls using their Unix, X11 or Mac equivalents. The library may also be used for porting Windows code into native Unix executables. + +Wine is free software, released under the GNU LGPL; see the file LICENSE for the details. + +# 2. Quick Start + +From the top-level directory of the Wine source (which contains this file), run: + +``` +./configure +make +``` + +Then either install Wine: + +``` +make install +``` + +Or run Wine directly from the build directory: + +``` +./wine notepad +``` + +Run programs as ```wine program```. For more information and problem +resolution, read the rest of this file, the Wine man page, and +especially the wealth of information found at https://www.winehq.org. + + +# 3. Requirements + +**To compile and run Wine, you must have one of the following:** + + +| OS | Version | +| ------------- |:-------------:| +| Linux | 2.0.36 or later | +| FreeBSD | 12.4 or later | +| Solaris x86 | 9 or later | +| NetBSD | current | +| Mac OS X | 10.8 or later | + +As Wine requires kernel-level thread support to run, only the operating +systems mentioned above are supported. Other operating systems which +support kernel threads may be supported in the future. + +**FreeBSD info:** +See https://wiki.freebsd.org/Wine for more information. + + +**Solaris info:** +You will most likely need to build Wine with the GNU toolchain +(gcc, gas, etc.). Warning : installing gas does *not* ensure that it +will be used by gcc. Recompiling gcc after installing gas or +symlinking cc, as and ld to the gnu tools is said to be necessary. + + +**NetBSD info:** +Make sure you have the USER_LDT, SYSVSHM, SYSVSEM, and SYSVMSG options turned on in your kernel. + + + **Mac OS X info:** + You need Xcode/Xcode Command Line Tools or Apple cctools. The + minimum requirements for compiling Wine are clang 3.8 with the + MacOSX10.10.sdk and mingw-w64 v8. The MacOSX10.14.sdk and later can + only build wine64. + + +**Supported file systems:**<br> + Wine should run on most file systems. A few compatibility problems + have also been reported using files accessed through Samba. Also, + NTFS does not provide all the file system features needed by some + applications. Using a native Unix file system is recommended. + + +**Basic requirements:**<br> + You need to have the X11 development include files installed + (called xorg-dev in Debian and libX11-devel in Red Hat). + + Of course you also need "make" (most likely GNU make). + + You also need flex version 2.5.33 or later and bison. + + +**Optional support libraries:**<br> + Configure will display notices when optional libraries are not found + on your system. See https://wiki.winehq.org/Recommended_Packages for + hints about the packages you should install. On 64-bit platforms, + you have to make sure to install the 32-bit versions of these + libraries. + + +# 4. Compilation + +To build Wine, do: + +``` +./configure +make +``` + +This will build the program "wine" and numerous support libraries/binaries. +The program "wine" will load and run Windows executables. +The library "libwine" ("Winelib") can be used to compile and link +Windows source code under Unix. + +To see compile configuration options, do: + +``` +./configure --help. +``` + +For more information, see https://wiki.winehq.org/Building_Wine + + +# 5. Setup + +Once Wine has been built correctly, you can do: ```make install ```; this +will install the wine executable and libraries, the Wine man page, and +other needed files. + +Don't forget to uninstall any conflicting previous Wine installation +first. Try either ```dpkg -r wine``` or ```rpm -e wine``` or ```make uninstall``` +before installing. + +Once installed, you can run the ```winecfg``` configuration tool. See the +Support area at https://www.winehq.org/ for configuration hints. + + +# 6. Running Programs + +When invoking Wine, you may specify the entire path to the executable, +or a filename only. + +**For example, to run Notepad:** +``` + wine notepad (using the search Path as specified in + wine notepad.exe the registry to locate the file) + + wine c:\windows\notepad.exe (using DOS filename syntax) + + wine ~/.wine/drive_c/windows/notepad.exe (using Unix filename syntax) + + wine notepad.exe readme.txt (calling program with parameters) +``` + +Wine is not perfect, so some programs may crash. If that happens you +will get a crash log that you should attach to your report when filing +a bug. + + +# 7. Getting More Information + +**WWW**: A great deal of information about Wine is available from WineHQ at + https://www.winehq.org/ : various Wine Guides, application database, + bug tracking. This is probably the best starting point. + +**FAQ**: The Wine FAQ is located at https://www.winehq.org/FAQ + +**Wiki**: The Wine Wiki is located at https://wiki.winehq.org + +**Gitlab**: Wine development is hosted at https://gitlab.winehq.org + +**Mailing lists:** + There are several mailing lists for Wine users and developers; + see https://www.winehq.org/forums for more information. + +**Bugs:** Report bugs to Wine Bugzilla at https://bugs.winehq.org + Please search the bugzilla database to check whether your + problem is already known or fixed before posting a bug report. + +**IRC:** Online help is available at channel #WineHQ on irc.libera.chat. + +-- +Alexandre Julliard +julliard@winehq.org