Re: ext/zip, initial documentation
| From: | Nuno Lopes | Date: | Thu, 10 Aug 2006 22:37:37 +0000 |
| Subject: | Re: ext/zip, initial documentation | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969373702@lists.php.net to get a copy of this message | ||
OK, so here it goes:
* again, no tabs allowed
* the "<!-- splitted from ./en/functions/zip.xml, last change in rev 1.11 -->" comment should be removed from the new files. it is there on old files to help translators. it doesn't have any mean on new files.
* use the &return.success; entity when possible
* use the &true; and &false; entities for PHP boolean values
* mark the constants as <constant>, not as <literal>
non doc related: why doesn't the ZipArchive class have a constructor that accept a filename as argument, so that we could write:
$zip = new ZipArchive('test.zip');
$zip->deleteName(...);
Thats all folks! I'm going to sleep
Nuno
----- Original Message -----
Hello, Here is a first version of the Zip documentation. I covers mostly all new features. It passes "make test" and the generated pages seem to be correct, however I prefer to have a deeper review prior to commit. Philip? :) Please find the docbook docs here: http://blog.thepimp.net/misc/zip/zipxml.tgz and the results: http://blog.thepimp.net/misc/zip/html/ref.zip.html Thanks in advance, -- Pierre