docs: various updates and fixes from Reinier

git-svn-id: http://svn.freepascal.org/svn/lazarus/trunk@42502 4005530d-fff6-0310-9dd1-cebe43e6787f