Fix #986 and improve documentation.
Merge pull request #297 from thdox/reconcile-sort-key

Fix #986 and improve documentation.  I don't like it, but if it will stop the complaint I will merge it.