[Bioperl-l] new/unannounced methods
Dave Messina
dmessina at wustl.edu
Thu Mar 8 16:56:13 UTC 2007
Nathan Haigh wrote:
> I've come across a couple of methods that are commented as being
> new/unannounced e.g.:
> Bio::Location::Atomic::trunc
>
> As it's not been documented with POD it reduces the POD coverage metric.
> I wondered if it makes sense to have these types of methods initially
> made private with the use of a leading underscore until it's unveiling?
> This way, programmers know not to touch the method from outside the
> module and the POD coverage doesn't see it as being missed.
>
Maybe add POD that it's experimental and convert Jason's comments into
the POD description?
More information about the Bioperl-l
mailing list