reads the File and returns a hashreference with several information about the document.

{
pod => $pod_document,
filename => $file,
title => $title,
}

$pod_document is the complete pod documentation that was found in the file. $file is the name of the file (without path) and $title is the title of the pod documentation. By default it is the filename, but you can say "title => 'pod'" in the configuration. The title is the first value for =head1 in the pod.