From 10e81e043068151fd32d623ace21222ab6c91ea3 Mon Sep 17 00:00:00 2001 From: Adam Dickmeiss Date: Tue, 18 Feb 2003 20:21:22 +0000 Subject: [PATCH] Installation instruction updates --- configure.in | 41 +++----------- doc/installation.xml | 153 ++++++++++++++++++++++++++++++++++++++------------ 2 files changed, 125 insertions(+), 69 deletions(-) diff --git a/configure.in b/configure.in index 4555068..bb95280 100644 --- a/configure.in +++ b/configure.in @@ -1,6 +1,6 @@ dnl YAZ Toolkit, Index Data 1994-2003 dnl See the file LICENSE for details. -dnl $Id: configure.in,v 1.107 2003-02-18 10:37:08 adam Exp $ +dnl $Id: configure.in,v 1.108 2003-02-18 20:21:22 adam Exp $ AC_INIT(include/yaz/yaz-version.h) AM_INIT_AUTOMAKE(yaz, 1.9.3) dnl @@ -17,7 +17,7 @@ AM_PROG_LIBTOOL dnl dnl ----- DOCBOOK DTD AC_SUBST(DTD_DIR) -AC_ARG_WITH(dtd, [ --with-dtd[=DIR] Use docbookx.dtd in DIR], +AC_ARG_WITH(dtd, [ --with-dtd[=DIR] use docbookx.dtd in DIR], [ if test -f "$withval/docbookx.dtd"; then DTD_DIR=$withval @@ -41,7 +41,7 @@ AC_ARG_WITH(dtd, [ --with-dtd[=DIR] Use docbookx.dtd in DIR], fi ]) AC_SUBST(DSSSL_DIR) -AC_ARG_WITH(dsssl,[ --with-dsssl[=DIR] Use DSSSL in DIR/{html,print}/docbook.dsl], +AC_ARG_WITH(dsssl,[ --with-dsssl[=DIR] use Docbook DSSSL in DIR/{html,print}/docbook.dsl], [ if test -f "$withval/html/docbook.dsl"; then DSSSL_DIR=$withval @@ -63,7 +63,7 @@ AC_ARG_WITH(dsssl,[ --with-dsssl[=DIR] Use DSSSL in DIR/{html,print}/docbo fi ]) AC_SUBST(XSL_DIR) -AC_ARG_WITH(xsl,[ --with-xsl[=DIR] Use XSL in DIR/{htmlhelp,xhtml}], +AC_ARG_WITH(xsl,[ --with-xsl[=DIR] use Docbook XSL in DIR/{htmlhelp,xhtml}], [ if test -f "$withval/htmlhelp/htmlhelp.xsl"; then XSL_DIR=$withval @@ -99,7 +99,7 @@ AC_CHECK_FUNC(gethostbyname, , AC_CHECK_LIB(nsl, main, [LIBS="$LIBS -lnsl"])) dnl dnl ------ Open SSL openssl=no -AC_ARG_WITH(openssl, [ --with-openssl[=DIR] OpenSSL library in DIR], [openssl=$withval]) +AC_ARG_WITH(openssl, [ --with-openssl[=PREFIX] OpenSSL library in PREFIX], [openssl=$withval]) AC_SUBST(SSL_CFLAGS) AC_SUBST(SSL_LIBS) AC_SUBST(SSL_DEFS) @@ -163,7 +163,7 @@ if test "$ac_cv_lib_readline_readline" = "yes"; then LIBS=$xLIBS fi dnl ------ iconv -AC_ARG_WITH(iconv, [ --with-iconv[=DIR] iconv library in DIR]) +AC_ARG_WITH(iconv, [ --with-iconv[=PREFIX] iconv library in PREFIX]) if test "$with_iconv" != "no"; then AC_MSG_CHECKING(for iconv) oldLIBS="$LIBS" @@ -329,36 +329,11 @@ if test "$enable_threads" = "yes" -a "$HAVETHREADS" = "0"; then fi AM_CONDITIONAL(ISTHR, test $HAVETHREADS = "1") dnl -dnl ----- libXSLT -AC_SUBST(XSLT_LIB) -AC_SUBST(XSLT_CFLAGS) -xsltdir=no -AC_ARG_WITH(xslt, [ --with-xslt[=PREFIX] Use libxslt in PREFIX/{lib,include}],[xsltdir=$withval]) -if test "$xsltdir" = "yes"; then - for d in /usr /usr/local; do - if test -x $d/bin/xslt-config; then - xsltdir=$d - fi - done -fi -if test "$xsltdir" != "no"; then - AC_MSG_CHECKING(for XSLT) - if test -x $xsltdir/bin/xslt-config; then - XSLT_LIB=`$xsltdir/bin/xslt-config --libs` - XSLT_CFLAGS=`$xsltdir/bin/xslt-config --cflags` - XSLT_VER=`$xsltdir/bin/xslt-config --version` - AC_MSG_RESULT($XSLT_VER) - AC_DEFINE(HAVE_XSLT) - else - AC_MSG_RESULT(Not found) - fi -fi -dnl dnl ----- libXML2 AC_SUBST(XML2_LIBS) AC_SUBST(XML2_CFLAGS) -xml2dir=no -AC_ARG_WITH(xml2, [ --with-xml2[=PREFIX] Use libxml2 in PREFIX/{lib,include}],[xml2dir=$withval]) +xml2dir=yes +AC_ARG_WITH(xml2, [ --with-xml2[=PREFIX] use libxml2 in PREFIX],[xml2dir=$withval]) if test "$xml2dir" = "yes"; then for d in /usr /usr/local; do if test -x $d/bin/xml2-config; then diff --git a/doc/installation.xml b/doc/installation.xml index 75bfa57..9e445d4 100644 --- a/doc/installation.xml +++ b/doc/installation.xml @@ -1,4 +1,4 @@ - + Compilation and Installation Introduction @@ -69,7 +69,10 @@ UNIX - We provide Debian GNU/Linux and Redhat packages for YAZ. + We provide + Debian GNU/Linux + and + Redhat packages for &yaz;. Only i386 binary packages are available. You should be able to create packages for other CPU's by building them from the source package. @@ -83,8 +86,25 @@ have to acquire one separately. We recommend GCC. + + + If you wish to use character set conversion facilities in &yaz; or if you + are compiling &yaz; for use with Zebra it is a good idea to ensure that + the iconv library is installed. Some Unixes today already have it + - if not, we suggest + GNU iconv. + + - For UNIX, the GNU tools + The XML C library libxml2 + is required if &yaz; is to support SRW (and SOAP). + This library is very portable and should compile out-of-the + box on virtually all Unix platforms. It is available in binary + forms for Linux and others. + + + + The GNU tools Autoconf, Automake and Libtool @@ -92,15 +112,21 @@ You do not these tools unless you're using the CVS version of &yaz;. - + - If you wish to use character set conversion facilities in YAZ or if you - are compiling YAZ for use with Zebra it is a good idea to ensure that - the iconv library is installed. Most Unixes today already have it - - if not, we suggest - GNU iconv. + The CQL parser for &yaz; is built using + GNU Bison. + This tool is only needed if you're using the CVS version of &yaz;. - + + + &yaz; includes a tiny ASN.1 compiler. This compiler is + written in Tcl. + But as for Bison you do not need it unless you're using CVS + version of &yaz; or you're using the compiler to built own codecs + for private ASN.1. + + Generally it should be sufficient to run configure without options, like this: @@ -128,8 +154,9 @@ The most important are: - --prefix path - Specifies installation prefix. This is + + --prefix=prefix + Specifies installation prefix for &yaz;. This is only needed if you run make install later to perform a "system" installation. The prefix is /usr/local if not specified. @@ -153,18 +180,14 @@ . + --enable-threads &yaz; will be built using POSIX threads. Specifically, _REENTRANT will be defined during compilation. - --with-openssl - &yaz; will be linked with the OpenSSL libraries and - an SSL COMSTACK will be provided. Note that SSL support is still - experimental. - - + --enable-shared The make process will create shared libraries (also known as shared objects .so). @@ -172,6 +195,7 @@ equivalent to --disable-shared. + --disable-shared The make process will not create static libraries (.a). @@ -181,15 +205,40 @@ - --with-iconv[=dir] - Compile YAZ with iconv library in directory - dir. By default configure will + --with-iconv[=prefix] + + Compile &yaz; with iconv library in directory + prefix. By default configure will search for iconv on your system. Use this option if it doesn't find iconv. Alternatively you can use - --without-iconv to force YAZ not to use + --without-iconv to force &yaz; not to use iconv. + + + --with-xml2[=prefix] + + Compile &yaz; with + libxml2 in directory + prefix. + Use this option if you want SOAP support. + By default configure will + search for libxml2 on your system. Use this option if it + doesn't find libxml2. Alternatively you can use + --without-xml2 to force &yaz; not to use + libxml2. + + + + + --with-openssl[=prefix] + + &yaz; will be linked with the OpenSSL libraries and + an SSL COMSTACK will be provided. Note that SSL support is still + experimental. + + @@ -271,7 +320,7 @@ You probably need to have root access in order to perform this. You must specify the --prefix option for configure if - you wish to install &yaz; in other directories than the default + you wish to install &yaz; in other directories than the default /usr/local/. @@ -376,8 +425,10 @@ Compiling from Source on WIN32 &yaz; is shipped with "makefiles" for the NMAKE tool that comes - with Microsoft Visual C++. Version 6 has been tested. We expect that - &yaz; should compile with version 5 as well. + with + Microsoft Visual C++. + Version 6 has been tested. We expect that &yaz; compiles + with version 5 as well. Start a command prompt and switch the sub directory @@ -397,16 +448,23 @@ (code generation is multi-threaded DLL). - TCL + + HAVE_TCL, TCL - Specifies the name of the Tcl shell (EXE-file). - You do not need setting this or installing Tcl unless you wish - to change or add ASN.1 for &yaz;. + If HAVE_TCL is set to 1, nmake will + use the ASN.1 compiler (Tcl based). You must set + TCL to the full path of the Tcl + interpreter. + + + If you do not have Tcl installed, set + HAVE_TCL to 0. - HAVE_ICONV, ICONV_DIR + HAVE_ICONV, + ICONV_DIR If HAVE_ICONV is set to 1, YAZ is compiled with iconv support. In this configuration, set @@ -414,6 +472,25 @@ + + HAVE_LIBXML2, + LIBXML2_DIR + + + If HAVE_LIBXML2 is set to 1, YAZ is compiled + with SRW (and SOAP) support. In this configuration, set + LIBXML2_DIR to the + libxml2 source directory. + + + + You can get libxml2 and iconv binaries from + + here. + + + + @@ -421,13 +498,17 @@ nmake - If command nmake is not found on your system - you probably haven't defined the environment variables required to - use that tool. To fix that, find and run the batch file - vcvars32.bat. You need to run it from within - the command prompt or set the environment variables "globally"; - otherwise it doesn't work. + + + If the nmake command is not found on your system + you probably haven't defined the environment variables required to + use that tool. To fix that, find and run the batch file + vcvars32.bat. You need to run it from within + the command prompt or set the environment variables "globally"; + otherwise it doesn't work. + + If you wish to recompile &yaz; - for example if you modify settings in the makefile you can delete -- 1.7.10.4