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