On Sun, Dec 07, 2003 at 04:11:54PM -0800, Daniel Macks wrote:
> Doc fix: forgot that '=begin private' POD doesn't display.
> Finished my diatrabe against the prompt_selection API.

If its private, you should probably rename it _read_properties_lines().
This is much more obvious than saying its private in the docs.  You can't
not read the function name.

Also, its been my opinion that the docs for private functions *shouldn't*
display in perldoc to prevent user temptation.  The only people who need to
see it are those who are working on the Fink::Services code so they'll
see the docs when they look at the code.

So I'd leave the "=begin private" and change the name to _foo style.


-- 
Michael G Schwern        [EMAIL PROTECTED]  http://www.pobox.com/~schwern/
This is my sig file.  Is it not nify?  Worship the sig file.
        http://www.sluggy.com


-------------------------------------------------------
This SF.net email is sponsored by: SF.net Giveback Program.
Does SourceForge.net help you be more productive?  Does it
help you create better code?  SHARE THE LOVE, and help us help
YOU!  Click Here: http://sourceforge.net/donate/
_______________________________________________
Fink-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/fink-devel

Reply via email to