add warn404 option and update documentation