--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+ "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+ <link href="../screen.css" rel="StyleSheet">
+ <title>deal.II SVN Archive</title>
+ <meta name="author" content="the deal.II authors <authors@dealii.org>">
+ <meta name="copyright" content="Copyright (C) 1998, 1999, 2000, 2002, 2003, 2004, 2005, 2006, 2009 by the deal.II authors">
+ <meta name="date" content="$Date: 2006-07-24 10:37:21 -0500 (Mon, 24 Jul 2006) $">
+ <meta name="svn_id" content="$Id: writing-documentation.html 13428 2006-07-24 15:37:21Z bangerth $">
+ <meta name="keywords" content="deal dealii finite elements fem triangulation">
+ <meta http-equiv="content-language" content="en">
+</head>
+<body>
+
+ <h1>Documentation of the deal.II SVN Archive</h1>
+
+ <h2>The global structure</h2>
+
+
+ The root of the deal.II archive is located
+ at <a href="http://www.dealii.org/svn/dealii/">http://www.dealii.org/svn/dealii/</a>.
+ There, we can find three subdirectories:
+ <ul>
+ <li> The current version is found
+ in <a href="http://www.dealii.org/svn/dealii/trunk/">trunk</a>,
+ which contains the
+ directories <a href="http://www.dealii.org/svn/dealii/trunk/deal.II">deal.II</a>
+ with the library
+ and <a href="http://www.dealii.org/svn/dealii/trunk/tests">tests</a>
+ with the test suite.
+
+ <li> The
+ subdirectory <a href="http://www.dealii.org/svn/dealii/tags/">tags</a>
+ contains the released versions. They have the same
+ structure as the trunk.
+
+ <li> The
+ subdirectory <a href="http://www.dealii.org/svn/dealii/branches/">branches</a>
+ has cureently active branches with developments, that are not yet
+ scheduled to be incorporated into the library. Additionally, it has subdirectories
+ <ul>
+ <li> <a href="http://www.dealii.org/svn/dealii/branches/releases">releases</a>
+ with the branches on which the releases are,
+ <li> <a href="http://www.dealii.org/svn/dealii/branches/retired">retired</a>
+ with development branches which have been merged into the
+ trunk and are therefore not used anymore.
+ </ul>
+ </ul>
+
+ <h2>Creating a development branch</h2>
+
+ When starting new developments which cannot be checked in in a
+ single sweep, it is advised to create a development branch. In order
+ to keep this branch up-to-date with the trunk, the
+ program <tt>svnmerge</tt> can be used. Such a branch is created in
+ the following steps:
+
+ <ol>
+ <li> Create the branch using
+ <pre>
+ svn copy http://www.dealii.org/svn/dealii/trunk/ http://www.dealii.org/svn/dealii/branches/new-branch-name
+ </pre>
+ <li> Either check out the new branch or switch your working copy by
+ <pre>
+ svn switch http://www.dealii.org/svn/dealii/branches/new-branch-name
+ </pre>
+ This command assumes you are in the top level directory, the one
+ containing <tt>deal.II</tt> and <tt>tests</tt>
+ <li> Initialize the merge tracking svnmerge: in the top level directory, call
+ <pre>
+ svnmerge.py init
+ svn ci -F svnmerge-commit-message.txt
+ rm svnmerge-commit-message.txt
+ </pre>
+ This should be done before making any local changes!
+ </ol>
+</body>
+</html>
+