swap: add the -f short flag, and improve docs