
Copyright (C) 2007, 2008, 2009
  Harish Narayanan <harish@simula.no>
Licensing information follows a little later in this file.

This directory tree holds Dorsal, a set of simple scripts to build
DOLFIN and the rest of the FEniCS entourage (as well as their
dependencies) for various platforms.

Currently, Dorsal supports the following environments:

   Debian GNU/Linux 4.0, 5.0, unstable    (etch, lenny, sid)
   Fedora 10, 11                          (fedora10, fedora11)
   Mac OS X 10.4, 10.5, 10.6 (with Fink)  (tiger, leopard, snowleopard)
   openSUSE 11.1                          (opensuse11)
   Red Hat Enterprise Linux 4, 5          (rhel4, rhel5)
   Ubuntu 8.04 LTS, 8.10, 9.04, 9.10      (hardy, intrepid, jaunty, karmic)

If your favourite platform is not on the list above, please let us
know about it, and we can work together toward adding it.

In order to use Dorsal on a supported platform, you need to first
tweak dorsal.cfg to your liking and then invoke the build script by
running:

   ./dorsal.sh

If all goes according to plan, you should see a lot of
compilation-related text scroll past your screen and eventually end up
with a complete, up-to-date installation of various FEniCS projects
and their corresponding dependencies.

If you run into any problems, ensure that you've installed all the
preliminary dependencies for your platform (usually from the system
package manager) that Dorsal assumes you already have. An incomplete
list of this is provided in the .platform file for each platform,
along with platform-specific tips. In most cases, these should solve
your problem. If you're having further difficulty, please contact us
by e-mailing dorsal-dev@fenics.org.

Dorsal is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 3, or (at your option) any
later version.

This software is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this software; see the file COPYING. If not, write to the
Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
02111-1307, USA.
