Patch by Louie Lu.
- read() method returns a list of files parsed successfully - add tests, documentation (closes SF patch #677651)