correct documentation
fix typos
Merge remote-tracking branch 'origin/master' into 1.4.6
deprecate sort parameters in next_xxxx() functions