From e69c6ea2b47d99462f72100bb127a9c8c65bccf5 Mon Sep 17 00:00:00 2001
From: David Werner <david.werner@posteo.de>
Date: Thu, 3 Feb 2011 16:17:12 +0000
Subject: [PATCH] section about application of patches

git-svn-id: svn://svn.iws.uni-stuttgart.de/DUMUX/dumux/trunk@5172 2fb0f335-1f38-0410-981e-8018bf24f1b0
---
 doc/handbook/install.tex | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/doc/handbook/install.tex b/doc/handbook/install.tex
index 2944a0b9e3..1c89091798 100644
--- a/doc/handbook/install.tex
+++ b/doc/handbook/install.tex
@@ -182,7 +182,29 @@ $ checkout-dumux -h      # show help,
 $ checkout-dumux -gme -u joeuser -p password -d DUMUX 
 \end{lstlisting}
 
+\subsection{Patching \Dune or external libraries}
+Patching of \Dune modules in order to work together with \Dumux
+can be necessary for various reasons. \\
+
+Software like a compiler or even a standard library
+changes at times. But a certain release of a software-component, we depend on, does not reflect that change.
+In developing process of software which depends on other modules, it is not always feasible 
+to adapt it to the most recent version of module of the day. That's why for serious errors 
+there exist patches or they are be brought into existence, which fix problems with a certain module
+of a certain release but do not introduce to much structural change. It can also happen 
+that a release gets amendments (updates) and a formerly useful patch gets obsoleted.\\
+
+\Dumux carries within directory \texttt{dumux/patches} patches and documentation about their usage and application.
+Please check the README file in that directory for recent informations. 
+At the time of this writing one patch has to applied as follows, but things may vary over time.
 
+\begin{lstlisting}[style=Bash]
+$ # make sure you are in DUNE-Root
+$ cd dumux-istl
+$ patch -p1 < ../dumux/patches/dune-istl-2.0.patch
+\end{lstlisting}
+
+The \texttt{checkout-dumux} script will also apply patches, if not explicitly requested to do not so.
 
 \subsection{Build of \Dune and \Dumux}
 \label{buildIt}
-- 
GitLab