new detect option and some documentation updates