introducing cocoa style error handling
add init convenience
update demo apps to new style error handling
update docs to new style error handling