On 11/24/09 Tue Nov 24, 2009 11:09 AM, "Steve Bertrand" <st...@ibctech.ca> scribbled:
> I've noticed that the POD for several modules do not include method > usage for the functions/methods that are designed as 'internal-only'. > > I've reached a stage where not having POD for ALL of my methods is > becoming overwhelmingly cumbersome, as I have to read the code to > remember usage. > > Is there a common practice for this? If POD doesn't display internal sub > usage, where would one document it? I would think that you would only include in POD the information needed by the users of the modules. This would include the external interface, sample calls, etc. For documenting the internal interfaces, I would add comments in the code. -- To unsubscribe, e-mail: beginners-unsubscr...@perl.org For additional commands, e-mail: beginners-h...@perl.org http://learn.perl.org/
