http://qs1969.pair.com?node_id=489748


in reply to Documenting non-public OO components

I recently faced a similar problem: methods that are meant to be used by subclasses, but not by "the public." You can see my solution on CPAN. I created a separate "PROTECTED API" section, and I explained what I meant by "protected" in the "DESCRIPTION" section. I'm not particularly happy with this solution, but at least it's explicit.