Ref count increment/decrement cleanup.
[wine] / documentation / compiling.sgml
1   <chapter id="compiling">
2     <title>Compiling the Wine Source</title>
3
4     <para>How to compile wine, and problems that may arise...</para>
5
6     <para>
7       In case you downloaded Wine source code files, this chapter will
8       tell you how to compile it into binary files before installing them.
9       Otherwise, please proceed directly to the <link
10       linkend="installing">Installation chapter</link> to install the
11       binary Wine files.
12     </para>
13
14     <sect1 id="compiling-wine">
15       <title>Compiling Wine</title>
16
17       <sect2>
18         <title>Requirements</title>
19         <para>
20           For an up-to-date list of software requirements for compiling
21           Wine and instructions how to actually do it, please see the <ulink
22           url="http://www.winehq.org/source/README">README</ulink> file,
23           which is also available in the main directory of a Wine source
24           code tree.
25         </para>
26       </sect2>
27
28       <sect2>
29         <title>Space required</title>
30         <para>
31           You also need about 400 MB of available disk space for compilation.
32           The compiled libwine.so binary takes around 5 MB of disk space,
33           which can be reduced to about 1 MB by stripping ('strip wine').
34           Stripping is not recommended, however, as you can't submit
35           proper crash reports with a stripped binary.
36         </para>
37       </sect2>
38       
39       <sect2>
40         <title>Common problems</title>
41         <para>
42           If you get a repeatable sig11 compiling shellord.c, thunk.c
43           or other files, try compiling just that file without optimization
44           (removing the -Ox option from the GCC command in the
45           corresponding Makefile).
46         </para>
47       </sect2>
48     </sect1>
49   </chapter>
50
51 <!-- Keep this comment at the end of the file
52 Local variables:
53 mode: sgml
54 sgml-parent-document:("wine-user.sgml" "set" "book" "part" "chapter" "")
55 End:
56 -->