Refactor GH-1540, add specs, resolve windows spec failures

This pull request adds yardoc to a few methods around the parsedfile provider and the fileparsing methods. It refactors the parsedfile `find_resource` method into `resource_for_record` and modifies the specs to more cleanly test the desired resolution for http://projects.puppetlabs.com/issues/2251