BVAL-322

* Updated API listings in spec
* Fixed several formatting, typo issues etc.