That's not a trivial problem in the general case. A package can be strewn across multiple files, and a file can contain (parts of) multiple packages.

The common case were files and packages correspond to each other 1:1 is easy enough to solve and would usually be done using perldoc -l Module.

If you need to cover more complex scenarios, though, you're on your own.