A lot of documentation improvements and also a lot of warnings removed.
Merge remote-tracking branch 'origin/master'
doc