From 936705e89a3b51010a8eeb7ec7fc4871d3971cd2 Mon Sep 17 00:00:00 2001
From: Alexander Kissinger <alexander.kissinger@iws.uni-stuttgart.de>
Date: Thu, 26 Sep 2013 14:58:00 +0000
Subject: [PATCH] Added some basic svn usage in the handbook section 4.3.
Reviewed by Lena.
git-svn-id: svn://svn.iws.uni-stuttgart.de/DUMUX/dumux/trunk@11573 2fb0f335-1f38-0410-981e-8018bf24f1b0
---
doc/handbook/newFolder.tex | 24 +++++++++++++++++++++++-
1 file changed, 23 insertions(+), 1 deletion(-)
diff --git a/doc/handbook/newFolder.tex b/doc/handbook/newFolder.tex
index a15b29083c..c9f84c097d 100644
--- a/doc/handbook/newFolder.tex
+++ b/doc/handbook/newFolder.tex
@@ -50,7 +50,29 @@ All occurrences of \verb+test_2p+ need to be replaced by the name of the new pro
\textbf{Fifth}: Recreate the build system by running dunecontrol as described in Section \ref{install}.
\paragraph{Committing a new folder to the Subversion repository}
-For those who work with Subversion (svn) and want to commit a newly setup folder to the repository, additional guidelines apply:
+For those who work with Subversion (svn) and want to commit a newly setup folder to the repository some basics are
+given in this paragraph. For further reading please check out the Subversion User Manual found at \cite{APACHE-SUBVERSION-HP}
+where you will also find a "High Speed Turorial" in the appendix. \\
+The four most important commands are \texttt{svn checkout}, \texttt{svn update}, \texttt{svn add}
+and \texttt{svn commit}. The first one (\texttt{svn checkout}) you probably already know from the \Dumux installation.
+It will create a copy of the trunk version from the svn server on your local system. Use \texttt{svn update} to get the
+latest changes in the repository (commits from other users). In order to add a new folder to the repository the following
+steps have to be taken:
+
+\begin{enumerate}[1)]
+ \item \texttt{svn update}: The first step is to update your \Dumux. You should execute this command in your
+dumux-stable or dumux-devel folder.
+ \item \texttt{svn add --depth=empty YOURFOLDER}: This command adds the folder without its content.
+ \item In your folder: use \texttt{svn add YOURFILES} to add your files. Generally, you should only add
+your header files (.hh), your source files (.cc), your input file (.input) and if required your grid file (.dgf).
+\item Use \texttt{svn commit} from the directory level containing your folder. This uploads all your changes to the
+svn server. You will be asked to briefly explain the content of your commit in an editor.
+\end{enumerate}
+
+The above shows you the necessary steps if you use the command line. There are also other tools providing a graphical
+user interface for using svn like kdesvn or eclipse. The necessary steps for adding and committing stay the same.
+In the following some additional guidelines are shown which are not necessary but are good practice.
+Especially if you plan on committing to the stable part of \Dumux you must follow these steps.
\begin{enumerate}[1)]
\item use svn attributes to ignore files which are automatically created by a dunecontrol run
--
GitLab