better error handling and some minor formatting

stopping for tonight; need to read up on error handling and ? syntax

remove text copied from example :)

cleanup

rename fn search to fn define :)

first commit