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