develooper Front page | perl.perl5.porters | Postings from May 2010

Re: PERL_NO_GET_CONTEXT (Was: [PATCH] shift; optimization)

Thread Previous | Thread Next
From:
Steffen Mueller
Date:
May 3, 2010 23:44
Subject:
Re: PERL_NO_GET_CONTEXT (Was: [PATCH] shift; optimization)
Message ID:
4BDFC22B.20105@cpan.org
Jan Dubois wrote:
> On Mon, 03 May 2010, Steffen Mueller wrote:
>> Jan Dubois wrote:
>>> So please make sure you define PERL_NO_GET_CONTEXT in your modules
>>> if you are an XS author. It is not on by default for backwards
>>> compatibility reasons only.
>> Should the be prominently documented somewhere?
> 
> From my point of view it is already prominently documented
> in perlguts.pod.
> 
> The problem with the Perl documentation is that there is so much
> of it, so not everything can be put prominently at the top of
> each file...

I agree that the Perl docs are big and not always well laid out, but is 
perl*guts* the place to document something that an XS author should 
certainly remember? OTOH, it's discussed to great lengths in perlguts, 
so if we assume that an XS author has at least skimmed the document as 
he should, he won't completely oblivious to it.

Also, is this a default that we might be able to change down the road?

Best regards,
Steffen
Thread Previous | Thread Next

nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About