ls***********
* CONTENT *
***********

**************
Update history
**************

Release 1.5 - January, 1999
  New features:
    - two-parameter continuation of codim 1 bifurcations of iterated 
      maps with detection of all codim 2 points;
    - numerical time-integration of 1D PDEs;
    - Tutorial and Developer's Guides.
  
IMPORTANT NOTE: From this release on, complete source files of Content 
    are available, together with necessary make files and instructions
    how to compile it on any of supported platforms. 
       
    
Release 1.4 - January, 1998
  New features:
    - new class of dynamical systems is supported: differential-
      algebraic equations (DAEs) Mx'=f(x,p) with possibly singular
      matrix M; 
    - numerical integration of stiff ODEs and DAEs using RADAU5
      code;
    - three-parameter continuation of all codim 2 bifurcations
      of ODEs (cusp, Bogdanov-Takens, generalized Hopf, zero-Hopf,
      and double Hopf);
    - two-parameter continuation of Hopf bifurcation using
      the bordered squared Jacobian matrix;
    - symbolical calculation of derivatives of the 4th order
      using the Maple system.

  Warning:
    Staircase window support was reimplemented.
    Precaution before installation of this version:
    close all such windows (for each system in your archive).
    Don't try to import systems exported by the previous release
    AND containing staircase window(s). Please, feel free
    to contact us if you need to import old-style systems.

Release 1.3 - August, 1997
  New features:
    - one-parameter continuation of limit cycles in ODEs;
    - detection and normal form analysis of codim 1 bifurcations
      of limit cycles;
    - one-parameter continuation of fixed points of iterated maps;
    - detection and normal form analysis of codim 1 bifurcations
      of iterated maps;
    - 3D graphic windows;
    - Staircase window for scalar iterated maps.
  Warning:
    The format of exported systems has been altered. Unfortunately,
    this might cause inability to import previously exported
    systems.

*********************
Software requirements
*********************

1. Unix

C and C++ compilers must be accessible via PATH variable.

X11, X toolkit and Motif libraries should be accessible;
add also the current directory.
This can be done by setting the LD_LIBRARY_PATH variable, e.g.

  setenv LD_LIBRARY_PATH .:/usr/dt/lib  (csh)
  export LD_LIBRARY_PATH=.:/usr/dt/lib  (ksh)

IMPORTANT NOTE: Which files should be modified in order to
make this settings permanent depends on your local system 
environment. We strongly recommend you to consult your
system manager.


2. MS_Windows

Borland C++ 5.01 of Free Borland C++ 5.5.1 command line tools should be be installed.
CONTENT uses only command line compiler bcc32.


************************************  
INSTALLATION OF THE COMPILED VERSION
************************************

1. Where to put compiled CONTENT
--------------------------------

First of all create a directory for CONTENT
and make it the current directory.

1.1 Unix

  mkdir content
  cd content

1.2 MS_Windows

  cd \
  mkdir content
  chdir content


2. How to get compiled CONTENT
------------------------------

Compiled CONTENT is available at 

http://www.math.uu.nl/people/kuznet/CONTENT

Copy source_file to target_file.

Here source_file is one of the following:

  content-1.5-sgi-irix6.2.tar.gz             (1)
  content-1.5-sun-sunos5.5.tar.gz
  content-1.5-sun-sunos5.8.tar.gz
  content-1.5-decalpha-osf1v3.2.tar.gz       (2)
  content-1.5-hp-hpuxB.10.20.tar.gz      
  content-1.5-ibmpc-linux.mandrake7.0.tar.gz (3)
  content-1.5-ibmpc-linux.suse7.0.tar.gz     (4)
  content-1.5-ibmpc-linux.suse8.0.tar.gz
  content-1.5-ibmpc-mswin.bcc50.zip          (5)
  content-1.5-ibmpc-mswin.bcc55.zip          (6)
  content-1.3-aix-aix.4.tar.gz               (7)

These files contain binary executables for running
on the corresponding platform (hardware+OS[.complier]).
The executables should also run under higher versions of
the operating systems.

The target_file is:

  content.tar.gz for Unix (SGI, Sun, DEC, HP, PC Linux)
  content.zip for MS Windows

Notes:
(1) 32-bit objects, i.e. -32 option was set for cc and ld.
(2) both c++ and cxx.
(3) Mandrake Linux 7.0 with Open Motif 2.1
(4) SuSE Linux 7.0 with Open Motif 2.1 
(5) Borland C++ 5.01 and Windows 95/98/NT/ME/2000
(6) Free command line Borland C++ 5.5.1 and Windows 95/98/NT/ME/2000/XP 
(7) AIX Version 4. Compiled without optimization to avoid
    a bug.


3. How to unpack compiled CONTENT
---------------------------------

3.1 Unix

  gunzip content.tar.gz    (or gzip -d content.tar.gz)
  tar -xvpf content.tar

3.2 MS-Windows

  pkunzip -d content.zip

(it is assumed that you have pkunzip installed; otherwise,
copy pkunzip.exe from pub/CONTENT/src/windows).


****************************************
COMPILATION OF CONTENT FROM SOURCE FILES
****************************************

Source files of CONTENT are also available at 

http://www.math.uu.nl/people/kuznet/CONTENT

in unix OR windows directory (depending on the platform)
  
Please, follow instructions from the corresponding HOW_TO file.  

IMPORTANT NOTE: Compilation of Content requires some knowleadge of
   C/C++ and the operating system. We strongly recommend you to 
   consult your system manager, if problems occur.


************************
How to configure CONTENT
************************

1. Full setup
-------------

This step must be done only once. It creates files
used by all the users of CONTENT.

1.1 Unix

a. Run content installation program:

  setup

b. Set Installation switch to Full.

c. If necessary, correct the name of C++ compiler and/or
its options.

d. If necessary, choose shell style and/or specify its full path
and options. IMPORTANT: specify -f option for csh.
By default CONTENT uses the value of the SHELL variable.
Check that default hardcopy settings are
valid on your machine.

e. Press the Setup button.


1.2 MS-Windows

a. Under Windows run content installation program setup.exe
using the Run menu. Be sure that the FULL path to the program
is specified, e.g. \content\setup.exe.

b. Set Installation switch to Full.

c. Check that the Settings file field contains the full path
to the Windows directory. Setup will create content.ini
file in this directory.

d. Check that the paths in the Compiler's options fields
are valid on your machine.

e. Press the Setup button.

Note. For local network (client-server installation)
these steps should be performed on the server by the
superviser.


2. How to configure CONTENT for an individual user 
--------------------------------------------------

Each user of CONTENT should create a separate directory where
CONTENT will keep user specific data.

2.1 Unix

a. Create the user directory and change to it, e.g.:

  mkdir usercont
  cd usercont

b. Add the full path to content and the user directories to your
PATH variable, e.g.

  setenv PATH .:$HOME/usercont:$PATH  (csh)
  export PATH=.:$HOME/usercont:$PATH  (ksh)

c. Run content installation program being in the user
directory:

  setup

d. Set Installation switch to User.

e. Type in the full path to the content directory in
the CONTENT directory field.

f. Press the Setup button.


2.2 MS-Windows

a. Create the user directory/folder, e.g. usercont.

b. Run content installation program setup.exe
using the Run menu. Be sure that the FULL path to the program
is specified, e.g. \content\setup.exe.

c. Set Installation switch to User.

d. Type in the full path to the content directory in
the Home field.

e. Check that the paths in the Compiler's options fields
are valid on your machine.

f. Press the Setup button.

g. Create icon/shortcut for CONTENT. Specify
full path to the content directory and
make sure that the user directory is the
Working/Start in directory.

IMPORTANT NOTE: For local network (client-server installation)
these steps should be performed on the client PC.


******************
How to run CONTENT
******************

Now you can run CONTENT.

1. Unix

Change to the user directory (e.g. usercont)
and type in

  content -bg gray


1. MS-Windows

Double click the icon/shortcut created for CONTENT.


********************
Examples and manuals
********************

1. Example files
----------------

The content directory contains the subdirectory

    examples

with exported example systems. They are grouped
in four subdirectories

    Maps   ODEs   PDE1s   DAEs

You can import them while running CONTENT and explore
the systems, e.g. recompute stored curves.

2. Tutorial
-----------

The ftp.cwi.nl/pub/CONTENT/man directory contains the files

Content_tutor_html.tar.gz
Tutor.ps.gz
Content_tutor_html.zip

Applying gunzip (or pkunzip), produces a PostScript or HTML
version of the Content Tutorial.

Warning: The resulting files are very big, since they contain
  screen copies!
  
3. Developer's Guide
--------------------

The ftp.cwi.nl/pub/CONTENT/dev directory contains the files

dev.ps.gz
dev_man.zip

Applying gunzip (or pkunzip), produces a PostScript file with
the Developer's Guide to Content. It is designed for experienced
programmers who will extend Content features.


********
Feedback
********

Complaints, suggestions, and impressions may be directed to:
  
  Yuri Kuznetsov, kuznet@math.uu.nl

21.01.2003