compiling.sgml 3.43 KB
Newer Older
Federico Mena Quintero's avatar
Federico Mena Quintero committed
1
  <appendix id="compiling">
2 3
    <title>Compiling the <application>gdk-pixbuf</application>
    library</title>
Federico Mena Quintero's avatar
Federico Mena Quintero committed
4 5 6

    <para>
      This appendix describes the special options you can use while
7
      compiling the <application>gdk-pixbuf</application> library.
Federico Mena Quintero's avatar
Federico Mena Quintero committed
8 9 10 11 12
    </para>

    <sect1 id="building">
      <title>Building the Library</title>
      <para>
13 14 15 16 17
	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
Federico Mena Quintero's avatar
Federico Mena Quintero committed
18
	that comply with the GNU Coding Standards, and
19
	<application>libtool</application> for building shared
Federico Mena Quintero's avatar
Federico Mena Quintero committed
20
	libraries on multiple platforms.  The normal sequence for
21 22
	compiling and installing the
	<application>gdk-pixbuf</application> library is thus:
Federico Mena Quintero's avatar
Federico Mena Quintero committed
23 24 25 26 27 28 29 30 31

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

      <para>
32 33
	The standard options provided by <application>GNU
	autoconf</application> may be passed to the
Federico Mena Quintero's avatar
Federico Mena Quintero committed
34
	<command>configure</command> script.  Please see the
35
	<application>autoconf</application> documentation or run
Federico Mena Quintero's avatar
Federico Mena Quintero committed
36 37 38 39 40 41 42 43 44 45
	<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
46 47 48
	<command>configure</command> script in the
	<application>gdk-pixbuf</application> library supports these
	additional arguments:
Federico Mena Quintero's avatar
Federico Mena Quintero committed
49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69

	<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>
70 71 72 73 74 75 76 77 78
	  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
Federico Mena Quintero's avatar
Federico Mena Quintero committed
79 80 81 82 83 84 85 86 87 88 89 90 91
	  <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
92
	  <application>gtk-doc</application> package is installed.  If
Federico Mena Quintero's avatar
Federico Mena Quintero committed
93
	  it is, then it will use it to extract and build the
94 95 96 97 98
	  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.
Federico Mena Quintero's avatar
Federico Mena Quintero committed
99 100 101 102 103 104 105 106 107 108 109
	</para>
      </formalpara>
    </sect1>
  </appendix>

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