Skip Menu |
 

This queue is for tickets about the Test-Harness CPAN distribution.

Report information
The Basics
Id: 8600
Status: resolved
Priority: 0/
Queue: Test-Harness

People
Owner: Nobody in particular
Requestors: schwern [...] pobox.com
Cc:
AdminCc:

Bug Information
Severity: Unimportant
Broken in: (no value)
Fixed in: (no value)



Subject: Test::Harness::Straps publicly documents private methods.
Download (untitled) / with headers
text/plain 567b
The documentation of Test::Harness::Straps is mostly that of private methods with no indication that they are private other than the leading _. These methods should not be seen in public documentation, people will use them and then complain when they change out from under them. Each piece of private documentation should be internally wrapped in a =begin private / =end private set of POD tags so it is not displayed without special POD formatting options. At minimum there should be a note explaining the _foo convention and the perils of using private methods.
Handled in 2.57_03


This service is sponsored and maintained by Best Practical Solutions and runs on Perl.org infrastructure.

Please report any issues with rt.cpan.org to rt-cpan-admin@bestpractical.com.