I've made some improvements to davyd's Python spec parser which I think are sufficient to use it as the preferred HTML formatter for telepathy-spec. Because the new parser is stricter than the old (and I've made it stricter still), it needs some trivial changes to the spec markup itself:

http://git.collabora.co.uk/?p=user/smcv/telepathy-spec-smcv.git;a=shortlog;h=refs/heads/parser

Summary of changes:

* Add support for old-style Telepathy Properties - we're slowly phasing them out but at the moment they're still required information

* Raise an error when things not explicitly marked as available in arrays are used in an array, and fix up the spec to name more arrays as a result

* Consistently use the .DRAFT suffix when linking to a draft spec rather than relying on a special-case in the XSLT formatter

* Fix a couple of added/deprecated annotations

Merging it requires a further strictness fix, for ContactInfo enhancements that have been merged to master since davyd branched:

http://git.collabora.co.uk/?p=user/smcv/telepathy-spec-smcv.git;a=shortlog;h=refs/heads/merge-parser

My plan is to release telepathy-spec-0.17.22 with both HTML formatters enabled in the Makefile, and if all goes well, disable the XSLT-based one for 0.17.23.