docs and error messages for new DSL stanza `pkg`

transition from `install` to `pkg`
Merge pull request #6121 from rolandwalker/doc_dsl_pkg

docs and error messages for new DSL stanza `pkg`