I don't have a specific CPAN module in mind, but any module which contains a thorough test harness is a great read, because it shows how to use the module and all of its APIs. Sometimes the POD lags behind, but if there is a test for it, the test helps to explain what it does and how to call it.