Front page | perl.perl5.porters |
Postings from May 2012
Re: Perl Unicode API
Thread Previous
|
Thread Next
From:
Nicholas Clark
Date:
May 8, 2012 09:00
Subject:
Re: Perl Unicode API
Message ID:
20120508160042.GM9069@plum.flirble.org
On Tue, May 08, 2012 at 03:55:22PM -0000, Father Chrysostomos wrote:
>
> David Mertens asked:
>
> > 1. Would anyone object to making these part of the public API?
>
> Anything beginning with pp_: definitely. If you want to make pp_scmp
> a wrapper around a C function that takes real arguments (instead of
> using the perl stack), I would not object.
I don't think that we should be making the pp functions themselves into
API functions, as many do overly complex tasks, often with confusing
special case flags.
But I agree that your wrapper suggestion *is* the way to go. However, I think
that it should be the other way out - the PP functions themselves are wrappers
around sane C level APIs. Where possibly 1 PP function is decomposed into
more than 1 API function, if that makes the most sense.
> > 2. I believe that making a C function part of the public API is simply a
> > matter of documenting it. Is this correct?
>
> It also needs to be exported and marked as part of the API, which you
> can accomplish with the A flag in embed.fnc.
>
> > Is there a policy about tests
> > for public API functions?
>
> No, not really, but tests are good. :-)
No, really, tests are needed.
Nicholas Clark
Thread Previous
|
Thread Next