cvs: phpdoc /scripts zendapi_protos.php
| From: | Hartmut Holzgraefe | Date: | Sat, 14 Jan 2006 12:29:06 +0000 |
| Subject: | cvs: phpdoc /scripts zendapi_protos.php | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969371548@lists.php.net to get a copy of this message | ||
hholzgra Sat Jan 14 12:29:06 2006 UTC
Modified files:
/phpdoc/scripts zendapi_protos.php
Log:
- added zend_unicode.h to parse list
- don't overwrite already existing files
http://cvs.php.net/viewcvs.cgi/phpdoc/scripts/zendapi_protos.php?r1=1.11&r2=1.12&diff_format=u
Index: phpdoc/scripts/zendapi_protos.php
diff -u phpdoc/scripts/zendapi_protos.php:1.11 phpdoc/scripts/zendapi_protos.php:1.12
--- phpdoc/scripts/zendapi_protos.php:1.11 Sat Jan 14 11:46:14 2006
+++ phpdoc/scripts/zendapi_protos.php Sat Jan 14 12:29:06 2006
@@ -7,7 +7,7 @@
"zend_hash.h",
"zend_list.h",
"zend_variables.h",
- "zend_unicode.h");
+ "zend_unicode.h");
$functions_dir = "../en/internals/zendapi/functions/";
@@ -31,13 +31,8 @@
// parse prototypes, step #1
if (preg_match('|^ZEND_API\s+(\S+)\s+(\S+)\((.*)\);$|', $line, $matches)) {
-
- // now write the template file to phpdoc/en/internals/zendapi/functions
- ob_start();
- echo '<?xml version="1.0"
encoding="iso-8859-1"?>'."\n";
- echo "<!-- $"."Revision: 1.3 $ -->\n";
-
+ // extract return type and function name
$return_type = $matches[1];
$function = $matches[2];
@@ -48,30 +43,42 @@
$function = substr($function, 1);
}
- // the parameters are spearated by commas
- // TODO find a better way to handle TSRMLS_D and TSRMLS_DC
- // TODO handle ...
- $params = array();
- foreach (explode(",", trim($matches[3])) as $param) {
- $new_param = array();
-
- $tokens = preg_split("/\s+/", trim($param));
- $type = array_shift($tokens);
- $name = implode(" ", $tokens);
-
- if (empty($name)) {
- $new_param['type'] = "";
- $new_param['name'] = $type;
- } else {
- while ($name[0] == '*') {
- $type.= "*";
- $name = substr($name, 1);
+ // now generate the doc filename for this function
+ $filename = $functions_dir."/".$function.".xml";
+
+ // only proceed it fhe file doesn't exist yet (no overwrites)
+ // and do not expose functions staring with '_'
+ if (($function[0] == '_') && !file_exists($filename)) {
+ // now write the template file to phpdoc/en/internals/zendapi/functions
+ ob_start();
+
+ echo '<?xml version="1.0"
encoding="iso-8859-1"?>'."\n";
+ echo "<!-- $"."Revision: 1.3 $ -->\n";
+
+ // the parameters are spearated by commas
+ // TODO find a better way to handle TSRMLS_D and TSRMLS_DC
+ // TODO handle ...
+ $params = array();
+ foreach (explode(",", trim($matches[3])) as $param) {
+ $new_param = array();
+
+ $tokens = preg_split("/\s+/", trim($param));
+ $type = array_shift($tokens);
+ $name = implode(" ", $tokens);
+
+ if (empty($name)) {
+ $new_param['type'] = "";
+ $new_param['name'] = $type;
+ } else {
+ while ($name[0] == '*') {
+ $type.= "*";
+ $name = substr($name, 1);
+ }
+ $new_param['type'] = $type;
+ $new_param['name'] = $name;
}
- $new_param['type'] = $type;
- $new_param['name'] = $name;
+ $params[] = $new_param;
}
- $params[] = $new_param;
- }
?>
@@ -87,9 +94,9 @@
<methodsynopsis>
<type><?php echo $return_type; ?></type><methodname><?php echo
$function; ?></methodname>
<?php
- foreach($params as $param) {
- echo "
<methodparam><type>$param[type]</type><parameter>$param[name]</parameter></methodparam>\n";
- }
+ foreach($params as $param) {
+ echo "
<methodparam><type>$param[type]</type><parameter>$param[name]</parameter></methodparam>\n";
+ }
?>
</methodsynopsis>
<para>
@@ -102,7 +109,7 @@
<para>
<variablelist>
<?php
- foreach($params as $param) {
+ foreach($params as $param) {
?>
<varlistentry>
<term><parameter><?php echo $param["name"];
?></parameter></term>
@@ -113,7 +120,7 @@
</listitem>
</varlistentry>
<?php
- }
+ }
?>
</variablelist>
</para>
@@ -150,8 +157,9 @@
-->
<?php
- file_put_contents($functions_dir."/".$function.".xml",
ob_get_clean());
- }
+ file_put_contents($filename, ob_get_clean());
+ }
+ }
}