improved comments and cleanup in auditor script