summaryrefslogtreecommitdiff
path: root/INSTALL
diff options
context:
space:
mode:
authorBehdad Esfahbod <behdad@behdad.org>2008-09-16 19:44:49 -0400
committerBehdad Esfahbod <behdad@behdad.org>2008-09-16 19:45:03 -0400
commita5a18dbf610ef6562d7ee9d6d927d89af6839c60 (patch)
treeebdb6ed4e264f0b7dfc58b576bb664b1d5c59cee /INSTALL
parentff9a2af19e406807b3a962b930ec66b22a6a5974 (diff)
downloadcairo-a5a18dbf610ef6562d7ee9d6d927d89af6839c60.tar.gz
[INSTALL] Update
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL67
1 files changed, 34 insertions, 33 deletions
diff --git a/INSTALL b/INSTALL
index 9c5d14504..1ee0f48e8 100644
--- a/INSTALL
+++ b/INSTALL
@@ -66,34 +66,33 @@ More detailed build instructions
(NOTE: On Mac OS X, at least, use DYLD_LIBRARY_PATH in place
of LD_LIBRARY_PATH above.)
- --enable-quartz
- --enable-atsui
- --enable-xcb
- --enable-glitz
- --enable-beos
- --enable-os2
- --enable-directfb
-
- Some of cairo's backends are marked as experimental and will
- not be built by default. If you would like to build and
- experiment with these backends, you will need to pass one of
- the above options to the configure script. You may need to
- have certain libraries installed first as discussed in the
- dependencies section of the README file.
-
- --disable-xlib
- --disable-win32
- --disable-png
- --disable-freetype
- --disable-ps
- --disable-pdf
- --disable-svg
-
- Cairo's configure script detects the libraries needed to build
- each stable backend, and when it finds them, enables each
- backend. If you would like to override this detection and
- disable a backend, (even when it would be possible to build
- it), use one of the options above to disable the backend.
+ --enable-XYZ
+ --enable-XYZ=yes
+ --enable-XYZ=auto
+ --enable-XYZ=no
+ --disable-XYZ
+
+ Cairo's various font and surface backends and other features can be
+ enabled or disabled at configure time. Features can be divided into
+ three categories based on their default state:
+
+ * default=yes: These are the recommended features like PNG functions
+ and PS/PDF/SVG backends. It is highly recommended to not disable
+ these features but if that's really what one wants, they can be
+ disabled using --disable-XYZ.
+
+ * default=auto: These are the "native" features, that is, they are
+ platform specific, like the Xlib surface backend. You probably
+ want one or two of these. They will be automatically enabled if
+ all their required facilities are available. Or you can use
+ --enable-XYZ or --disable-XYZ to make your desire clear, and then
+ cairo errs during configure if your intention cannot be followed.
+
+ * default=no: These are the "experimental" features, and hence by
+ default off. Use --enabled-XYZ to enable them.
+
+ The list of all features and their default state can be seen in the
+ output of ./configure --help.
2) Compile the package:
@@ -156,16 +155,18 @@ contributions to cairo. Since you're not using a packaged tar file,
you're going to need some additional tools beyond just a C compiler in
order to compile cairo. Specifically, you need the following utilities:
- automake (1.8 or newer)
+ automake
autoconf
- libtool
+ autoheader
+ aclocal
+ libtoolize
+ gtk-doc (recommended)
Hopefully your platform of choice has packages readily available so
that you can easily install things with your system's package
management tool, (such as "apt-get install automake" on Debian or "yum
-install automake" on Fedora, etc.). Note that Mac OS X ships with it's
-own utility called libtool which is not what you want, (the one you do
-want goes by the name of glibtool).
+install automake" on Fedora, etc.). Note that Mac OS X ships with
+glibtoolize instead of libtoolize.
Once you have all of those packages installed, the next step is to run
the autogen.sh script. That can be as simple as: