summaryrefslogtreecommitdiff
path: root/docs/reference/gdk-pixbuf/compiling.sgml
blob: dc335ef6d1f5e4c1c71bfdbd763ef5aa6094299f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
  <appendix id="compiling">
    <title>Compiling the <application>gdk-pixbuf</application>
    library</title>

    <para>
      This appendix describes the special options you can use while
      compiling the <application>gdk-pixbuf</application> library.
    </para>

    <sect1 id="building">
      <title>Building the Library</title>
      <para>
	The <application>gdk-pixbuf</application> library uses the
	standard GNU build system, using
	<application>autoconf</application> for package configuration
	and resolving portability issues,
	<application>automake</application> for building makefiles
	that comply with the GNU Coding Standards, and
	<application>libtool</application> for building shared
	libraries on multiple platforms.  The normal sequence for
	compiling and installing the
	<application>gdk-pixbuf</application> library is thus:

	<literallayout>
	  <userinput>./configure</userinput>
	  <userinput>make</userinput>
	  <userinput>make install</userinput>
	</literallayout>
      </para>

      <para>
	The standard options provided by <application>GNU
	autoconf</application> may be passed to the
	<command>configure</command> script.  Please see the
	<application>autoconf</application> documentation or run
	<command>./configure --help</command> for information about
	the standard options.
      </para>
    </sect1>

    <sect1 id="extra-configuration-options">
      <title>Extra Configuration Options</title>

      <para>
	In addition to the normal options, the
	<command>configure</command> script in the
	<application>gdk-pixbuf</application> library supports these
	additional arguments:

	<cmdsynopsis>
	  <command>configure</command>

	  <group>
	    <arg>--disable-modules</arg>
	    <arg>--enable-modules</arg>
	  </group>

	  <group>
	    <arg>--disable-gtk-doc</arg>
	    <arg>--enable-gtk-doc</arg>
	  </group>
	</cmdsynopsis>
      </para>

      <formalpara>
	<title><systemitem>--disable-modules</systemitem> and
	  <systemitem>--enable-modules</systemitem></title>

	<para>
	  Normally <application>gdk-pixbuf</application> will try to
	  build the image file format loaders as little shared
	  libraries that are loaded on demand.  The
	  <systemitem>--disable-modules</systemitem> argument
	  indicates that they should all be built statically into the
	  <application>gdk-pixbuf</application> library instead.  This
	  is useful for people who need to produce statically-linked
	  binaries.  If neither
	  <systemitem>--disable-modules</systemitem> nor
	  <systemitem>--enable-modules</systemitem> is specified, then
	  the <command>configure</command> script will try to
	  auto-detect whether shared modules work on your system.
	</para>
      </formalpara>

      <formalpara>
	<title><systemitem>--disable-gtk-doc</systemitem> and
	  <systemitem>--enable-gtk-doc</systemitem></title>

	<para>
	  By default the <command>configure</command> script will try
	  to auto-detect whether the
	  <application>gtk-doc</application> package is installed.  If
	  it is, then it will use it to extract and build the
	  documentation for the <application>gdk-pixbuf</application>
	  library.  These options can be used to explicitly control
	  whether gtk-doc should be used or not.  If it is not used,
	  the distributed, pre-generated HTML files will be installed
	  instead of building them on your machine.
	</para>
      </formalpara>
    </sect1>
  </appendix>

<!--
Local variables:
mode: sgml
sgml-parent-document: ("gdk-pixbuf.sgml" "book" "book" "")
End:
-->