made spell check with newFolder, tutorial-coupled and install and corrected description of the required parameters for Dirichlet and boundaryTypes methods

doc/handbook/install.tex

@@ -20,7 +20,7 @@ If it is used as directory's path of a shell command it is typed as \texttt{\Dun
 For the real {\Dune} root directory on your file system any valid directory name can be chosen.
 
 Source code files for each \Dune module are contained in their own subdirectory within {\Dune}-Root.
-We name this directory of a certain module ``module root directory" or \texttt{module-root-directory} if it is a directory path's,
+We name this directory of a certain module ``module root directory" or \texttt{module-root-directory} if it is a directory path,
 e.g. for the module \texttt{dumux} these names are  ``dumux root directory" respective \texttt{dumux-root-directory}.
 The real directory names for modules can be chosen arbitrarily, in this manual they are the same as the
 module name or the module name extended by a version number suffix.

doc/handbook/newFolder.tex

@@ -1,20 +1,20 @@
 \section{Setup of a New Folder}
 
-In this section setting up a new folder is described. In fact it is very easy to create a new folder, but getting \Dumux to know the new folder takes some steps which will be explained in mroe detail below:
+In this section setting up a new folder is described. In fact it is very easy to create a new folder, but getting \Dumux to know the new folder takes some steps which will be explained in more detail below:
 
 \begin{itemize}
  \item create new folder with content
  \item adapt \verb+Makefile.am+
  \item insert new folder in \verb+Makefile.am+ of the directory above
- \item adapt \verb+configure.ac+ in the \verb+$DUMUX_ROOT+ (the directory you checked out, probably dune-mux)
+ \item adapt \verb+configure.ac+ in the \verb+$DUMUX_ROOT+ (the directory you checked out, probably dumux)
  \item newly compile \Dumux
 \end{itemize}
 
 \noindent In more detail:
 
-\textbf{First} of all, the new folder including all relevant files needs to be created (see Section \ref{tutorial-coupled} and \ref{tutorial-decoupled} for desccription of a problem). 
+\textbf{First} of all, the new folder including all relevant files needs to be created (see Section \ref{tutorial-coupled} and \ref{tutorial-decoupled} for description of a problem). 
 
-\textbf{Second}, a new \verb+Makefile.am+ for the new Folder needs to be created. It is good practize to simply copy an existing file. For example the file \verb+$DUMUX_ROOT/test/2p/Makefile.am+ looks as follows:
+\textbf{Second}, a new \verb+Makefile.am+ for the new Folder needs to be created. It is good practice to simply copy an existing file. For example the file \verb+$DUMUX_ROOT/test/2p/Makefile.am+ looks as follows:
 \begin{verbatim}
 bin_PROGRAMS = test_2p
 
@@ -25,7 +25,7 @@ test_2p_LDADD = $(MPI_LDFLAGS)
 include $(top_srcdir)/am/global-rules
 \end{verbatim}
 
-All occurences of \verb+test_2p+ need to be replaced by the name of the new project, e.g. \verb+New_Project+. At least if the name of the source file as well as the name of the new project are \verb+New_Project+.
+All occurrences of \verb+test_2p+ need to be replaced by the name of the new project, e.g. \verb+New_Project+. At least if the name of the source file as well as the name of the new project are \verb+New_Project+.
 
 \textbf{Third}: In the directory above your new Project there is also a \verb+Makefile.am+ . In this file the subdirectories are listed. As you introduced a new subdirectory, it needs to be included here. In this case the name of the new Folder is \verb+New_Project+ . Don't forget the trailing backslash.
 

doc/handbook/tutorial-coupled.tex

@@ -275,41 +275,43 @@ The problem class always has at least five methods:
   condition.
 \end{itemize}
 
-Methods which make statements about boundary segments of the grid (i.e. 
+For the definition of the the boundary condition types and of the values of the Dirichlet boundaries,
-\texttt{boundaryTypes()}, \texttt{dirichlet()} and \texttt{neumann()}) get 
+two parameters are required: 
-six parameters. The first parameter differs if the type of the boundary condition
-is defined \texttt{boundaryTypes()}:
 \begin{description}
-\item[BCtypes:] A container which stores the type of the boundary condition
+ \item [values:]  A vector which stores the result of the method. What
-for each equation. For the typical case where all equations have the same boundary
+  the values in this vector mean is depending on the method: For
-condition at a certain position, there are two methods that set the appropriate conditions
+  \texttt{dirichlet()} it contains the actual values of the primary
-for all primary variables / equations: Either \texttt{setAllDirichlet()} or \texttt{setAllNeumann()}.
+  variables, for \texttt{boundaryTypes()} it contains the boundary 
+  condition type. It has as many entries as the model has primary variables / equations.
+  For the typical case where all equations have the same boundary
+  condition at a certain position, there are two methods that set the appropriate conditions
+  for all primary variables / equations: Either \texttt{setAllDirichlet()} or \texttt{setAllNeumann()}
+ \item [vertex:] The boundary condition and the Dirichlet values are specified at the vertex, which represents a
+  subcontrol volume. This avoids to specify two different boundary condition types at one subcontrol volume. 
+  Be aware that the second parameter is a Dune grid entity with the codimension dim. 
+\end{description}
+
+To ensure that no boundaries are undefined, a small safeguard value \texttt{eps\_}
+is usually added when comparing spatial coordinates. The left boundary is
+hence not assigned where the first coordinate is equal to zero, but where it is
+smaller than a very small value \texttt{eps\_}.
+
+Methods which make statements about boundary segments of the grid (i.e. 
+\texttt{neumann()}) get six parameters:
+\begin{description}
+\item[values:] A vector \texttt{neumann()}, in which the mass fluxes per area unit
+  over the boundary segment are specified.
 \item[element:] The element of the grid where the boundary segment
   is located.
 \item[fvElemGeometry:] The finite-volume geometry induced on the
   finite element by the box scheme.
-\item[isIt:] The \texttt{IntersectionIterator} of the boundary
+\item[isIt:] The \texttt{Intersection} of the boundary
-  segement as given by the grid
+  segment as given by the grid.
 \item[scvIdx:] The index of the sub-control volume in
   \texttt{fvElementGeometry} adjacent to the boundary segment.
 \item[boundaryFaceIdx:] The index of the boundary face in
   \texttt{fvElementGeometry} which represents the boundary segment.  
 \end{description}
-To ensure that no boundaries are undefined, a small safeguard value \texttt{eps\_}
-is usually added when compariing spatial coordinates. The left boundary is
-hence not assigned where the first coordinate is equal to zero, but where it is
-smaller than a very small value \texttt{eps\_}.
-
-After the type of the boundary condition is defined, their values have to be
-assigned with the methods \texttt{dirichlet()} and \texttt{neumann()} which only differ 
-by the first function parameter:
-\begin{description}
- \item[values:] A vector which stores the result of the method. What
-  the values in this vector mean is dependent on the method: For
-  \texttt{dirichlet()} it contains the values of the primary
-  variables, for \texttt{neumann()} the mass fluxes per area unit
-  over the boundary segment.
-\end{description}
 
 Similarly, the \texttt{initial()} and \texttt{source()} methods
 specify properties of sub-control volumes and thus only get
@@ -321,7 +323,10 @@ methods. If the isothermal two-phase model is used, this includes
 for example a \texttt{temperature()} method which returns the temperature in Kelvin
 of the fluids and the rock matrix in the domain. This temperature is
 then used by the model to calculate fluid properties which possibly
-depend on it, e.g. density.
+depend on it, e.g. density. The \texttt{bboxMax()} method that is used here, is a vector
+that provides information about the spatial extends of the simulation domain. This method 
+and the respective \texttt{bboxMin()} method
+can be found in the base class \texttt{Dumux::BoxProblem<TypeTag>}.
 
 
 \subsection{Defining fluid properties}\label{tutorial-coupled:description-fluid-class}
@@ -425,7 +430,7 @@ to make some small changes in the tutorial files.
 \begin{enumerate}
 
 \item \textbf{Run the Model} \\
-To get an impression what the results should look like you can first run the original version of the coupled tutorial model by typing  \texttt{./tutorial\_coupled 5e5 10}. The first number behind the simulation name defines the timespan of the simulation run in seconds, the second number defines the initial time step size. Note that the time step size is automatically optimized during the simulation. For the visualisation with paraview please refer to \ref{quick-start-guide}.\\
+To get an impression what the results should look like you can first run the original version of the coupled tutorial model by typing  \texttt{./tutorial\_coupled 5e5 10}. The first number behind the simulation name defines the timespan of the simulation run in seconds, the second number defines the initial time step size. Note that the time step size is automatically optimized during the simulation. For the visualization with paraview please refer to \ref{quick-start-guide}.\\
 
 \item \textbf{Changing the Model Domain and the Boundary Conditions} \\
   Change the size of the model domain so that you get a rectangle with
@@ -446,13 +451,13 @@ To get an impression what the results should look like you can first run the ori
 Now you can change the fluids. Use DNAPL instead of Oil and Brine instead of Water. To do that you have to select different components via the property system in the problem file:
 \begin{enumerate}
  \item Brine: The class \texttt{Dumux::Brine} acts as a adapter to the fluid system that alters a pure water class by adding some salt. Hence, the class \texttt{Dumux::Brine} uses a pure water class, such as \texttt{Dumux::H2O}, as a second template argument after the data type \texttt{<Scalar>} as a template argument (be aware to use the complete water class with its own template parameter).
- \item DNAPL: A standard set of chemical substances, such as Oil and Brinde, is already included (via a list of \texttt{\#include ..} commandos) and hence easy accessible by default. This is not the case for the class \texttt{Dumux::SimpleDNAPL}, however, which is located in the folder \texttt{dumux/material/components/}. Try to include the file as well as select the component via the property system.
+ \item DNAPL: A standard set of chemical substances, such as Oil and Brine, is already included (via a list of \texttt{\#include ..} commandos) and hence easy accessible by default. This is not the case for the class \texttt{Dumux::SimpleDNAPL}, however, which is located in the folder \texttt{dumux/material/components/}. Try to include the file as well as select the component via the property system.
 \end{enumerate}
 If you want to take a closer look how the fluid classes are defined and which substances are already available please browse through the files in the directory
 \texttt{/dumux/material/components}.
 
 \item \textbf{Use the \Dumux fluid system} \\
-\Dumux usually organises fluid mixtures via a \texttt{fluidsystem}. In order to include a fluidsystem you first have to comment the lines \ref{tutorial-coupled:2p-system-start} to \ref{tutorial-coupled:2p-system-end} in the problem file. If you use eclipse, this can easily be done by pressing \textit{str + shift + 7} -- the same as to cancel the comment later on.\\
+\Dumux usually organizes fluid mixtures via a \texttt{fluidsystem}. In order to include a fluidsystem you first have to comment the lines \ref{tutorial-coupled:2p-system-start} to \ref{tutorial-coupled:2p-system-end} in the problem file. If you use eclipse, this can easily be done by pressing \textit{str + shift + 7} -- the same as to cancel the comment later on.\\
 Now include the file \texttt{fluidsystems/h2o\_n2\_system.hh} in the material folder, and set a property \texttt{FluidSystem} with the appropriate type, \texttt{Dumux::H2O\_N2\_System<TypeTag>}. However, the complicated fluidsystem uses tabularized fluid data, which need to be initialized in the constructor body of the current problem by adding \texttt{GET\_PROP\_TYPE(TypeTag, PTAG(FluidSystem))::init();}, hence using the initialization function of the applied fluidsystem. As water flow replacing a gas is much faster, test your simulation only until 2e3 seconds and start with a time step of 1 second.\\
 Please reverse the changes of this example, as we still use bulk phases and hence do not need such an extensive fluid system.
 
@@ -488,7 +493,7 @@ When does the front cross the material border? In paraview, the option \textit{V
 \end{enumerate}
 
 \subsubsection{Exercise 2}
-For this exercise you should create a new proplem file analogous to
+For this exercise you should create a new problem file analogous to
 the file \texttt{tutorialproblem\_coupled.hh} (e.g. with the name 
 \texttt{ex2\_tutorialproblem\_coupled.hh} and new spatial parameters 
 just like \texttt{tutorialspatialparameters\_coupled.hh}. The new problem file needs to