summaryrefslogtreecommitdiff
path: root/INSTALL
diff options
context:
space:
mode:
authorCarl Worth <cworth@cworth.org>2008-02-28 17:08:40 -0800
committerCarl Worth <cworth@cworth.org>2008-02-28 17:08:40 -0800
commit6295c46569de13a96816ed8e30dcefd73af1eb18 (patch)
tree6e256af67e8952a89faf613619b5a7881156edee /INSTALL
parente7e4a03dd387d264226105dc29c8541f0528fd2c (diff)
INSTALL: Add notes on running autogen.sh if there is no configure script
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL71
1 files changed, 65 insertions, 6 deletions
diff --git a/INSTALL b/INSTALL
index 6a9858df..dfff8beb 100644
--- a/INSTALL
+++ b/INSTALL
@@ -22,13 +22,16 @@ anywhere it is mentioned in these instructions.
More detailed build instructions
--------------------------------
-
1) Configure the package
The first step in building cairo is to configure the package by
- running the configure script. The configure script attempts to
- automatically detect as much as possible about your system. So,
- you should primarily just accept its defaults by running:
+ running the configure script. [Note: if you don't have a configure
+ script, skip down below to the Extremely detailed build
+ instructions.]
+
+ The configure script attempts to automatically detect as much as
+ possible about your system. So, you should primarily just accept
+ its defaults by running:
./configure
@@ -60,7 +63,7 @@ More detailed build instructions
LD_LIBRARY_PATH=/opt/cairo/lib
export PKG_CONFIG_PATH LD_LIBRARY_PATH
- (NOTE: On mac OS X, at least, use DYLD_LIBRARY_PATH in place
+ (NOTE: On Mac OS X, at least, use DYLD_LIBRARY_PATH in place
of LD_LIBRARY_PATH above.)
--enable-quartz
@@ -122,7 +125,63 @@ More detailed build instructions
make install
If you are installing to a system-wide location you may need to
- temporarily acquite root access in order to perform this
+ temporarily acquire root access in order to perform this
operation. A good way to do this is to use the sudo program:
sudo make install
+
+Extremely detailed build instructions
+-------------------------------------
+So you want to build cairo but it didn't come with a configure
+script. This is probably because you have checked out the latest
+in-development code via git. If you need to be on the bleeding edge,
+(for example, because you're wanting to develop some aspect of cairo
+itself), then you're in the right place and should read on.
+
+However, if you don't need such a bleeding-edge version of cairo, then
+you might prefer to start by building the latest stable cairo release:
+
+ http://cairographics.org/releases
+
+or perhaps the latest (unstable) development snapshot:
+
+ http://cairographics.org/snapshots
+
+There you'll find nicely packaged tar files that include a configure
+script so you can go back the the simpler instructions above.
+
+But you're still reading, so you're someone that loves to
+learn. Excellent! We hope you'll learn enough to make some excellent
+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)
+ autoconf
+ libtool
+
+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).
+
+Once you have all of those packages installed, the next step is to run
+the autogen.sh script. That can be as simple as:
+
+ ./autogen.sh
+
+Or, if you're using Mac OS X, you'll have to let it know to use
+glibtool by instead doing:
+
+ LIBTOOLIZE=glibtoolize ./autogen.sh
+
+But before you run that command, note that the autogen.sh script
+accepts all the same arguments as the configure script, (and in fact,
+will generate the configure script and run it with the arguments you
+provide). So go back up to step (1) above and see what additional
+arguments you might want to pass, (such as prefix). Then continue with
+the instructions, simply using ./autogen.sh in place of ./configure.
+
+Happy hacking!