This collection of files is provided with the intention of helping you set up
your new FEniCS application. Using this layout and structure will promote
uniformity among all FEniCS-Apps but it is no requirement so feel free to
make changes and adjustments. However, the files
AUTHORS, COPYING, INSTALL and README are needed as is a set of demo files,
see the FAQs http://www.fenics.org/wiki/FEniCS_Apps_FAQ for an explanation.

Most files in this directory and the subdirectories should be modified in
accordance with your needs, including this one.

Please add the following basic information at the top of all relevant files:

Copyright, license and when the file was first added and last changes. e.g.,

// Copyright (C) 2006-2008 Kristian Oelgaard and Garth N. Wells.
// Licensed under the GNU LGPL Version 3.
//
// First added:  2006-11-13
// Last changed: 2008-11-17

                                                              (insert date)
NewApp:
------------------

(description)


Contents
--------

  1. Dependencies
  2. Installation
  3. Compiling against the library
  4. Feedback
  5. License


1. Dependencies
------------

The intention is to keep the NewApp in sync with the
development versions of the FEniCS components. Once the interfaces
have stabilised (mainly a DOLFIN issue) the aim is to have both a 
stable version of the NewApp library and a development version.
This is expected to happen once DOLFIN version 1.0.0 is released.

* DOLFIN  changeset: ?
* FFC     changeset: ?
* FIAT    changeset: ?
* UFC     changeset: ?
* UFL     changeset: ?

2. Installation:
-------------

See ./INSTALL


3. Compiling against the library:
------------------------------

To compile against the NewApp library you first need to update the system
variables LD_LIBRARY_PATH and PKG_CONFIG_PATH. This is most conveniently done
by sourcing the file new-app.conf

  source new-app.conf

Then you'll need to create a SConstruct file that looks something like:

import commands
import os

# Get compiler from pkg-config
compiler = commands.getoutput('pkg-config --variable=compiler dolfin')

# Create a SCons Environment based on the main os environment
env = Environment(ENV=os.environ, CXX=compiler)

# Get cflags and libs from DOLFIN and NewApp
env.ParseConfig('pkg-config --cflags --libs dolfin')
env.ParseConfig('pkg-config --cflags --libs new-app')

# Build program
env.Program('demo', 'main.cpp')


4. Feed back:
------------

Feed back, patches, and comments should be sent to

    fenics-apps@fenics.org

    or to the maintainers:

    (Your contact info)


5. License:
--------

This library is licensed under the GNU LGPL Version 3.0, see ./COPYING.LESSER




