Fixed corruption when copying to the same surface (with the help of
[wine] / documentation / compiling.sgml
1   <chapter id="compiling">
2     <title>Compiling Wine</title>
3     <para>How to compile wine, and problems that may arise...</para>
4
5     <sect1 id="compiling-wine">
6       <title>Compiling Wine</title>
7
8       <sect2>
9         <title>Tools required</title>
10         <para>
11           <itemizedlist>
12             <listitem>
13               <para>
14                 gcc -- 2.7.x required (Wine uses attribute stdcall).
15                 Versions earlier than 2.7.2.3 barf on shellord.c
16                 -- compile without optimizing for that file.
17                 In addition EGCS 1.1.x and GCC 2.95.x are reported
18                 to work fine.
19               </para>
20             </listitem>
21             <listitem>
22               <para>
23                 flex >= 2.5.1 (required for the debugger and wrc,
24                 and lex won't do)
25               </para>
26             </listitem>
27             <listitem>
28               <para>
29                 bison (also required for debugger. Don't know whether BSD yacc
30                 would work.)
31               </para>
32             </listitem>
33             <listitem>
34               <para>
35                 X11 libs and include files
36               </para>
37             </listitem>
38             <listitem>
39               <para>
40                 texinfo >= 3.11 (optional, to compile the documentation.)
41               </para>
42             </listitem>
43             <listitem>
44               <para>
45                 autoconf (if you want to remake configure, which is
46                 not normally required)
47               </para>
48             </listitem>
49             <listitem>
50               <para>
51                 XF86DGA extension (optional, detected by configure,
52                 needed for DirectX support)
53               </para>
54             </listitem>
55             <listitem>
56               <para>
57                 Open Sound System (optional, detected by configure,
58                 for sound support)
59               </para>
60             </listitem>
61           </itemizedlist>
62         </para>
63         <para>
64           The Red Hat RPMs are gcc-XXX, flex-XXX, and
65           XFree86-devel-XXX, where XXX is the version number.
66         </para>
67       </sect2>
68
69       <sect2>
70         <title>Space required</title>
71         <para>
72           You also need about 230 MB of available disk space for compilation.
73           The compiled libwine.so binary takes around 5 MB of disk space,
74           which can be reduced to about 1 MB by stripping ('strip wine').
75           Stripping is not recommended, however, as you can't submit
76           proper crash reports with a stripped binary any more.
77         </para>
78       </sect2>
79       
80       <sect2>
81         <title>Common problems</title>
82         <para>
83           If you get a repeatable sig11 compiling shellord.c, thunk.c
84           or other files, try compiling just that file without optimization.
85           Then you should be able to finish the build.
86         </para>
87       </sect2>
88
89       <sect2>
90         <title>OS specific issues</title>
91         <para>
92           <itemizedlist>
93             <listitem>
94               <para>
95                 FreeBSD -- In order to run Wine, the FreeBSD kernel
96                 needs to be compiled with
97
98                 <informaltable frame="all">
99                   <tgroup cols="2">
100                     <tbody>
101                       <row>
102                         <entry>options</entry>
103                         <entry>USER_LDT</entry>
104                       </row>
105                       <row>
106                         <entry>options</entry>
107                         <entry>SYSVSHM</entry>
108                       </row>
109                       <row>
110                         <entry>options</entry>
111                         <entry>SYSVSEM</entry>
112                       </row>
113                       <row>
114                         <entry>options</entry>
115                         <entry>SYSVMSG</entry>
116                       </row>
117                     </tbody>
118                   </tgroup>
119                 </informaltable>
120
121
122                 If you need help, read the chapter "<ulink url="http://www.freebsd.org/handbook/kernelconfig-building.html">Building and Installing a Custom Kernel</ulink>" in the "<ulink url="http://www.freebsd.org/handbook/">FreeBSD handbook</ulink>. You'll need to be running FreeBSD 3.x or later.
123               </para>
124             </listitem>
125             <listitem>
126               <para>
127                 SCO Unixware, Openserver -- UW port is supported by SCO.
128               </para>
129             </listitem>
130             <listitem>
131               <para>
132                 OS/2 -- not a complete port. See <ulink url="http://odin.netlabs.org/ProjectAbout.phtml">Odin</ulink> for a project which uses some Wine code.
133               </para>
134             </listitem>
135             <listitem>
136               <para>
137                 Solaris x86 2.x -- Needs GNU toolchain (gcc, gas, flex as above, yacc may work) to compile, seems functional (980215). 
138               </para>
139             </listitem>
140             <listitem>
141               <para>
142                 DGUX, HP, Irix, or other Unixes; non-intel Linux.
143                 No ports have been seriously attempted.
144                 For non-intel Unixes, only a winelib port is relevant.
145                 Alignment may be a problem.
146               </para>
147             </listitem>
148             <listitem>
149               <para>
150                 Macintosh/Rhapsody/BeOS -- no ports have been attempted.
151               </para>
152             </listitem>
153           </itemizedlist>
154         </para>
155       </sect2>
156     </sect1>
157   </chapter>
158
159 <!-- Keep this comment at the end of the file
160 Local variables:
161 mode: sgml
162 sgml-parent-document:("wine-doc.sgml" "set" "book" "part" "chapter" "")
163 End:
164 -->