update comments and add public declarations on test functions.
add readme file
add new line character in readme file
Removed empty .install file.
Refactored real-time reports to provide a renderable array as output.  Sanitised the usernames in the output to prevent XSS attacks. Changed the solr query to use a 'q.alt' search, so results are returned on recent Solr implementations.