
-------------------------------------------------------------------------

				  surf

			     Version 1.0.6

	Copyright (C) 1996-1997 Friedrich-Alexander-Universitaet
  Erlangen-Nuernberg, 1997-2006 Johannes Gutenberg-Universitaet Mainz

  Authors: Stephan Endrass, Hans Huelf, Ruediger Oertel, Ralf Schmitt,
	  Kai Schneider and Johannes Beigel (see AUTHORS file)


  Projectteam 'Qualifizierung und Weiterentwicklung eines Software-Pakets
		 zur Darstellung reell-algebraischer Kurven und Flaechen'
  from Fachhochschule Frankfurt am Main (University of Applied Sciences)

  Project supervisor: Erich Selder
  Authors: Karen Gharslyan, Stephan Haasmann, Jonas Heil, Igor Krmcar,
	   Bingbing Li, Marcus Scherer, Sven Sperner, Suepriz Yaykan 

-------------------------------------------------------------------------


What is surf?
-------------

surf is a tool to visualize algebraic curves and algebraic surfaces.
surf is script driven and has a graphical user interface using the Gtk
widget set.

Documentation can be found in the docs/ directory.

Visit surf's homepage for more information:

		      http://surf.sourceforge.net


Required dependencys:
---------------------
    GNU gcc/g++ version 2.7.x or higher
    make
    cups
    GNU flex Version 2.5 or higher
    GTK+ Version 1.2.0 or higher (only if GUI is needed)
    POSIX Threads ( glibc2 on Linux)
    GNU MP(gmp) Version 2 or higher
    lib-tiff
    lib-jpeg
    zlib
    ps2pdf
    linux-kernel-header (on Suse Linux 11.x)
    lib-xmu


Tested on:
-------------
   openSUSE 11.x
   (k)ubuntu 9.x
   Debian 5.0
   Archlinux 
   Gentoo


Basic Installation:
-------------------

(see INSTALL for a more complete description)

   $ cd surf-1.0.6
   $ ./configure
   [ wait.. ]
   $ make
   [ ..wait even longer.. ]
   $ su
   [ enter root's password ]
   # make install
   # logout

Installation without CUPS-Support:
----------------------------------

(see INSTALL for a more complete description)

   $ cd surf-1.0.6
   $ ./configure --disable-cups
   [ wait.. ]
   $ make
   [ ..wait even longer.. ]
   $ su
   [ enter root's password ]
   # make install
   # logout

This will install the binary, some data and surf's man page.


Getting Started:
----------------

To get a first impression start surf in an xterm:

   $ surf

Then click on the "load script..." button to load one of the distributed
example scripts in the examples/ directory. Press the "execute script"
button, wait a few seconds and enjoy the output :)


License:
--------

surf is distributed under the terms of the GNU General Public License
version 2 or later. See also COPYING file.
