added README generated from source code (modified a few functions for easier parsing)