docs and error messages for new DSL stanza `pkg`

transition from `install` to `pkg`