README_HG

# Using Mercurial for FreeFem++ source files management
# ======================================================================
# Laboratoire Jacques-Louis Lions
# Université Pierre et Marie Curie-Paris6, UMR 7598, Paris, F-75005 France
# ======================================================================
# This file is part of Freefem++
# 
# Freefem++ is free software; you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as
# published by the Free Software Foundation; either version 2.1 of
# the License, or (at your option) any later version.
# 
# Freefem++ 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 Lesser General Public License for more details.
# 
# You should have received a copy of the GNU Lesser General Public
# License along with Freefem++; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
# ======================================================================
#+STARTUP: showeverything
# ======================================================================
# headeralh brief="Using Mercurial for FreeFem++ source files management" default=0 freefem multipleauthors org start=16/06/10 upmc

The main difference with the previous CVS setup is that every working
copy of FreeFem++ contains a complete Mercurial database of all source
files (in a subdirectory called '.hg').

* Creating a local copy of the FreeFem++ repository
** from the web
   hg clone http://www.freefem.org/ff++/ff++
** from another local directory
   hg clone /another/local/dir
** from another directory on a remote machine via ssh
   hg clone ssh://myself@remotemachine//another/directory
** create the ~/.hgrc  file  for commit 
[ui]
username = Nathan Phillip Brink <jsmith@ohnopublishing.net>  


* Working with a repository

  All the commands below should be run from a directory of the current
  working copy.

** Adding a file
   hg add filename
** Deleting a file
   hg remove filename
** Commiting all local changes to the local repository
   hg commit -m "description of changes"
** Checking if there are some uncommitted local changes
   hg status

* Exchanging changes with other repositories
** Pulling changes from another (readable) repository
  hg pull -u http://www.freefem.org/ff++/ff++
  hg pull -u /another/local/dir
  hg pull -u ssh://myself@remotemachine/remote/directory

** Pushing changes into another (writable) repository
  hg push /another/local/dir
  hg push ssh://myself@remotemachine/another/directory

* Official Mercurial documentation
  http://mercurial.selenic.com/guide

* Compile FreeFem++ 
** first to restore build file.use (automake  > 1.13) 
 autoreconf -i 
** or extract  build with 
 tar zxvf AutoGeneratedFile.tar.gz 
** build makefies
./configure --enable-download
** to build 
make 
** to check (warning some test fail )
make check
** install
sudo make install 


* File info
# Local Variables:
# mode:org
# mode:visual-line
# ispell-local-dictionary:"british"
# coding:utf-8
# End: