diff --git a/documentation/compiling.sgml b/documentation/compiling.sgml index ae636f69b2d..6a2740fddbd 100644 --- a/documentation/compiling.sgml +++ b/documentation/compiling.sgml @@ -1,6 +1,6 @@ Getting and Compiling the Wine Source - How to obtain and compile wine, and problems that may arise... + How to obtain and compile Wine, and problems that may arise... Getting Wine Source @@ -24,7 +24,7 @@ and received a patch from a developer to hopefully fix the bug. We will show you how to safely apply the - patch and revert it if the patch doesn't work. + patch and revert it if it doesn't work. @@ -74,24 +74,24 @@ the latest one. - Once you have downloaded this, you must first compile wine, and then + Once you have downloaded this, you must first compile Wine, and then install it. This is not very hard to do. First switch to the directory containing the file you just downloaded. Then extract the source with (e.g.): -# tar xzvf wine-20021031.tar.gz +$ tar xzvf wine-20021031.tar.gz Then, switch to the directory that was created and compile it by typing (e.g.): -# ./tools/wineinstall +$ ./tools/wineinstall NOTE: You must make sure that you are not the superuser (root) when doing this, and that you have write permission to the directory that was created by the tar - command as well as all of its subdirectories and files.. + command as well as all of its subdirectories and files. @@ -107,7 +107,7 @@ First, you need to get a copy of the latest Wine sources using CVS. You can tell it where to find the source tree by setting the CVSROOT environment variable. You - also have to log in anonymously to the wine CVS server. In + also have to log in anonymously to the Wine CVS server. In bash, it might look something like this: $ export CVSROOT=:pserver:cvs@cvs.winehq.com:/home/wine @@ -124,7 +124,7 @@ Password: anywhere in the revision history. Later, you can grab just the updates: -$ cvs -PAd update +$ cvs update -PAd @@ -139,7 +139,7 @@ Password: After you've made changes, you can create a patch with cvs diff -u, which sends output to stdout (the -u controls the format of the - patch). So, to create an my_patch.diff + patch). So, to create a my_patch.diff file, you would do this: $ cvs diff -u >my_patch.diff @@ -148,7 +148,7 @@ Password: You can call cvs diff from anywhere in the tree (just like cvs update), and it will - always grab recursively from that point. You can also specify + diff recursively from that point. You can also specify single files or subdirectories: $ cvs diff -u dlls/winaspi >my_aspi_patch.diff @@ -209,11 +209,11 @@ Password: wine/programs/clock/main.c . Setting the -p1 option would strip off the first part of the file name and apply - the patch instead to programs/clock/main.c . + the patch to programs/clock/main.c . The -p1 option would be useful if you named - your top level wine directory differently to the person who sent you - the patch. For the -p1 option - patch should be run from the top level wine directory. + your top level Wine directory differently than the person who sent + you the patch. For the -p1 option + patch should be run from the top level Wine directory. @@ -227,7 +227,7 @@ Password: - gcc -- 2.7.x required (Wine uses attribute stdcall). + gcc >= 2.7.x required (Wine uses the stdcall attribute). Versions earlier than 2.7.2.3 barf on shellord.c -- compile without optimizing for that file. In addition EGCS 1.1.x and GCC 2.95.x are reported @@ -277,8 +277,9 @@ Password: - The Red Hat RPMs are gcc-XXX, flex-XXX, and - XFree86-devel-XXX, where XXX is the version number. + The Red Hat RPMs are gcc-XXX, + flex-XXX, and XFree86-devel-XXX, + where XXX is the version number. @@ -289,7 +290,7 @@ Password: The compiled libwine.so binary takes around 5 MB of disk space, which can be reduced to about 1 MB by stripping ('strip wine'). Stripping is not recommended, however, as you can't submit - proper crash reports with a stripped binary any more. + proper crash reports with a stripped binary. @@ -345,25 +346,33 @@ Password: - OS/2 -- not a complete port. See Odin for a project which uses some Wine code. + Solaris x86 2.x -- Needs the GNU toolchain (gcc, gas, flex as above, yacc may work) to compile, seems functional (980215). - Solaris x86 2.x -- Needs GNU toolchain (gcc, gas, flex as above, yacc may work) to compile, seems functional (980215). - - - - - DGUX, HP, Irix, or other Unixes; non-intel Linux. + DGUX, HP, Irix, or other Unixes; non-x86 Linux. No ports have been seriously attempted. - For non-intel Unixes, only a winelib port is relevant. + For non-x86 Unixes, only a Winelib port is relevant. Alignment may be a problem. - Macintosh/Rhapsody/BeOS -- no ports have been attempted. + OS/2 -- not a complete port. See Odin. Note that this + project uses some Wine code but is not based on Wine. + + + + + BeOS -- not a complete port. See BeWine. + + + + + Macintosh/Rhapsody -- no ports have been attempted.