Peter Clarke wrote:
Currently the online manual for php is great.
My concern is that the documentation for PECL extensions is almost non-existent. Since some php extensions are being moved/replaced by PECL extensions are we going to get non-existent documentation?
Hi there,
You might want to get onto one of the PECL lists if you intend to use it.
http://pecl.php.net/support.php
Someone there would be better able to help you. However, the short answer to your question is:
"The docs will be written when somebody decides to sit down and write them."
The glib answer is just to give you the checkout information for the docs source tree. ;) A huge percentage of the current manual was written by people who realized there was no documentation, and decided to remedy the problem.
In fact, it's how I learned about PHP's internals, and about a great deal of what makes it tick on the inside. Reading the source and translating it into documentation is a wonderful learning tool.
For now, you're probably just safest sticking with mime_content_type(). If you're worried about it becoming obsolete (read: being moved fully to PECL from one version to the next), then wrap mime_content_type() in a function or class, and stick it in its own include file. When you have the information you need to move on to the PECL replacement, just write another copy of that same function, but have it access Fileinfo instead of mime_content_type(). Assuming that you've written both versions of the function to take the same (or similar) argument lists and return the same thing, then all you need to do to change from one to the other is replace the old include file with the new one.
Hope this helps,
Torben Wilson <[EMAIL PROTECTED]>
For example:
www.php.net/mime-magic
"This extension has been deprecated as the PECL extension fileinfo provides the same functionality (and more) in a much cleaner way."
http://pecl.php.net/package/Fileinfo provides no documentation so what these extra functions are, I have no idea. Worse, I now have no idea how to do mime_content_type().
www.php.net/mcal
"Note: This extension has been removed as of PHP 5 and moved to the PECL repository."
There is no mention of mcal on the pecl website.
I appreciate that PECL will more relevant to PHP5, but PHP5 is close is the documentation close too?
-Peter
-- PHP General Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
