Improve --require docs with something more useful

Add deprecation to changelog