PHP 4.0 Bug #9942: function proliferation making the online manual useless
| From: | delme at jumeaux dot bc dot ca | Date: | Thu, 22 Mar 2001 21:44:07 +0000 |
| Subject: | PHP 4.0 Bug #9942: function proliferation making the online manual useless | ||
| Groups: | php.dev | ||
| Request: | Send a blank email to php-dev+get-49779@lists.php.net to get a copy of this message | ||
From: delme@jumeaux.bc.ca
Operating system: N/A
PHP version: 4.0.4pl1
PHP Bug Type: Documentation problem
Bug description: function proliferation making the online manual useless
as a longtime php user who relies on the online manual, i just want to make sure someone's
aware that the online manual is rapidly becoming unusable. one great thing about php is how it
grows to handle just about *everything*... but the manual needs to put some restrictions on that.
right now there are 80+ sections in the `features' part of the manual. this makes it well-nigh
impossible to find what you're looking for.
you need to divide these sections into several parts. my suggestion would be to have a section for
`core' language features, and then one for additional, system- and package-specific
functionality, like yp/nis, windows com, pdf, etc etc. due to the extreme proliferation of these
package addons, perhaps that second section should be even further divided, though i'm not
certain how. perhaps into OS-specific, file format-specific, and so on?
thanks for your attention to this.
-damon
--
Edit Bug report at: http://bugs.php.net/?id=9942&edit=1