more with markdown

README.md

@@ -5,7 +5,7 @@ proposed by W.-J. Beyn coupled with a [GetDP](http://getdp.info) formulation.
 
 Reference paper
 ---------------
-[W.-J., Beyn, "An integral method for solving nonlinear eigenvalue problems", 
+[W.-J., Beyn, "An integral method for solving nonlinear eigenvalue problems",
 Linear Algebra and its Applications, 2012,436.](
 https://doi.org/10.1016/j.laa.2011.03.030)
 
@@ -42,35 +42,36 @@ http://onelab.info) variables:
     doApply        flag signalling if x() should be applied to the linear system
     fileName       name of the post-processing file
 
-More information can be found in [bin/solver.py](bin/solver.py). Furthermore, 
-examples are provided in [example/maxwell\_sibc/](example/maxwell_sibc/) and 
-[example/maxwell\_linear/](example/maxwell\_linear/).
+More information can be found in [bin/solver.py](bin/solver.py). Furthermore,
+examples are provided in [example/maxwell\_sibc](example/maxwell_sibc) and
+[example/maxwell\_linear](example/maxwell\_linear).
 
 Dependencies
 ------------
-cim.py is a [Python 2.7](https://www.python.org/download/releases/2.7/) script. 
+cim.py is a [Python 2.7](https://www.python.org/download/releases/2.7) script.
 It relies on the following modules:
 
     argparse
     numpy
     getdp
 
-The `getdp` module can be obtained by compiling [GetDP](http://getdp.info).
+The getdp module can be obtained by compiling [GetDP](http://getdp.info).
 Among other (and possibly optional) dependencies, [GetDP](http://getdp.info)
 relies on [PETSc](https://www.mcs.anl.gov/petsc).
-The shell script dependencies.sh should handle this automatically if you run:
+The shell script [dependencies.sh](dependencies.sh) should handle this
+automatically if you run:
 
     ./dependencies.sh
 
-You will need `wget`, `tar`, `gcc`, `g++` and `gfortran` for this script to work.
-Don't forget to update your `PATH`, `PYTHONPATH` and `LD_LIBRARY_PATH` as 
-instructed.
+You will need `wget`, `tar`, `gcc`, `g++` and `gfortran` for this script
+to work. Don't forget to update your `PATH`, `PYTHONPATH` and `LD_LIBRARY_PATH`
+as instructed.
+
+If you want to handle the [PETSc](https://www.mcs.anl.gov/petsc) and [GetDP](
+http://getdp.info) libraries yourself, here are the options you will need.
+The [PETSc](https://www.mcs.anl.gov/petsc) library should be compiled with the
+following features:
 
-If you want to handle the [PETSc](https://www.mcs.anl.gov/petsc) and 
-[GetDP](http://getdp.info) libraries yourself, here are the options you will 
-need. The [PETSc](https://www.mcs.anl.gov/petsc) library should be compiled with
-the following features:
-    
     --with-clanguage=cxx
     --with-shared-libraries=1
     --with-x=0
@@ -80,10 +81,10 @@ the following features:
     --with-mpiuni-fortran-binding=0
     --download-mumps=yes
 
-In other words, [PETSc](https://www.mcs.anl.gov/petsc) should be compiled 
-without MPI, with complex algebra and with a sequential version of [MUMPS](
-http://mumps-solver.org/). [GetDP](http://getdp.info) can then be compiled 
-with the following options:
+In other words, [PETSc](https://www.mcs.anl.gov/petsc) should be compiled
+without [MPI](http://mpi-forum.org), with complex algebra and with a sequential
+version of [MUMPS](http://mumps-solver.org). [GetDP](http://getdp.info) can then
+be compiled with the following options:
 
     ENABLE_BLAS_LAPACK:   ON
     ENABLE_BUILD_DYNAMIC: ON
@@ -92,9 +93,9 @@ with the following options:
     ENABLE_PETSC:         ON
     ENABLE_WRAP_PYTHON:   ON
 
-If everything went fine, you should end up with the [GetDP](http://getdp.info) 
+If everything went fine, you should end up with the [GetDP](http://getdp.info)
 Python module:
-    
+
     getdp.py
 
 Finally, Don't forget to update your `PATH`, `PYTHONPATH` and `LD_LIBRARY_PATH`.