=============================================================================
  @(#) $Name: arts++-1-1-a12 $
  @(#) $Id: INSTALL,v 1.5 2006/09/08 22:46:01 youngh Exp $
=============================================================================

Requirements
============
  GNU flex

    GNU flex is required, and lex is not supported (and never will be).
    You *must* use GNU flex and not lex when compiling this package.
    FlexLexer.hh must exist in your include path; if you have upgraded
    g++ since installing flex, you may need to copy it.

Quick Installation
==================
  ./configure
  make
  make install

  The default installation directory is /usr/local/arts/ (this may
  be changed by using --prefix with configure).

  After installation, you'll want to add the bin subdirectory of the
  installation path (usually /usr/local/arts/bin) to PATH in your
  environment, and add the man subdirectory of the installation path
  (usually /usr/local/arts/man) to MANPATH in your environment.  When
  you run 'make install' successfully, a message will be printed to
  remind you to add these settings to your environment.
  
  
Tested Platforms
================
  This package has been compiled and used at CAIDA on the platforms
  listed below.  This does not in any way indicate the portability of
  this software nor the stability.  It merely indicates what operating
  systems on which this package is relatively easy for CAIDA to support.
  Versions of g++ prior to 2.95.1 are not recommended, especially
  in light of the C++ standard and STL improvements after g++ 2.8.1
  (most of them were also in egcs-1.1.x).

  If you're using another compiler, my odds of being able to help you 
  with problems are slim to none, but that doesn't mean I won't try.

  Operating System		Compiler			Date
  --------------------		------------------------------	------------
  Linux 2.6.15 x86_64 (Ubuntu)	g++ 4.0.3			Sep 8, 2006
  FreeBSD 6.1 Intel		g++ 3.4.4			Sep 8, 2006
  FreeBSD 5.4 Intel		g++ 3.4.2			Sep 8, 2006
  FreeBSD 4.8 Intel		g++ 3.4.0			Dec 13, 2004
  FreeBSD 4.8 Intel		g++ 3.2.2			Apr 23, 2004
  FreeBSD 4.8 Intel		g++ 2.95.4			Apr 23, 2004

  FreeBSD 3.3 Intel		g++ 2.95.1			Oct 18, 1999
  Linux 2.0.34 Intel (debian)	g++ 2.95.1			Oct 18, 1999
  Linux 2.2.10 Intel (debian)	g++ 2.95.1			Oct 18, 1999
  Sparc/Solaris 2.7		g++ 2.95.1			Oct 18, 1999
  Sparc/Solaris 2.6		g++ 2.95.1			Oct 18, 1999
  FreeBSD 3.2 Intel		g++ 2.95			Aug 20, 1999
  Linux 2.2.10 Intel (debian)	g++ 2.95			Aug 20, 1999
  Linux 2.0.34 Intel (debian)	g++ 2.95			Aug 20, 1999
  Sparc/Solaris 2.7		g++ 2.95			Aug 20, 1999
  Sparc/Solaris 2.6		g++ 2.95			Aug 20, 1999
  FreeBSD 3.1 Intel		egcs-1.1.2			Jun 30, 1999
  FreeBSD 3.0 Intel		egcs 1.1.1			Jan 24, 1999
  FreeBSD 3.0 Intel		g++ 2.8.1, libstdc++ 2.8.1.1	Jan  9, 1999
  FreeBSD 2.2.5	Intel		g++ 2.8.1, libstdc++ 2.8.1.1	Oct  1, 1998
  FreeBSD 2.2.6	Intel		g++ 2.8.1, libstdc++ 2.8.1.1	Oct  1, 1998
  FreeBSD 2.2.7	Intel		g++ 2.7.2.1			Oct  1, 1998
  FreeBSD 2.2.7	Intel		g++ 2.8.1, libstdc++ 2.8.1.1	Oct  1, 1998
  Linux 2.0.35 Intel		g++ 2.7.2.3			Oct  1, 1998
  Sparc/Solaris 2.5.1		g++ 2.7.2.3			Oct  1, 1998
  Sparc/Solaris 2.6		g++ 2.8.1			Oct  1, 1998
  Sparc/Solaris 2.7		egcs 1.1.1			Feb  8, 1999
  Sparc/Solaris 2.7		g++ 2.8.1, libstdc++ 2.8.1.1	Feb  8, 1999

Other Platforms
===============
  There's no reason to believe that this software will not work on other
  UNIX platforms with g++ 2.7.2.3 or greater.  There's also no reason to
  believe it will work.  ;-)  However, I have received reports from the
  field of the following working platforms:

  Operating System	Compiler			Date
  --------------------	------------------------------	------------
  Digital UNIX 4.0B	g++ 2.8.1			Jan  4, 1999
  BSDI BSD/OS 3.1	g++ 2.8.1, libstdc++ 2.8.1.1	Jan 10, 1999
  BSDI BSD/OS 4.0	g++ 2.7.2.1			Jan 11, 1999

Compiler Optimization
=====================
  I've had no problems using 'make "CXX=g++ -O2"' on the "Tested Platforms"
  listed above, but caveat emptor.  If you have problems compiling with -O2
  optimization and g++ 2.7.2.3 or greater, please let me know.

=============================================================================
