                           imoviedb INSTALLATION


Imoviedb now uses a configure file generated by autoconf.

See INSTALL.AUTOCONF for full detail of options accepted by configure.


QUICK SUMMARY:

  - Make sure readline has been installed.
  - run configure
     ./configure --prefix=/usr/local/moviedb
     (or `sh ./configure ...' with old csh)
  - make
  - make install
  - make install-man

 Useful options for configure:

   - --with-zlib to use zlib library, in order to compress .completion files.
     (for zlib, check http://quest.jpl.nasa.gov/zlib/)

   - installation goes into $prefix/bin and $prefix/etc

   - prefix is set by --prefix, or if not specified, by looking where is
     installed the program `title', or if not found /usr/local.

   - moviedb sources are found in the path specified with --with-moviedbsrc,
     or if not specified, in the path specified with --with-moviedb + /src,
     or if not specified, in $prefix/src.

   - moviedb databases are found in the path specified with --with-moviedb +
     /dbs, or if not specified, in $prefix/dbs.


 So, you can have the following configurations:

  - (the easiest standard configuration) `title' is in your path. imoviedb
    will be installed in the same place. Use:

        ./configure

  - moviedb sources and databases and imoviedb all go in the same place, say
    /usr/local/moviedb. Use:

        ./configure --prefix=/usr/local/moviedb

  - moviedb sources and databases in /usr/local/moviedb and imoviedb somewhere
    else. Use:

        ./configure --prefix=somewhereelse --with-moviedb=/usr/local/moviedb

  - moviedb sources in /tmp/moviedb/src, databases in /usr/local/moviedb and
    imoviedb somewhere else. use:

        ./configure --prefix=somewhereelse --with-moviedb=/usr/local/moviedb \
                --with-moviedbsrc=/tmp/moviedb/src


COMPILERS, OPTIONS AND LIBRARIES

   Some systems require unusual options for compilation or linking that the
   `configure' script does not know about. Moreover, readline may need
   additional libraries. You can give `configure' initial values for
   variables by setting them in the environment. Using a Bourne-compatible
   shell, you can do that on the command line like this:

     CC=acc CFLAGS="-O2 -I/usr/local/readline" LIBS=-lbsd ./configure

   Or on systems that have the `env' program, you can do it like this:

     env CPPFLAGS=-I/usr/local/include LDFLAGS=-L/opt/readline/lib ./configure

   The following variables are commonly used:
        CC       name of the C compiler
        CPPFLAGS options for the C preprocessor
        CFLAGS   options for C compilation
        LDFLAGS  options for link
        LIBS     additional libraries


TESTED ON

   sun4, SunOS 4.1.3, gcc 2.7.2
   sun4, SunOS 4.1.3, cc + unproto 2.1
   sun4, SunOS 4.1.3, SC3.0.1
   sun4, SunOS 5.2, gcc 2.5.8
   sun4, SunOS 5.5, SC4.0
   DEC Alpha, DEC UNIX V3.2, standard cc
   DEC Alpha, DEC UNIX V3.2, gcc 2.7.2
   DEC Alpha, Linux 2.0.27, gcc 2.7.2.1
   i586, Linux 2.0.0, gcc 2.7.2p
   SGI IP22, IRIX 6.2, standard cc
   HP9000, HP/UX 9.05, HP cc            -- not yet

   I'll be glad to hear about other ports.


MISC
  readline-2.0: remember to apply the patch in readline-2.0-patch, or, if
        you have already installed it, check that tilde.h is in the same
        place as readline.h or copy it by hand if necessary.
        This is no longer necessary with readline-2.2 or readline-4.0.


INSTALLATION OF readline-1.1

  - PC386, Linux 0.99.13, gcc 2.4.5
     1) Compilation of readline-1.1:
        - do not change the Makefile, except for DESTDIR and INCDIR.
          Especially, do not define USG.
        - Edit readline.c and change the line
          #include <sgtty.h>
          into
          #include <bsd/sgtty.h>
        - that's all, but libreadline.a requires -lbsd
     2) Compilation of imoviedb:
        - set the environnement variable LIBS to -lbsd before calling
          configure.
  - HP9000, HP/UX 9.1, HP cc
     1) Compilation of readline-1.1:
        - do not define USG
        - if you are using HP cc, do not use -Aa (readline is in K&R C)
        - set DESTDIR and INCDIR to their right value.
        - that's all, but libreadline.a requires alloca() from libPW.a
     2) Compilation of imoviedb:
        - set the environnement variable LIBS to -lPW before calling
          configure.
          You do NOT need -lBSD in spite of what readline doc says.
  - SGI ???, IRIX 5.3, standard cc
      1) Compilation of readline-1.1
        - do not define USG
        - use K&R mode (-cckr option)
        - alloca.h must be included in history.c readline.c and vi_mode.c
  - DEC ALPHA, OSF1 V3.2, dec cc
      1) Compilation of readline-1.1
        - define USG
