Fix #2286 (sort): fixes and doco for suppress remove sort
Merge pull request #2404 from PaulL1/2286_sorting_doco

Fix #2286 (sort): fixes and doco for suppress remove sort