php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #39083 If index were sorted you could find stuff
Submitted: 2006-10-08 20:12 UTC Modified: 2007-12-26 18:04 UTC
From: jimc at math dot ucla dot edu Assigned: bjori (profile)
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS: Linux (SuSE 10.1)
Private report: No CVE-ID: None
View Developer Edit
 [2006-10-08 20:12 UTC] jimc at math dot ucla dot edu 
Description:
------------
This is a feature request: to organize the Function Reference section of the index page into categories.  This actually refers to php-doc version 5.0.3 copyright date 2005-01-13, which is the version in my distro.  With 137 categories in alphabetical order, it's very hard to even comprehend what's available, or to find something if you don't already know what it's called.  I just spent an hour hand-editing the index page into an order that seems semi-sane to me: http://papyrus.math.ucla.edu/php-doc/index-jimc.html
I don't know how this could be made to happen automatically with docbook, but don't the developers think that this page is a lot more useable than the original one?

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2006-10-08 20:50 UTC] philip@php.net 
Have a look at:
http://php.net/extensions

There was talk of having something like this in the index (as you propose) but I don't remember where we're at on that. How does it look to you?
 [2006-10-11 04:29 UTC] jimc at math dot ucla dot edu 
Excellent!  It would be great if you could get this into the regular documentation.  The Function Reference section looks like it's automatically generated, and the category grouping won't happen by magic, but I don't know enough about docbook to help on this.
 [2007-08-17 15:57 UTC] vrana@php.net 
That's why we have both extensions categorization and extensions index. Index is preferred currently.
 [2007-08-24 16:34 UTC] philip@php.net 
Hannes is working on this.
 [2007-10-08 12:22 UTC] bjori@php.net 
http://livedocs.phpdoc.info/manual/en/funcref.php

How is this? :)
 [2007-10-09 00:25 UTC] jimc at math dot ucla dot edu 
This is great!  Only one small suggestion: under Database Extensions, the page for Vendor Specific Database Extensions is rather long.  Could some way be found to get each vendor's interface on a separate page, as on the PDO page?  The Abstraction Layers page has the same issue but not as extreme.  Possibly the individual vendors' pages could be listed in the toplevel page, or possibly an intermediate index would be better.  
    I'm definitely going to install the latest version and to convert some nasty code to use PDO.
 [2007-10-13 13:14 UTC] bjori@php.net 
I'll look into it
 [2007-12-26 18:04 UTC] bjori@php.net 
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.

See http://docs.php.net/manual/en/refs.database.php
 
PHP Copyright © 2001-2025 The PHP Group
All rights reserved. 		Last updated: Wed Nov 19 17:00:01 2025 UTC