Document '--allow-newer'.

The user guide really could really use an overhaul...