Doc cleanup based on comments

The examples are generated from a common method (see bitcoinrpc.h).
This also fixes is missing space in rpcblockchain.cpp:101
Some other cleanup