README
                           ======

      Installation guide for Varkon 1.19D. This README includes specific
      information for Linux users but should also be used for other
      Unix systems like FreeBSD and MacOSX.

      When you read this file you have either downloaded and installed
      (unpacked) a prebuilt binary version of Varkon or you have downloaded
      and installed the sources. The top directory of the Varkon installation
      is referred to as VARKON_ROOT.

      If you are building Varkon from the sources, follow the instructions
      in the file VARKON_ROOT/sources/README before you continue. This will
      build the executable binaries and the HTML documentation.

      The prebuilt binary version of Varkon includes the full HTML documentation.
      If you build Varkon from the sources the documentation is automatically
      created during the build process.

      The start page of the Varkon documentation is:
      VARKON_ROOT/man/index.htm

      The full documentation is also available online at:
      http://varkon.sourceforge.net/man_1.19D/index.htm

      To finish the installation and start Varkon, follow the instructions
      in the System administrators manual at:
      VARKON_ROOT/man/sysadm/index.htm

      Varkon 1.19D includes new functionality as well as bugfixes. You will find
      a link to the releasenotes on the start page of the Varkon documentation.

      To get in contact with the developers or with other Varkon users,
      please post a message to the Varkon mailing list. Bug reports or
      feature requests are posted through the tracker on the Sourceforge
      project site. See http://sourceforge.net/projects/varkon


      Information for Linux users
      ---------------------------

      Version 1.19D of VARKON for Linux is dynamically linked to the
      following Linux libary modules (printout from ldd):

        linux-gate.so.1 =>  (0xffffe000)
        libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x4003c000)
        libXext.so.6 => /usr/X11R6/lib/libXext.so.6 (0x40135000)
        libXpm.so.4 => /usr/X11R6/lib/libXpm.so.4 (0x40143000)
        libGL.so.1 => /usr/lib/libGL.so.1 (0x40159000)
        libGLU.so.1 => /usr/lib/libGLU.so.1 (0x401c0000)
        libtiff.so.3 => /usr/lib/libtiff.so.3 (0x4023f000)
        libm.so.6 => /lib/tls/libm.so.6 (0x40293000)
        libc.so.6 => /lib/tls/libc.so.6 (0x402b9000)
        libdl.so.2 => /lib/libdl.so.2 (0x403d8000)
        libpthread.so.0 => /lib/tls/libpthread.so.0 (0x403dc000)
        libXxf86vm.so.1 => /usr/X11R6/lib/libXxf86vm.so.1 (0x403ee000)
        libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x403f3000)
        libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x404d0000)
        libjpeg.so.62 => /usr/lib/libjpeg.so.62 (0x404db000)
        libz.so.1 => /lib/libz.so.1 (0x404fb000)
        /lib/ld-linux.so.2 (0x40000000)

      These files are not included in the Varkon distribution.
      If you don't have these files on your Linux system we
      recommend you to download them from your Linux site or
      try an older version of Varkon. Varkon 1.15C is based
      on libc.so.5 and might work better if you have an older
      version of Linux.

      OpenGL
      ------

      The binary version of Varkon 1.19D is comiled and linked on
      a Linux system with Suse Linux 10.0. This Linux distribution
      and many others of recent date include support for OpenGL so
      normally you should not need to do anything to get OpenGL
      working.

      If your system does not include support for OpenGL you must
      install OpenGL on your system.

      TIFF
      ----

      Varkon by default supports the output of TIFF images from
      OpenGL windows. You can turn off TIFF support in the top
      level makefile. See VARKON_ROOT/sources/README.

      ODBC
      ----

      The binary version of Varkon for Linux does not include support
      for ODBC. If you need ODBC support you must build Varkon from
      the sources. See VARKON_ROOT/sources/README_ODBC.


      Good Luck

      The CAD research group
      School of Science and Technology
      Orebro University
      S-70182 Orebro
      SWEDEN