On Sun, Feb 7, 2016 at 6:08 AM, Nick Wellnhofer <[email protected]> wrote:

> Currently, the documentation for Perl constructors is taken from the
> "initializer" which defaults to the `init` function.

I recall that quirk as an accident of hackery.  The Perl XS contructor
wrappers had to use `init` and not `new` in order to enable subclassing.  At
the time it was inconvenient to generate code off of `init` while generating
pod off of `new`, especially since some abstract classes had `init` but not
`new`.  So I just started attaching the docucomments to `init`.

> Does that make sense? Related issue:
>
>     https://issues.apache.org/jira/browse/CLOWNFISH-41

Feel free to do whatever you think is best for now.  CLOWNFISH-41 can wait.

Marvin Humphrey

Reply via email to