X-Git-Url: http://git.indexdata.com/?p=yazpp-moved-to-github.git;a=blobdiff_plain;f=doc%2Finstallation.xml;h=e6d7097d23303c6c4f0d92896ed6f4b6d68316a9;hp=4b24e4af1d153560c78c9df6e8d8220031bbae64;hb=d84b43231c7c5b0786e9aa62d0f7ca7ecd83bdb5;hpb=fc357a11b8c9b87534b3baa8c2c4d5b656f0998a diff --git a/doc/installation.xml b/doc/installation.xml index 4b24e4a..e6d7097 100644 --- a/doc/installation.xml +++ b/doc/installation.xml @@ -1,5 +1,5 @@ - + Installation You need a C++ compiler to compile and use YAZ++. @@ -7,7 +7,7 @@ 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! + your system. YAZ++ is built on top of the @@ -17,17 +17,17 @@ For some platforms there are binary packages for YAZ.
- UNIX + Building on Unix On UNIX, the software is compiled as follows: - ./configure - make - su - make install + $ ./configure + $ make + $ su + # make install - You can supply options for the configure script. + You can supply options for the configure script. The most useful ones are: @@ -40,59 +40,86 @@ --with-yazconfig directory - Specifies location of yaz-config. - The yaz-config is generated in + 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 + If you don't supply this option, configure will look for yaz-config in directories of the - PATH environment. + 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: + For the whole list of configure options, refer + to the help: ./configure --help. - This is a list of what you have after successful compilation: + 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 + src/yaz-proxy - Z39.50 Proxy. This program gets installed in - your binaries directory (prefix/bin). + The YAZ Z39.50 Proxy utility. + This program gets installed in your binaries directory + (prefix/bin). + - lib/libyaz++.la + lib/libyaz++.la - YAZ++ library. This library gets installed in your - libraries directory (prefix/lib). + The YAZ++ library, including the + ZOOM-C++ classes. + This library gets installed in your libraries directory + (prefix/lib). - include/yaz++/*.h + include/yaz++/*.h - Various header files. All these are installed in - your header files area (prefix/include/yaz++). + 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 + yaz++-config - Bourne shell script utility that returns CFLAGS/LIBS - needed in order to compile with the YAZ++ library. - This script gets installed in your binaries directory - (prefix/bin). + 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/zclient ZOOM C++ demonstration client. This client does not get installed in the system directories. @@ -100,7 +127,7 @@ - src/yaz-my-client + src/yaz-my-client YAZ C++ demonstration client. This client does not get installed in the system directories. @@ -108,7 +135,7 @@ - src/yaz-my-server + src/yaz-my-server YAZ C++ demonstration server. This server does not get installed in the system directories. @@ -117,6 +144,58 @@
+
+ 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. + +