improve `.auto` docs
Merge pull request #481 from Mithgol/improve-auto-docs

improve `.auto` docs