Constellation/doctrine — pull request #3 by aeisenberg (2012-08-20 21:23:28+00:00)
Title: Add basic recoverability.

Second try at a pull request. This one added a few more tests and is based off of a different branch.

This pull request contains basic support for recoverability. Now, simple problems like forgetting to include a tag name or a tag type will not break parsing of subsequent tags. eg-

@param arg0
@param {string} arg1

parsing that will return a list of two tags. The first will have no name, and a type of 'arg0' The second will be a proper param tag.

To ensure backwards compatibility, I added a new option.

> recoverable (boolean) default false. Set to true if you want to enable recovery.

In my opinion, this should be defaulted to true, but I wouldn't want to break any existing programs that assume no recoverability by default.

Some tests are included, but I may want to add more.