From 09f638433b0084b0419c31e6a2a2ec2c5669a2ed Mon Sep 17 00:00:00 2001 From: Hartmut Holzgraefe Date: Sun, 22 Jan 2006 14:57:49 +0000 Subject: [PATCH] finished ZEND_MOD_REQUIRED*.xml, can be used as examples for the other ZEND_MOD_* macros git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@205706 c90b9560-bf6c-de11-be94-00142212c4b1 --- .../zendapi/macros/ZEND_MOD_REQUIRED.xml | 31 +++++++++++---- .../zendapi/macros/ZEND_MOD_REQUIRED_EX.xml | 38 +++++++++++++++---- 2 files changed, 55 insertions(+), 14 deletions(-) diff --git a/internals/zendapi/macros/ZEND_MOD_REQUIRED.xml b/internals/zendapi/macros/ZEND_MOD_REQUIRED.xml index 5ec07e2b81..a61a89eddc 100644 --- a/internals/zendapi/macros/ZEND_MOD_REQUIRED.xml +++ b/internals/zendapi/macros/ZEND_MOD_REQUIRED.xml @@ -1,9 +1,9 @@ - + ZEND_MOD_REQUIRED - ... + Create a simple dependency entry for a required extension @@ -11,10 +11,14 @@ #include <zend_modules.h> ZEND_MOD_REQUIRED - char *name + char *ext_name - ... + ZEND_MOD_REQUIRED generates a zend_module_dep + entry for the extension named by ext_name. A simple entry + without further version specifications is generated. + See ZEND_MOD_REQUIRED_EX for an extended version of this + macro that also allows to specify version dependencies. @@ -23,10 +27,10 @@ - name + ext_name - ... + The name of a reqiured extension @@ -37,10 +41,23 @@ &reftitle.returnvalues; - ... + Code to register the required extension dependency + + &reftitle.seealso; + + See ZEND_MOD_REQUIRED_EX if you also need to + specify extension version requirements. + + + See also ZEND_MOD_OPTIONAL, + ZEND_MOD_OPTIONAL_EX, + ZEND_MOD_CONFLICTS, and + ZEND_MOD_CONFLICTS_EX. + + + ZEND_MOD_REQUIRED_EX - ... + Create a full dependency entry for the required version of an extension @@ -16,8 +16,18 @@ char *ver - ... + ZEND_MOD_REQUIRED_EX generates a zend_module_dep + entry for the extension named by ext_name, including version + information. It allows to specify requirements like "up to version x.y", + "starting with version x.y" or "exactly version x.y". + + + Version specific comparisons are not implemented yet, + so for now ZEND_MOD_REUQUIRE and + ZEND_MOD_REQUIRE_EX define identical behavior. + + @@ -28,7 +38,7 @@ name - ... + Name of the required extension @@ -36,7 +46,8 @@ rel - ... + Comparison operator, one of eq, lt, + le, gt, or ge @@ -44,7 +55,7 @@ ver - ... + Version string @@ -55,10 +66,23 @@ &reftitle.returnvalues; - ... + Code to register the required extension + + &reftitle.seealso; + + See ZEND_MOD_REQUIRED if you do not need to + specify extension version requirements. + + + See also ZEND_MOD_OPTIONAL, + ZEND_MOD_OPTIONAL_EX, + ZEND_MOD_CONFLICTS, and + ZEND_MOD_CONFLICTS_EX. + +