better documentation for inOrder. fixes #224