more examples and better description in readme

Author: pseewald

README.md

@@ -1,17 +1,20 @@
 # fprettify
+
 [![Build Status](https://travis-ci.org/pseewald/fprettify.svg?branch=master)](https://travis-ci.org/pseewald/fprettify) [![Coverage Status](https://coveralls.io/repos/github/pseewald/fprettify/badge.svg?branch=master)](https://coveralls.io/github/pseewald/fprettify?branch=master) [![Code Health](https://landscape.io/github/pseewald/fprettify/master/landscape.svg?style=flat)](https://landscape.io/github/pseewald/fprettify/master) [![Code Climate](https://codeclimate.com/github/pseewald/fprettify/badges/gpa.svg)](https://codeclimate.com/github/pseewald/fprettify) [![Code Issues](https://www.quantifiedcode.com/api/v1/project/d5bb6eeb81ba41478986898d3d2665e4/badge.svg)](https://www.quantifiedcode.com/app/project/d5bb6eeb81ba41478986898d3d2665e4)
 
-fprettify is an auto-formatter for modern Fortran code that imposes strict whitespace formatting.
+fprettify is an auto-formatter for modern Fortran code that imposes strict whitespace formatting, written in Python.
 
 
 ## Features
 
 * Auto-indentation.
 * Line continuations are aligned with the previous opening delimiter `(`, `[` or `(/` or with an assignment operator `=` or `=>`. If none of the above is present, a default hanging indent is applied.
-* All operators are surrounded by exactly one whitespace character, except for arithmetic operators.
+* Consistent amount of whitespace around operators and delimiters.
 * Removal of extraneous whitespace and consecutive blank lines.
 * Works only for modern Fortran (Fortran 90 upwards).
+* Tested for editor integration.
 * By default, fprettify causes changes in the amount of whitespace only and thus preserves revision history.
+* Feature missing? Please create an issue.
 
 
 ## Requirements
@@ -21,7 +24,35 @@ Python 2.7 or Python 3.x
 
 ## Examples
 
-Compare `examples/*before.f90` (original Fortran files) with `examples/*after.f90` (reformatted Fortran files) to see what fprettify does.
+Compare `examples/*before.f90` (original Fortran files) with `examples/*after.f90` (reformatted Fortran files) to see what fprettify does. A quick demonstration:
+
+``` Fortran
+program demo
+integer :: endif,if,else
+endif=3; if=2
+if(endif==2)then
+endif=5
+else=if+4*(endif+&
+2**10)
+else if(endif==3)then
+print*,endif
+endif
+end program
+```
+⇩⇩⇩⇩⇩⇩⇩⇩⇩⇩
+``` Fortran
+program demo
+   integer :: endif, if, else
+   endif = 3; if = 2
+   if (endif == 2) then
+      endif = 5
+      else = if + 4*(endif + &
+                     2**10)
+   else if (endif == 3) then
+      print *, endif
+   endif
+end program
+```
 
 
 ## Installation
@@ -43,7 +74,12 @@ The default indent is 3. If you prefer something else, use `--indent=<n>` argume
 
 For editor integration, use
 ```
-fprettify --no-report-errors
+fprettify --silent
+```
+
+For instance, with Vim, use fprettify with `gq` by putting the following commands in your `.vimrc`:
+```vim
+autocmd Filetype fortran setlocal formatprg=fprettify\ --silent
 ```
 
 For more information, read