diff --git a/user-doc/Installation.txt b/user-doc/Installation.txt
index 51452bf52a362529023ca52e5686d55c01fc8640..dc5815395100c63a7c69de0c8313e2ca561f5644 100644
--- a/user-doc/Installation.txt
+++ b/user-doc/Installation.txt
@@ -8,13 +8,34 @@ At the present times plumed can be added to the following list of codes:
 
 \section CompilingPlumed Compiling Plumed
 
-[Configuration]
+First configure using
+\verbatim
+> ./configure
+\endverbatim
+
+In case it is necessary, edit the resulting Makefile.conf. A new file sourceme.sh
+will appear in the main plumed directory. Just source it (presently only for bash shell):
+\verbatim
+> source sourceme.sh
+\endverbatim
+
+Then compile plumed
+\verbatim
+> make -j 4
+\endverbatim
 
-[Compilation]
+A "plumed" executable should be in your path. Try to type
+\verbatim
+> plumed -h
+\endverbatim
 
-[Installation?]
+You can also check if plumed is correctly compiled performing our regression tests.
+Be warned that some of them just fails because of the different numerical accuracy of different machines.
+\verbatim
+> cd regtest
+> make
+\endverbatim 
 
-[How to test plumed without MD engine]
 
 \section Patching Patching your MD code
 
@@ -36,12 +57,6 @@ If your MD code is not supported, you may want to implement an interface for
 it. Refer to the <a href="../../developer-doc/html/index.html"> developer
 manual </a>.
 
-[How to test if interface has been installed properly]
-
-\section InstallingPlumedOnAMainframe Installing Plumed on a mainframe
-
-[Notes on shared libraries, modules, etc.]
-
 
 */
 
diff --git a/user-doc/WhatsNew.txt b/user-doc/WhatsNew.txt
index b3c51cb2f927eda987dd7224cd35782257332444..5f175eb2527c022eb667c3a43930767f2a0f099c 100644
--- a/user-doc/WhatsNew.txt
+++ b/user-doc/WhatsNew.txt
@@ -4,7 +4,7 @@
 \section NewFeatures List of new features
 
 - Input file (plumed.dat) syntax is much more flexible and has more 
-  error checking (see \ref NewInputSyntax). Units are treated
+  error checking. Units are treated
   consistently, so that the plumed.dat file can be ported from on
   MD code to another.
 - Plumed is now compiled as a library, independently of the MD code.
@@ -32,15 +32,13 @@
 
 Caveats:
 - Plumed 2 input file (plumed.dat) has a syntax which is not
-  compatible with Plumed 1 (see \ref NewInputSyntax).
+  compatible with Plumed 1.
   Transition should be easy, but cannot
   be done just using the new version with the old input file.
 - Plumed 2 is written in C++, thus requires a C++ compiler
 - Plumed 2 may not include all the features that were available
   in plumed 1.
 
-\section NewInputSyntax New syntax for the input file
-
-[Briefly describe the difference between old and new input]
+A tutorial explaining how to move from plumed 1 to plumed 2 is available (see \ref moving).
 
 */