add box.raise(code, message) method

user can throw an exception with choised code.
update documentation
box.raise: review fixes.
Merge branch 'box.raise'