X-Git-Url: http://sru.miketaylor.org.uk/?a=blobdiff_plain;f=doc%2Finstallation.xml;h=e6d7097d23303c6c4f0d92896ed6f4b6d68316a9;hb=4b042ccab852026e35f59e06f4e300a2d8db0793;hp=b6a9aaba10955bd7ed26a0984db54a49a0e6852f;hpb=2ad40f2e15a4d6927833231b8dc6874b747fed2e;p=yazpp-moved-to-github.git
diff --git a/doc/installation.xml b/doc/installation.xml
index b6a9aab..e6d7097 100644
--- a/doc/installation.xml
+++ b/doc/installation.xml
@@ -1,10 +1,202 @@
-
- Installation
-
- How to compile this software.
-
-
+
+
Installation
+
+ You need a C++ compiler to compile and use YAZ++.
+ The software was implemented using GCC so we know that works
+ well with YAZ++. From time to time the software has been
+ compiled on Windows using Visual C++. Other compilers should
+ work too. Let us know of portability problems, etc. with
+ your system.
+
+
+ YAZ++ is built on top of the
+ YAZ
+ toolkit.
+ You need to install that first.
+ For some platforms there are binary packages for YAZ.
+
+
+ Building on Unix
+ On UNIX, the software is compiled as follows:
+
+ $ ./configure
+ $ make
+ $ su
+ # make install
+
+
+
+ You can supply options for the configure script.
+ The most useful ones are:
+
+
+ --prefix directory
+
+ Specifies installation prefix. By default
+ /usr/local is used.
+
+
+
+ --with-yazconfig directory
+
+ Specifies the location of yaz-config.
+ The yaz-config program is generated in
+ the source directory of YAZ as well as the binaries
+ directory when YAZ is installed (via make install).
+
+
+ If you don't supply this option, configure will
+ look for yaz-config in directories of the
+ PATH environment - which is nearly always
+ what you want.
+
+
+
+ --with-xslt directory
+
+ Specifies prefix for libxslt (and libxml2).
+ configure must be able to locate xslt-config
+ in PREFIX/bin. If this option is omitted, configure looks
+ for xslt-config in the current PATH.
+
+
+
+ For the whole list of configure options, refer
+ to the help:
+ ./configure --help.
+
+
+ Configure uses GCC's C/C++ compiler if available. To specify another
+ compiler, set CXX. To use other compiler flags,
+ specify CXXFLAGS. To use CC
+ with debugging you could use:
+
+ CXXFLAGS="-g" CXX=CC ./configure
+
+
+
+ This is what you have after successful compilation:
+
+
+ src/yaz-proxy
+
+ The YAZ Z39.50 Proxy utility.
+ This program gets installed in your binaries directory
+ (prefix/bin).
+
+
+
+
+ lib/libyaz++.la
+
+ The YAZ++ library, including the
+ ZOOM-C++ classes.
+ This library gets installed in your libraries directory
+ (prefix/lib).
+
+
+
+
+ include/yaz++/*.h
+
+ Various C++ header files, which you'll need for YAZ
+ development. All these are installed in your header files area
+ (prefix/include/yaz++).
+
+
+
+
+ yaz++-config
+
+ A Bourne shell-script utility that returns the values of the
+ CFLAGS and LIBS
+ environment variables
+ needed in order to compile your applications with the YAZ++
+ library. This script gets installed in your binaries directory
+ (prefix/bin).
+
+
+
+
+ zoom/zclient
+
+ ZOOM C++ demonstration client. This client does not
+ get installed in the system directories.
+
+
+
+
+ src/yaz-my-client
+
+ YAZ C++ demonstration client. This client does not
+ get installed in the system directories.
+
+
+
+
+ src/yaz-my-server
+
+ YAZ C++ demonstration server. This server does not
+ get installed in the system directories.
+
+
+
+
+
+
+ Building on Windows
+
+ You'll find Visual Studio project files in sub directory
+ win. Open workspace yazxx.dsw
+ which includes the following projects:
+
+
+ yazxx.dsp
+
+ Builds the yazxx.dll.
+
+
+
+ yazclient.dsp
+
+ Builds the sample client yazmyclient.exe.
+
+
+
+ yazserver.dsp
+
+ Builds the sample server yazmyserver.exe.
+
+
+
+ yazserver.dsp
+
+ Builds the proxy yazproxy.exe.
+
+
+
+ zoomxxclient.dsp
+
+ Builds the ZOOM C++ demo client zoomxxclient.exe.
+
+
+
+
+
+ By default, the include path and library path for the projects assumes
+ that YAZ is located in ..\yaz
+ (i.e. same prefix as the YAZ++ source).
+ If YAZ is in a different directory you'll have to modify
+ the include path in
+ Project | Settings | C/C++ | Preprocessor | Additional include
+ directories
+ and library path in
+ Project | Settings | Link | Input | Additional library
+ path.
+
+
+