prepare for the release of rrdtool-1.2.16

[rrdtool.git] / doc / rrdbuild.pod

diff --git a/doc/rrdbuild.pod b/doc/rrdbuild.pod
index df3bcd6..f52076e 100644 (file)
--- a/doc/rrdbuild.pod
+++ b/doc/rrdbuild.pod
@@ -35,12 +35,15 @@ Once you have decided. Save the two locations into environment variables.
 Depending on the shell you are using, you can do either (bash,zsh):
 
  BUILD_DIR=/tmp/rrdbuild
- INSTALL_DIR=/usr/local/rrdtool-1.2.13
+ INSTALL_DIR=/usr/local/rrdtool-1.2.16
 
 Or if you run tcsh:
 
  set BUILD_DIR=/tmp/rrdbuild
- set INSTALL_DIR=/usr/local/rrdtool-1.2.13
+ set INSTALL_DIR=/usr/local/rrdtool-1.2.16
+
+If your F</tmp> is mounted with the option noexec (RHEL seems todo that) you have to choose
+a different directory!
 
 Now make sure the BUILD_DIR exists and go there:
 
@@ -52,9 +55,9 @@ pre-installed. Note that these instructions assume that your copies of
 B<tar> and B<make> are actually B<GNU tar> and B<GNU make> respectively. It
 could be that they are installed as B<gtar> and B<gmake> on your system.
 
- wget http://oss.oetiker.ch/rrdtool/pub/rrdtool-1.2.13.tar.gz
- tar zxf rrdtool-1.2.13.tar.gz
- cd rrdtool-1.2.13
+ wget http://oss.oetiker.ch/rrdtool/pub/rrdtool-1.2.16.tar.gz
+ tar zxf rrdtool-1.2.16.tar.gz
+ cd rrdtool-1.2.16
  ./configure --prefix=$INSTALL_DIR && make && make install
 
 Ok, this was very optimistic. This try will probably have ended with
@@ -67,19 +70,43 @@ board, just re-run the last line of the instructions above.
 But again this may have been too optimistic, and you actually have to
 compile your own copies of the required libraries.
 
+=head3 Build Tipps for AIX
+
 If you are woking with AIX, you may find the the B<--disable-shared> option
 will cause things to break for you. In that case you may have to install the
 shared libraries into the rrdtool PREFIX and work with B<--disable-static>
-instead. (Better instructions for AIX welcome!)
+instead.
+
+Another hint to get rrdtool working on AIX is to use the IBM XL C Compiler:
+
+ export CC=/usr/vac/bin/cc
+ export PERLCC=$CC
+
+(Better instructions for AIX welcome!)
+
+=head2 Building Libraries
+
+In order to build the libraries you need a compiler on your system.
+Unfortunately compilers are not all alike. This has an effect on the CFLAGS
+you want to set. The examples below are for the popular GCC compiler suite.
+If you have an other compile you have to use the following settings:
 
 =over
 
+=item Sun Forte
+
+ CFLAGS="-xO3 -kPIC"
+
+=back
+
+=over 
+
 =item Building zlib
 
  cd $BUILD_DIR
  wget http://oss.oetiker.ch/rrdtool/pub/libs/zlib-1.2.3.tar.gz
  tar  zxf zlib-1.2.3.tar.gz
- cd zlib-1.2.2
+ cd zlib-1.2.3
  env CFLAGS="-O3 -fPIC" ./configure --prefix=$BUILD_DIR/lb
  make
  make install
@@ -92,7 +119,7 @@ drop the settings of LDFLAGS and CPPFLAGS. Note that the backslash (\) at
 the end of line 4 means that line 4 and line 5 are on one line.
 
  cd $BUILD_DIR
- wget http://oss.oetiker.ch/rrdtool/pub/libs/libpng-1.2.8-config.tar.gz
+ wget http://oss.oetiker.ch/rrdtool/pub/libs/libpng-1.2.10.tar.gz
  tar zxvf libpng-1.2.10.tar.gz
  cd libpng-1.2.10
  env CPPFLAGS="-I$BUILD_DIR/lb/include" LDFLAGS="-L$BUILD_DIR/lb/lib" CFLAGS="-O3 -fPIC" \
@@ -158,7 +185,7 @@ because it seems that a fair number of people have ill configured python and
 tcl setups that would prevent rrdtool from building if they are included in
 their current state.
 
- cd $BUILD_DIR/rrdtool-1.2.13
+ cd $BUILD_DIR/rrdtool-1.2.16
  ./configure --prefix=$INSTALL_DIR --disable-python --disable-tcl
  make clean
  make