Darcs installation

From Gerris

Jump to: navigation, search

The preferred way to install Gerris if you intend to contribute to the code is using the darcs version control system. Using darcs is also an easy way to keep your source code up to date with the most recent version of Gerris, even if you do not modify the source code.

To install darcs on an Ubuntu/Debian system do:

% sudo apt-get install darcs

For other systems have a look at the darcs installation page.

To get the latest version of Gerris using darcs do:

% darcs get --partial http://gfs.sf.net/darcs/gerris/gerris-stable

This will create a darcs repository called gerris-stable in the current directory.

Similarly you can get the latest version of GTS using:

% darcs get --partial http://gts.sf.net/darcs/gts-mainline

And the latest GfsView version using:

% darcs get --partial http://gfs.sf.net/darcs/gfsview/gfsview-mainline

To be able to install GTS, gerris and GfsView you need to create the configure scripts using the standard GNU Autotools. Gerris depends on a version of automake greater than or equal to 1.6. To install automake on an Ubuntu/Debian system do:

% sudo apt-get install automake1.8

You can then create and run the configure scripts using:

% cd gts-mainline
% sh autogen.sh
% cd ../gerris-stable
% sh autogen.sh
% cd ../gfsview-mainline
% sh autogen.sh

You are then ready to compile and install Gerris. Follow the instructions on how to compile and install GTS, Gerris and GfsView from source.

Upgrading the sources using darcs

Upgrading a repository using darcs is very simple. Assuming you got the gts-mainline repository using the instructions above, you can get any new patch from the repository using:

% cd gts-mainline
% darcs pull

This command will check for new patches on the http://gts.sf.net/darcs/gts-mainline repository and will ask if you want to merge them into your current repository.

You can then compile and install the new version using:

% make
% make install

In some cases (when there have been substantial changes to the Makefiles etc...) you may need to refresh the configure scripts manually using:

% sh autogen.sh

before starting the compilation.

Note also that since GfsView depends on Gerris and Gerris depends on GTS, you will need to upgrade GTS, Gerris and GfsView in this order.

Personal tools
communication