added doc and tests for main entry point.
added entry point tests.... really this time