Author: particle
Date: Mon May 21 18:20:52 2007
New Revision: 18615
Modified:
trunk/docs/dev/pccmethods.pod
Log:
add a note about PCCRETURN expanding to more than one line
Modified: trunk/docs/dev/pccmethods.pod
==============================================================================
--- trunk/docs/dev/pccmethods.pod (original)
+++ trunk/docs/dev/pccmethods.pod Mon May 21 18:20:52 2007
@@ -50,6 +50,18 @@
PCCRETURN(PMC *status, INTVAL count);
+Please note that C<PCCRETURN> expands to multiple lines, so it must
+always be enclosed in a block when contained in the body of a selector.
+For example:
+
+ if(!PMC_IS_NULL(foo))
+ PCCRETURN(PMC *foo);
+
+will not do what you expect. It must be written as:
+
+ if(!PMC_IS_NULL(foo)) {
+ PCCRETURN(PMC *foo);
+ }
=head2 PCCINVOKE
