updating readme and --help with useful examples