From 0972ecdf6decc0f53d00772c18026d31b7aaf416 Mon Sep 17 00:00:00 2001 From: David Mitchell Date: Mon, 8 Feb 2010 21:07:56 +0000 Subject: [PATCH] Warn people not to set PERL_CORE in XS --- pod/perlguts.pod | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/pod/perlguts.pod b/pod/perlguts.pod index 5a68341..97445e1 100644 --- a/pod/perlguts.pod +++ b/pod/perlguts.pod @@ -2181,9 +2181,13 @@ functions or functions used in a program in which Perl is embedded. Similarly, all global variables begin with C. (By convention, static functions start with C.) -Inside the Perl core, you can get at the functions either with or -without the C prefix, thanks to a bunch of defines that live in -F. This header file is generated automatically from +Inside the Perl core (C defined), you can get at the functions +either with or without the C prefix, thanks to a bunch of defines +that live in F. Note that extension code should I set +C; this exposes the full perl internals, and is likely to cause +breakage of the XS in each new perl release. + +The file F is generated automatically from F and F. F also creates the prototyping header files for the internal functions, generates the documentation and a lot of other bits and pieces. It's important that when you add -- 2.7.4