tweak predSwitch ddoc
tweak clamp ddoc

- sort the Comparison section
- fix typo
Merge pull request #2766 from e10s/patch-2

Tweak std.algorithm ddocs