Adding formating for paper references and code highlighting

README.md

@@ -2,19 +2,19 @@ PSBLAS library, version 3.5.
 ============================
 
 The architecture of the Fortran 2003 sparse BLAS is described in:
-S. Filippone, A. Buttari
-Object-Oriented Techniques for Sparse Matrix Computations in Fortran
-2003, ACM Trans. on Math. Software, vol. 38, No. 4, 2012.
+>S. Filippone, A. Buttari. Object-Oriented Techniques for Sparse Matrix
+>Computations in Fortran 2003, ACM Trans. on Math. Software, vol. 38, No.
+4, 2012.
 
 The ideas are explored further with the paper:
-V. Cardellini, S. Filippone and D. Rouson
-Design Patterns for  sparse-matrix computations on hybrid CPU/GPU
-platforms, Scientific Programming, 22(2014), pp.1-19.
+>V. Cardellini, S. Filippone and D. Rouson. Design Patterns for
+>sparse-matrix computations on hybrid CPU/GPU platforms, Scientific 
+>Programming, 22(2014), pp.1-19.
 
 Version 1.0 of the library is described in:
-S. Filippone, M. Colajanni
-PSBLAS: A library for parallel linear algebra computation on sparse
-matrices, ACM Trans. on Math. Software, 26(4), Dec. 2000, pp. 527-550.
+>S. Filippone, M. Colajanni. PSBLAS: A library for parallel linear
+>algebra computation on sparse matrices, ACM Trans. on Math. Software,
+>26(4), Dec. 2000, pp. 527-550.
 
 
 UTILITIES
@@ -36,9 +36,9 @@ We originally included a modified implementation of some of the Sparker
 (serial sparse BLAS)  material; this has been completely rewritten, way
 beyond the intention(s) and responsibilities of the original developers.
 The main reference for the serial sparse BLAS is:
-Duff, I., Marrone, M., Radicati, G., and Vittoli, C.
-Level 3 basic linear algebra subprograms for sparse matrices: a user 
-level interface, ACM Trans. Math. Softw., 23(3), 379-401, 1997.
+>Duff, I., Marrone, M., Radicati, G., and Vittoli, C. Level 3 basic 
+>linear algebra subprograms for sparse matrices: a user level interface,
+>ACM Trans. Math. Softw., 23(3), 379-401, 1997.
 
 
 INSTALLING
@@ -55,20 +55,20 @@ prerequisites (see also SERIAL below):
 3. We have had good results with  the METIS library, from 
    http://www-users.cs.umn.edu/~karypis/metis/metis/main.html.
    This is optional; it is  used in the util and test/fileread
-   directories but only if you specify --with-metis.
+   directories but only if you specify `--with-metis`.
 
 4. If you have the AMD package of Davis, Duff and Amestoy, you can
-   specify  --with-amd (see ./configure --help for more details). 
+   specify `--with-amd` (see `./configure --help` for more details). 
 
 The configure script will generate a Make.inc file suitable for building
 the library. The script is capable of recognizing the needed libraries
 with their default names; if they are in unusual places consider adding
-the paths with --with-libs, or explicitly specifying the names in
---with-blas, etc. Please note that a common way for the configure script
+the paths with `--with-libs`, or explicitly specifying the names in
+`--with-blas`, etc. Please note that a common way for the configure script
 to fail is to specify inconsistent MPI vs. plain compilers, either
 directly or indirectly via environment variables; e.g. specifying the
-Intel compiler with FC=ifort while at the same time having an 
-MPIFC=mpif90 which points to GNU Fortran. The best way to avoid this
+Intel compiler with `FC=ifort` while at the same time having an 
+`MPIFC=mpif90` which points to GNU Fortran. The best way to avoid this
 situation is (in our opinion) to use the environment modules package
 (see http://modules.sourceforge.net/), and load the relevant
 variables with (e.g.) 
@@ -85,20 +85,20 @@ After you have Make.inc fixed,  run
 make
 ``` 
 to  compile the library; go to the test directory and its subdirectories
-to get test programs done. If you specify --prefix=/path you can do make
+to get test programs done. If you specify `--prefix=/path` you can do make
 install and the libraries will be installed under /path/lib, while the
 module files will be installed under /path/include.
 
 SERIAL
 ------
-Configuring with --enable-serial will provide a fake MPI stub library
+Configuring with `--enable-serial` will provide a fake MPI stub library
 that enables running in pure serial mode; no MPI installation is needed
 in this case (but note that the fake MPI stubs are only guaranteed to
 cover what we use internally, it's not a complete replacement). 
 
 LONG INTEGERS
 -------------
-We have an experimental flag --enable-long-integers that will enable 
+We have an experimental flag `--enable-long-integers` that will enable 
 having 8-byte integer data, allowing an index space larger than 2G; some
 small cases have been tested but we do not offer full guarantee (yet).