o add legacy option -r and warn user about its deprecation.