doc/autoconf.htm

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
   2 <html>
   3 <title>OpenSP autoconf support</title>
   4 <body bgcolor="#ffffff">
   5 <h1>OpenSP autoconf support</h1>
   6
   7 <p>We have dropped the old SP Makefiles in favour of the GNU
   8 configuration tools automake, autoconf and libtool. If building
   9 OpenSP doesn't work out of the box on your system, we'd like to
  10 receive feedback and patches for your operating system.
  11 </p>
  12
  13 <h2>Usage</h2>
  14
  15 <pre>
  16 % ./configure; make; make install
  17 </pre>
  18
  19 <h2>configure options</h2>
  20
  21 <dl>
  22
  23 <dt><code>--help</code></dt>
  24
  25 <dd>Print a full list of options. This document only deals with the
  26 non-standard options.</dd>
  27
  28 <dt><code>--enable-http</code>
  29 <dd>Include support for HTTP.</dd>
  30
  31 <dt><code>--enable-default-catalog=pathlist</code>
  32 <dd>Provide one or more default catalog files or sysids.</dd>
  33
  34 <dt><code>--enable-default-search-path=pathlist</code>
  35 <dd>Provide a default value for SGML_SEARCH_PATH.</dd>
  36
  37 </dl>
  38
  39 <h2>Local defines</h2>
  40
  41 <p>If you have some extra additions to OpenSP, you can set
  42 CFLAGS/CXXFLAGS and/or LDFLAGS/LIBS at configure time:</p>
  43
  44 <pre>
  45 CXXFLAGS=-Dmyhacks LDFLAGS=-L/opt/myhacks LIBS=-lmyhacks ./configure
  46 </pre>
  47
  48 <p>Check the invocation of ld in Makefile for the exact semantics
  49 of LDFLAGS and LIBS.</p>
  50
  51 <h2>Tested platforms</h2>
  52
  53 <ul>
  54 <li>RedHat Linux 5.2 (egcs 1.0.3, glibc 2.0.7)</li>
  55 <li>RedHat Linux 6.0 (gcc 2.95.1, glibc 2.1.1)</li>
  56 <li>SuSE Linux 5.3 (gcc 2.7.2.1, libc 5.5.46)</li>
  57 <li>Solaris 2.6 (gcc 2.8.1)</li>
  58 </ul>
  59
  60 <h2>Shared library support</h2>
  61
  62 <p>By default, <code>./configure</code> attempts to build shared
  63 libraries and link against them. This is done via the
  64 <code>libtool</code> utility, a utility that knows how to build shared
  65 libraries on a number of platforms.</p>
  66
  67 <p>By default, only shared libraries are built. If you have
  68 difficulties building shared libraries, or you want to build static
  69 versions, you can use the
  70 <code>--{enable,disable}-{shared,static}</code> options to configure
  71 libtool to your likings.</p>
  72
  73 <p>According to the libtool 1.2 docs, shared libraries work on:</p>
  74 <ul>
  75 <li>AIX 3.x (*-*-aix3*)</li>
  76 <li>AIX 4.x (*-*-aix4*)</li>
  77 <li>AmigaOS (*-*-amigaos*)</li>
  78 <li>Digital/UNIX 3.x, 4.x, a.k.a. OSF/1 (*-*-osf3*, *-*-osf4*)</li>
  79 <li>FreeBSD 2.x, 3.x (*-*-freebsd2*, *-*-freebsd3*)</li>
  80 <li>GNU/Linux ELF (*-*-linux-gnu*, except aout, coff, and oldld)</li>
  81 <li>HP-UX 9.x, 10.x (*-*-hpux9*, *-*-hpux10*) [see note]</li>
  82 <li>IRIX 5.x, 6.x (*-*-irix5*, *-*-irix6*)</li>
  83 <li>NetBSD 1.x (*-*-netbsd*)</li>
  84 <li>OpenBSD 2.x (*-*-openbsd*)</li>
  85 <li>OS/2 using EMX (*-*-os2*)</li>
  86 <li>SCO OpenServer 5.x (*-*-sco3.2v5*)</li>
  87 <li>Solaris 2.x (*-*-solaris2*)</li>
  88 <li>SunOS 4.x, a.k.a. Solaris 1.x  (*-*-sunos4*)</li>
  89 <li>UnixWare 2.x (*-*-sysv4.2uw2*)</li>
  90 <li>UTS 4.x (*-*-uts4*)</li>
  91 <li>All ELF targets that use both the GNU C compiler (gcc) and GNU ld</li>
  92 </ul>
  93
  94 <p>One more note from the libtool documentation: the HP/UX sed seems
  95 to be badly broken, install GNU sed before attempting to build -
  96 libtool depends on a working sed.</p>
  97
  98 <p><strong>Note:</strong> shared libraries seem to be broken on
  99 HP-UX 10.* with gcc-2.95.2. Use <code>--disable-shared</code>.</p>
 100 </body>
 101 </html>