diff --git a/Doc/UserManual/Fitting.tex b/Doc/UserManual/Fitting.tex
index b5e15a4ee17e0ec85be7071fe24b6cc8f2b64408..c4bb4134b7a1d597046b40dfeda2a5fe079ccb84 100644
--- a/Doc/UserManual/Fitting.tex
+++ b/Doc/UserManual/Fitting.tex
@@ -103,8 +103,8 @@ output detector.
 In principle, every parameter used in the construction of the sample
 can be used as a fitting parameter. For example, the particles'
 heights, radii or the layer's roughness or thickness could be selected using
-parameter pool mechanism explained in \SecRef{WorkingWithSampleParameters} (we recommend
-reading of this section before proceeding further).
+parameter pool mechanism. 
+That mechanism is explained in details in \SecRef{WorkingWithSampleParameters} and it is recommended to read it before proceeding further.
 
 User specifies selected sample parameters as a fit parameter using \Code{FitSuite}
 and its \Code{addFitParameter} method
@@ -134,15 +134,52 @@ double values corresponding to the lower and higher boundary respectively.
 
 
 
-\subsection{Loading reference data.}
-These are the data to which the fitting model will
-be compared to. They usually refer to experimental data. We assume that it is a
-two-dimensional intensity matrix as function of the output scattering
-angles $\alpha_f$ and $\phi_f$ (see Fig.~\ref{fig:multil3d}). The user
-is required to provide reduced and \textbf{normalized} data. 
+\subsection{Associating reference and simulated data.}
+
+The minimization procedure deals with a pair of reference data (normally
+associated with experimental data) and the theoretical model (presented by the sample and the simulation descriptions).
+
+We assume that the experimental data is a two-dimensional intensity 
+matrix as function of the output scattering
+angles $\alpha_f$ and $\phi_f$ (see Fig.~\ref{fig:multil3d}).
+The user is required to provide the data in the form of ASCII file containing axes
+binning description and the intensity data itself. 
+\vspace*{2mm}
+
+\ImportantPoint{Remark:}{
+We recognize the importance of the support of most common data formats. We are going to provide
+this feature in the following releases and welcome user requests on that subject.
+}
+\vspace*{1mm}
+
+To associate the simulation with the reference data the method \newline
+\Code{addSimulationAndRealData} has to be used as shown
+\begin{lstlisting}[language=python, style=eclipseboxed,numbers=none]
+fit_suite = FitSuite()
+fit_suite.addSimulationAndRealData(<simulation>, <reference>, <chi2_module>)
+\end{lstlisting}
+
+here \Code{<simulation>} correspond to the \BornAgain\ simulation object with sample, beam and detector fully defined, \Code{<reference>} correspond to the experimental data object obtained from ASCII file and \Code{<chi2\_module>} is an optional parameter for advanced 
+control of $\chi2$ calculations.
+
+There is a possibility to call given method more than once to submit more than one pair of
+\Code{<simulation>, <reference>} to the fitting procedure and so to provide simultaneous fit of
+some combined data set.
+
+By using the third \Code{<chi2\_module>} parameter different normalization and weights
+can be applied to let the user fully control the way $\chi2$ is calculated.
+This feature will be explained in \SecRef{AdvancedFitting}.
+
 
 
 
+
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \subsection{Minimizer settings.}
 
 \BornAgain\ contains a variety of minimization engines from \Code{ROOT} and \Code{GSL}
@@ -227,8 +264,8 @@ There are several options common for every minimization algorithms, which can be
 before minimization starts. They are handled by \Code{MinimizerOptions} class:
 \begin{lstlisting}[language=python, style=eclipseboxed, numbers = none]
 options = MinimizerOptions()
-options.setMaxFunctionCall(10)
-FitSuite().getMinimizer().setOptions()
+options.setMaxFunctionCalls(10)
+FitSuite().getMinimizer().setOptions(options)
 \end{lstlisting}
 In given code snippet a number of ``maximum function calls'', namely a number of times the minimizer is allowed to call the simulation, is limited to the 10. The minimizer will take that number into consideration and will try to limit number of iterations by that value.
 
@@ -237,9 +274,19 @@ as a number of possibilities to tune individual minimization algorithms.
 They will be explained in \SecRef{AdvancedFitting}.
 
 
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\subsection{Running the fitting ant retrieving the results.}
+
 
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \input{FittingExamples}
 
+
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -248,14 +295,21 @@ They will be explained in \SecRef{AdvancedFitting}.
 \begin{itemize}
 \item It is recommended to start from default minimizer settings and turn to the fine tunings
 only after some experience has been acquired.
+\item error interpretation
 
 \end{itemize}
 
+
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 % 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \section {Advanced fitting.} \SecLabel{AdvancedFitting}
 
+\subsection{Affecting $\chi2$ calculations.}
+\subsection{Simultaneous fit of several data sets.}
+\subsection{Using fitting strategies.}
+\subsection{Masking the real data.}
+\subsection{Tuning fitting algorithms.}
 
 
 
diff --git a/Doc/UserManual/FittingExamples.tex b/Doc/UserManual/FittingExamples.tex
index b98058d15e2ff1ada709b62efc9c3fefe0b5ba56..a16b7872f33a7316b85450b1c015d41f1265b6a1 100644
--- a/Doc/UserManual/FittingExamples.tex
+++ b/Doc/UserManual/FittingExamples.tex
@@ -1,2 +1,2 @@
-\section{Basic Python fitting example/} \SecLabel{BasicPythonFittingExample}
+\section{Basic Python fitting example.} \SecLabel{BasicPythonFittingExample}
 
diff --git a/Doc/UserManual/SimulationExamples.tex b/Doc/UserManual/SimulationExamples.tex
index e85a9c03d09ef91376269c568c12296c0d01c525..e49f13e9a5bee1db0b3c2e9a168f99c5b5525868 100644
--- a/Doc/UserManual/SimulationExamples.tex
+++ b/Doc/UserManual/SimulationExamples.tex
@@ -441,10 +441,10 @@ The sample contains following parameters ('name':value)
 '/MultiLayer/crossCorrLength':0
 \end{lstlisting}
 
-Wildcards \Code{'*'} can be used to reduce typing or to work on group of parameters. In example below first command will change the height of the cylinders in the same way, as in previous example, while the second line will change the depth of both cylinders and prisms.
+Wildcards \Code{'*'} can be used to reduce typing or to work on group of parameters. In example below first command will change the height of the cylinders in the same way, as in previous example, while the second line will change simultaneously the height of {\it both} cylinders and prisms.
 \begin{lstlisting}[language=shell, style=commandline]
 multi_layer.setParameterValue('*FormFactorCylinder/height', 1.0)
-multi_layer.setParameterValue('*depth', 1.0)
+multi_layer.setParameterValue('*height', 1.0)
 \end{lstlisting}
 
 The complete example to this section can be found at
diff --git a/Examples/python/fitting/ex002_FitCylindersAndPrisms/FitCylindersPrisms.py b/Examples/python/fitting/ex002_FitCylindersAndPrisms/FitCylindersPrisms.py
index f9fe9e9a90c9f9cd35f7b2eaf9a4829b82f6dde2..2c6e7e0a33187652f81175731c7394a87f2785a2 100644
--- a/Examples/python/fitting/ex002_FitCylindersAndPrisms/FitCylindersPrisms.py
+++ b/Examples/python/fitting/ex002_FitCylindersAndPrisms/FitCylindersPrisms.py
@@ -138,7 +138,7 @@ def run_fitting():
     MinimizerFactory.printCatalogue()
 
     options = MinimizerOptions()
-    
+
     options.setMaxFunctionCalls(5)
     fitSuite.getMinimizer().setOptions(options)