Documentation improvements and man pages

Submitted by Emanuele Aina

Link to original bug (#749162)

Description

I started fixing some typos, then I started adding docbook tags where
appropriate and while I was at it I started editing some sentences to sound a
bit better. From there it all went downhill and in the end I reworked the
command line tools documentation to be able to generate man pages from it. :)