Imported upstream version 1.3.5.

[pkg-rrdtool.git] / doc / rrdbuild.1

diff --git a/doc/rrdbuild.1 b/doc/rrdbuild.1
index 80dae58885c77e9f066af3943edeb247a69783e3..3cb645aa0fbb2792ac33dc52f998d56ff7c6e147 100644 (file)
--- a/doc/rrdbuild.1
+++ b/doc/rrdbuild.1
@@ -129,7 +129,7 @@
 .\" ========================================================================
 .\"
 .IX Title "RRDBUILD 1"
-.TH RRDBUILD 1 "2008-07-23" "1.3.1" "rrdtool"
+.TH RRDBUILD 1 "2008-12-15" "1.3.5" "rrdtool"
 .SH "NAME"
 rrdbuild \- Instructions for building RRDtool
 .SH "OVERVIEW"
@@ -163,7 +163,7 @@ Once you have decided. Save the two locations into environment variables.
 .PP
 .Vb 2
 \& BUILD_DIR=/tmp/rrdbuild
-\& INSTALL_DIR=/usr/local/rrdtool\-1.3.1
+\& INSTALL_DIR=/usr/local/rrdtool\-1.3.5
 .Ve
 .PP
 If your \fI/tmp\fR is mounted with the option noexec (\s-1RHEL\s0 seems todo that) you have to choose
@@ -180,9 +180,9 @@ Lets first assume you already have all the necessary libraries
 pre\-installed. 
 .PP
 .Vb 4
-\& wget http://oss.oetiker.ch/rrdtool/pub/rrdtool\-1.3.1.tar.gz
-\& gunzip \-c rrdtool\-1.3.1.tar.gz | tar xf \-
-\& cd rrdtool\-1.3.1
+\& wget http://oss.oetiker.ch/rrdtool/pub/rrdtool\-1.3.5.tar.gz
+\& gunzip \-c rrdtool\-1.3.5.tar.gz | tar xf \-
+\& cd rrdtool\-1.3.5
 \& ./configure \-\-prefix=$INSTALL_DIR && make && make install
 .Ve
 .PP
@@ -213,6 +213,21 @@ fix this:
 .Vb 1
 \& perl \-i~ \-p \-e \(aqs/(Requires.*?)\es*xrender.*/$1/\(aq /usr/lib/pkgconfig/cairo.pc
 .Ve
+.PP
+Make sure rrdtool finds your new compiler
+.PP
+.Vb 1
+\& export PATH=/opt/SunStudioExpress/bin
+.Ve
+.PP
+Since there does not seem to ba a viable msgfmt tool on opensolaris (short
+of installing it yourself). You have to call configure with the
+.PP
+.Vb 1
+\& \-\-disable\-libintl
+.Ve
+.PP
+option.
 .Sh "Debian / Ubuntu"
 .IX Subsection "Debian / Ubuntu"
 Use apt-get to make sure you have all that is required. A number
@@ -273,16 +288,6 @@ Another hint to get rrdtool working on \s-1AIX\s0 is to use the \s-1IBM\s0 \s-1X
 (Better instructions for \s-1AIX\s0 welcome!)
 .Sh "Build Instructions"
 .IX Subsection "Build Instructions"
-In order to build rrdtool need a compiler on your system. Unfortunately
-compilers are not all alike. This has an effect on the \s-1CFLAGS\s0 you want to
-set. The examples below are for the popular \s-1GCC\s0 compiler suite. If you have
-an other compilers here are some ides:
-.IP "Sun Forte" 4
-.IX Item "Sun Forte"
-.Vb 1
-\& CFLAGS="\-xO3 \-kPIC"
-.Ve
-.PP
 Some libraries want to know where other libraries are. For this to work,
 set the following environment variable
 .PP
@@ -302,6 +307,13 @@ the syntax again differs from system to system:
 .Vb 1
 \& export LDFLAGS=\-R${INSTALL_DIR}/lib
 .Ve
+.Sp
+if you are using the Sun Studio/Forte compiler, you may also want to set
+.Sp
+.Vb 2
+\& CFLAGS="\-xO3 \-xcode=pic13"   (SPARC)
+\& CFLAGS="\-xO3 \-Kpic"          (x86)
+.Ve
 .IP "Linux" 4
 .IX Item "Linux"
 .Vb 1
@@ -407,8 +419,8 @@ add the following at the start the configure line:
 .Vb 7
 \& cd $BUILD_DIR
 \& wget http://oss.oetiker.ch/rrdtool/pub/libs/libxml2\-sources\-2.6.31.tar.gz
-\& gunzip \-c libxml2\-sources\-2.6.32.tar.gz | tar xf \-
-\& cd libxml2\-sources\-2.6.32
+\& gunzip \-c libxml2\-sources\-2.6.31.tar.gz | tar xf \-
+\& cd libxml2\-sources\-2.6.31
 \& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC"
 \& $MAKE
 \& $MAKE install
@@ -451,7 +463,7 @@ config file.
 .Vb 11
 \& cd $BUILD_DIR
 \& wget http://oss.oetiker.ch/rrdtool/pub/libs/cairo\-1.6.4.tar.gz
-\& gunzip \-c cairo\-1.4.10.tar.gz   | tar xf \-
+\& gunzip \-c cairo\-1.6.4.tar.gz   | tar xf \-
 \& cd cairo\-1.4.10
 \& ./configure \-\-prefix=$INSTALL_DIR \e
 \&    \-\-enable\-xlib=no \e
@@ -468,8 +480,8 @@ config file.
 .Vb 7
 \& cd $BUILD_DIR
 \& wget http://oss.oetiker.ch/rrdtool/pub/libs/glib\-2.15.4.tar.gz
-\& gunzip \-c glib\-2.12.13.tar.gz  | tar xf \-
-\& cd glib\-2.12.13
+\& gunzip \-c glib\-2.15.4.tar.gz  | tar xf \-
+\& cd glib\-2.15.4
 \& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC"
 \& $MAKE
 \& $MAKE install
@@ -500,7 +512,7 @@ tcl setups that would prevent rrdtool from building if they are included in
 their current state.
 .PP
 .Vb 5
-\& cd $BUILD_DIR/rrdtool\-1.3.1
+\& cd $BUILD_DIR/rrdtool\-1.3.5
 \& ./configure \-\-prefix=$INSTALL_DIR \-\-disable\-tcl \-\-disable\-python
 \& $MAKE clean
 \& $MAKE