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