A couple of small documentation improvements.

Remove outdated information, fix typos, add formatting etc.

Change-Id: I98cdab3e39d719bdab5086640bb9f657eb2703f8
Reviewed-by: Joerg Bornemann <joerg.bornemann@digia.com>