diff --git a/internals/zendapi/macros/ZEND_STRL.xml b/internals/zendapi/macros/ZEND_STRL.xml
index 210c5fed9f..05a86d68dd 100644
--- a/internals/zendapi/macros/ZEND_STRL.xml
+++ b/internals/zendapi/macros/ZEND_STRL.xml
@@ -1,21 +1,38 @@
-
+
ZEND_STRL
- ...
+ Pass string pointer and length in one operation
&reftitle.description;
#include <zend.h>
- ???ZEND_STRL
- ???str
+ ZEND_STRL
+ char *str
- ...
+ This is a convenience macro that can be used when passing a static string
+ to a function that requires a string length argument together with a string.
+ This saves duplicating the static string in the sourcecode or adding an extra
+ variable for it.
+
+ ZEND_STRL example
+
+
+
+
@@ -26,7 +43,7 @@
str
- ...
+ Pointer to a zero terminated string.
@@ -34,13 +51,6 @@
-
- &reftitle.returnvalues;
-
- ...
-
-
-
+
ZEND_STRS
- ...
+ Pass string pointer and buffer size in one operation
&reftitle.description;
#include <zend.h>
- ???ZEND_STRS
- ???str
+ ZEND_STRS
+ char *str
- ...
+ This is a convenience macro that can be used when passing a static string
+ to a function that requires a buffer length argument together with a string.
+ This saves duplicating the static string in the sourcecode or adding an extra
+ variable for it.
diff --git a/internals/zendapi/macros/ZEND_TRUTH.xml b/internals/zendapi/macros/ZEND_TRUTH.xml
index 91b371786b..9104e3b16f 100644
--- a/internals/zendapi/macros/ZEND_TRUTH.xml
+++ b/internals/zendapi/macros/ZEND_TRUTH.xml
@@ -1,9 +1,9 @@
-
+
ZEND_TRUTH
- ...
+ Cast a value to zend_bool
@@ -14,7 +14,7 @@
mixedx
- ...
+ A simple conversion macro, actually defined as ((x) ? 1 : 0)
@@ -26,7 +26,7 @@
x
- ...
+ Value to cast
@@ -37,7 +37,7 @@
&reftitle.returnvalues;
- ...
+ 1 if x was considered &true;, else 0