ID: 36769
Updated by: [EMAIL PROTECTED]
-Summary: Proposal: Categorization of Function Reference in PHP
manual
Reported By: woecherl at mlcomputing dot de
-Status: Open
+Status: Closed
Bug Type: Documentation problem
Operating System: - not relevant -
PHP Version: Irrelevant
New Comment:
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.
Thank you for the report, and for helping us make our documentation
better.
Previous Comments:
------------------------------------------------------------------------
[2006-03-17 14:27:56] woecherl at mlcomputing dot de
Ok, the "Extension Categorization" is about what I meant. Since it is
not too obvious in the manual's huge main index I would like to suggest
to set a link with text e.g. "(for categorized list see Appendix I.)"
below the entry "Function Reference".
------------------------------------------------------------------------
[2006-03-17 13:03:50] [EMAIL PROTECTED]
Take a look at http://www.php.net/manual/en/extensions.php .
------------------------------------------------------------------------
[2006-03-17 11:39:44] RQuadling at GMail dot COM
This is a good idea, but not all the current chapters will be able to
be grouped.
id3, image and math are just 3 chapters which have no counterparts. So
these would either need to go into a derogatory "Other" subchapter or
remain as they are.
It makes sense to group database, encryption, compression (and others)
chapters into subchapters as there are many chapters for each of these
topics.
------------------------------------------------------------------------
[2006-03-17 10:57:45] woecherl at mlcomputing dot de
Description:
------------
In the PHP manual, section "VI. Function Reference" meanwhile is quite
a little long. I would like to suggest to introduce subchapters for
function groups, like "database", "basic" (i.e. string, variable etc.
functions) and so on. A similiar categorization is already on the bug
reporting page in the search dialog, the "category".
I know this might impose a little work on the guys who maintain the
manual (and they are doing a great job!), but maybe they find this
proposal useful and a little time to realize it.
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/?id=36769&edit=1
