summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/compile.xml205
1 files changed, 205 insertions, 0 deletions
diff --git a/doc/compile.xml b/doc/compile.xml
new file mode 100644
index 0000000..6dabd72
--- /dev/null
+++ b/doc/compile.xml
@@ -0,0 +1,205 @@
+
+
+<article>
+
+
+
+ <articleinfo>
+ <title>How to compile cSOAP</title>
+ <author><firstname>Ferhat</firstname><surname>Ayaz</surname></author>
+ <copyright><year>2005</year><holder>csoap</holder></copyright>
+ </articleinfo>
+
+
+
+
+
+<section>
+<title>Introduction</title>
+
+
+<para>
+ This document shows in short examples how to compile cSOAP
+under *nix systems.
+</para>
+
+
+
+<para>
+ cSOAP is implemented in ANSI C. So it should be possible to compile it with
+every ANSI C conform compiler. If you can not compile it with your compiler,
+please post it to the mailinglist, so we can alter neccessary code or Makefiles.
+</para>
+
+
+
+</section>
+
+
+
+<section>
+
+<title>Dependecies</title>
+
+
+<para>
+ cSOAP depends on libxml2 and pkg-config tool.
+</para>
+
+
+
+<synopsis>
+ + libxml2 : http://xmlsoft.org
+ + pkg-config : http://pkgconfig.freedesktop.org/wiki/
+</synopsis>
+
+</section>
+
+
+
+<section>
+
+<title>Build libxml2</title>
+
+
+
+<para>
+ First you must build the libxml2 library. You can test if you have this library
+on your system by typing xml2-config in a command prompt.
+</para>
+
+<synopsis><![CDATA[
+
+$ xml2-config
+Usage: xml2-config [OPTION]
+
+Known values for OPTION are:
+
+ --prefix=DIR change libxml prefix [default /usr]
+ --libs print library linking information
+ --cflags print pre-processor and compiler flags
+ --help display this help and exit
+ --version output version information
+
+]]></synopsis>
+
+
+<para>
+ Otherwise download the latest sourcecode form http://xmlsoft.org. lets say you downloaded
+<filename>libxml2-[version].tar.gz</filename> into you build directory.
+</para>
+
+<synopsis><![CDATA[
+
+$tar zxvf libxml2-[version].tar.gz
+$cd libxml2-[version]
+$./configure --prefix=$LIBXMLDIST
+$make
+$make install
+
+]]></synopsis>
+
+<para>
+ where $LIBXMLDIST is your directory where you want to install libxml2 (usually /usr or /usr/local).
+Replace it with your pathname.
+</para>
+
+
+</section>
+
+
+
+<section>
+
+<title>Build cSOAP</title>
+
+
+<para>
+ At this time we assume that you have pkg-config and libxml2 installed properly on you system.
+ To check if you have pkg-config, just type "pkg-config" in a command prompt.
+</para>
+
+
+<synopsis><![CDATA[
+
+$pkg-config
+Must specify package names on the command line
+
+]]></synopsis>
+
+<para>Otherwise got to http://pkgconfig.freedesktop.org/wiki/ and folow the instructions</para>
+
+<para>
+Now we must download the latest cSOAP package into the build directory.
+Goto "http://sourceforge.net/project/showfiles.php?group_id=74977" (or click just the download menu item)
+and download the latest cSOAP package. Lets say libsoap-[version].tar.gz.
+</para>
+
+
+<synopsis><![CDATA[
+
+$tar zxvf libsoap-[version].tar.gz
+$cd libsoap-[version]
+$./configure --prefix=$LIBSOAPDIST --with-libxml-prefix=$LIBXMLDIST
+$make
+$make install
+
+]]></synopsis>
+
+
+<para>
+ where $LIBSOAPDIST is your directory where you want to install libsoap (usually /usr or /usr/local) and
+ $LIBXMLDIST is the directory where you installed libxml2 (see section "Build libxml2"). Replace this
+variables with your pathnames.
+</para>
+
+</section>
+
+
+
+<section>
+
+<title>I'm in hurry. Show me all at once</title>
+
+<para>
+Ok. Here is a script which will download, compile and install csoap and libxml2.
+</para>
+
+
+
+<synopsis><![CDATA[
+
+#-----------------------------------------------------------
+#!/bin/sh
+
+# Download and install libxml2
+
+wget ftp://ftp.xmlsoft.org/libxml2-2.6.20.tar.gz
+tar zxvf libxml2-2.6.20.tar.gz
+cd libxml2-2.6.20
+./configure --prefix=`pwd`/../libxml2
+make
+make install
+cd ..
+
+# Download and install cSOAP
+
+wget http://kent.dl.sourceforge.net/sourceforge/csoap/libsoap-1.0.3.tar.gz
+tar zxvf libsoap-1.0.3.tar.gz
+cd libsoap-1.0.3
+./configure --prefix=`pwd`/../libsoap --with-libxml-prefix=`pwd`/../libxml2
+make
+make install
+
+#-----------------------------------------------------------
+
+]]></synopsis>
+
+
+
+</section>
+
+
+
+</article>
+