diff --git a/internals/zendapi/macros/RETURN_BOOL.xml b/internals/zendapi/macros/RETURN_BOOL.xml
index e994ada97e..a045b65c68 100644
--- a/internals/zendapi/macros/RETURN_BOOL.xml
+++ b/internals/zendapi/macros/RETURN_BOOL.xml
@@ -1,9 +1,9 @@
-
+
RETURN_BOOL
- ...
+ Return a bool value from a function
@@ -14,7 +14,9 @@
zend_boolb
- ...
+ RETURN_BOOL sets the return_value
+ of the given function to b and returns control to
+ the calling function.
@@ -26,7 +28,7 @@
b
- ...
+ bool value to return.
@@ -34,13 +36,6 @@
-
- &reftitle.returnvalues;
-
- ...
-
-
-
+
RETURN_DOUBLE
- ...
+ Return a double value from a function
@@ -14,7 +14,9 @@
doubled
- ...
+ RETURN_DOUBLE sets the return_value
+ of the given function to d and returns control to
+ the calling function.
@@ -26,7 +28,7 @@
d
- ...
+ double value to return.
@@ -34,13 +36,6 @@
-
- &reftitle.returnvalues;
-
- ...
-
-
-
+
RETURN_EMPTY_STRING
- ...
+ Return an empty string value from a function
@@ -13,30 +13,7 @@
RETURN_EMPTY_STRING
- ...
-
-
-
-
- &reftitle.parameters;
-
-
-
-
-
-
- ...
-
-
-
-
-
-
-
-
- &reftitle.returnvalues;
-
- ...
+ This returns an empty string without the need to create such a string first.
diff --git a/internals/zendapi/macros/RETURN_LONG.xml b/internals/zendapi/macros/RETURN_LONG.xml
index 0aabdca7df..250861ef42 100644
--- a/internals/zendapi/macros/RETURN_LONG.xml
+++ b/internals/zendapi/macros/RETURN_LONG.xml
@@ -1,9 +1,9 @@
-
+
RETURN_LONG
- ...
+ Return a long value from a function
@@ -14,7 +14,9 @@
longl
- ...
+ RETURN_LONG sets the return_value
+ of the given function to l and returns control to
+ the calling function.
@@ -26,7 +28,7 @@
l
- ...
+ long value to return.
@@ -34,13 +36,6 @@
-
- &reftitle.returnvalues;
-
- ...
-
-
-
+
RETURN_NULL
- ...
+ Return a null value from a function
@@ -13,30 +13,9 @@
RETURN_NULL
- ...
-
-
-
-
- &reftitle.parameters;
-
-
-
-
-
-
- ...
-
-
-
-
-
-
-
-
- &reftitle.returnvalues;
-
- ...
+ RETURN_BOOL sets the return_value
+ of the given function to &null; and returns control to
+ the calling function.
diff --git a/internals/zendapi/macros/RETURN_RESOURCE.xml b/internals/zendapi/macros/RETURN_RESOURCE.xml
index c120cc686f..7990c83136 100644
--- a/internals/zendapi/macros/RETURN_RESOURCE.xml
+++ b/internals/zendapi/macros/RETURN_RESOURCE.xml
@@ -1,20 +1,22 @@
-
+
RETURN_RESOURCE
- ...
+ Return a resource from a function
&reftitle.description;
#include <zend_API.h>
- ???RETURN_RESOURCE
- ???l
+ RETURN_RESOURCE
+ resourcer
- ...
+ RETURN_RESOURCE sets the return_value
+ of the given function to r and returns control to
+ the calling function.
@@ -23,10 +25,10 @@
- l
+ r
- ...
+ The resource to be returned.
@@ -34,13 +36,6 @@
-
- &reftitle.returnvalues;
-
- ...
-
-
-
+
RETURN_ZVAL
- ...
+ Return a zval value from a function
&reftitle.description;
#include <zend_API.h>
- ???RETURN_ZVAL
- ???zv
- ???copy
- ???dtor
+ RETURN_ZVAL
+ zval *zv
+ boolcopy
+ booldtor
...
@@ -28,7 +28,7 @@
zv
- ...
+ Pointer to the zval to return.
@@ -36,7 +36,7 @@
copy
- ...
+ Create a copy of zv before returning it?
@@ -44,7 +44,9 @@
dtor
- ...
+ Destruct the original value before returning fromt he function,
+ this is needed if zv was only temporarily
+ created within the function.
@@ -52,13 +54,6 @@
-
- &reftitle.returnvalues;
-
- ...
-
-
-
+
ZEND_NUM_ARGS
@@ -13,30 +13,15 @@
intZEND_NUM_ARGS
- ...
-
-
-
-
- &reftitle.parameters;
-
-
-
-
-
-
- ...
-
-
-
-
+ ZEND_NUM_ARGS returns the number of arguments
+ that have been passed by the caller of the current PHP function.
&reftitle.returnvalues;
- ...
+ Number of argunemts passed to the current PHP function.