make it possible to handle errors
adjust comments on error messages to standard godoc style
Merge branch 'oid-parse-protection' into branch-iterator
merge with improved error handling logic