summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPerl 5 Porters <perl5-porters@africa.nicoh.com>1996-08-29 10:21:33 +0000
committerAndy Dougherty <doughera@lafcol.lafayette.edu>1996-08-29 10:21:33 +0000
commit84287afe68eecc4342d7e27aac5d9df9d2412490 (patch)
tree5368ff48360f19f3c696d65051b3e5668c1d1342
parentb7a902f4f873ea955859f89894f7d3c3b721fc0d (diff)
downloadperl-84287afe68eecc4342d7e27aac5d9df9d2412490.tar.gz
document xsubpp SCOPE:
-rw-r--r--pod/perlxs.pod17
1 files changed, 17 insertions, 0 deletions
diff --git a/pod/perlxs.pod b/pod/perlxs.pod
index 850960ae2b..6a898a5331 100644
--- a/pod/perlxs.pod
+++ b/pod/perlxs.pod
@@ -416,6 +416,23 @@ A correct, but error-prone example.
timep
RETVAL
+=head2 The SCOPE: Keyword
+
+The SCOPE: keyword allows scoping to be enabled for a particular XSUB. If
+enabled, the XSUB will invoke ENTER and LEAVE automatically.
+
+To support potentially complex type mappings, if a typemap entry used
+by this XSUB contains a comment like C</*scope*/> then scoping will
+automatically be enabled for that XSUB.
+
+To enable scoping:
+
+ SCOPE: ENABLE
+
+To disable scoping:
+
+ SCOPE: DISABLE
+
=head2 The INPUT: Keyword
The XSUB's parameters are usually evaluated immediately after entering the