fix warnings and minor doc fixes
[BUG #7528] fix remaining typos in manual - phew!