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