ID:               41182
 Updated by:       [EMAIL PROTECTED]
 Reported By:      uttam at hotpop dot com
 Status:           Open
 Bug Type:         Documentation problem
 Operating System: Irrelavant
 PHP Version:      Irrelevant
 New Comment:

It's tough to do it nicely, perhaps you can create a partial mockup of
the layout? One of the troubles is it can't be too wide, and must be
easy to find extensions.

This comes up from time to time but no decent solution has been found.
There will be a time when we have 1000 PECL extensions so perhaps by
then we'll be forced to solve this problem for good :-)

One of the proposed solutions is to have people choose their extensions
but IMHO that is not a solution. By default all extensions will be
listed, and most people don't know what extensions to list and/or would
be missing out on some goodies later. But then again when there are 1000
PECL extensions we can't list them all within the sidebar.

See how complicated this gets? :)




Previous Comments:
------------------------------------------------------------------------

[2007-04-25 05:28:51] uttam at hotpop dot com

Yes, I think a similar grouping scheme would be useful. However, the
line spacing was too much on the page
http://in.php.net/manual/en/extensions.php, due to which you have to
scroll a lot. 

We can continue listing the functions in the Function Index. But let me
clarify, I have not referred to the Function Index in my earlier post. I
have refered to the section "Function Reference" in Table of Contents on
page http://www.php.net/manual/en/.

Regards,

------------------------------------------------------------------------

[2007-04-25 05:12:32] [EMAIL PROTECTED]

Do you feel it would be useful to have categories like the following:

  http://php.net/manual/extensions

But for the Function Index list the functions too?

------------------------------------------------------------------------

[2007-04-25 05:05:18] uttam at hotpop dot com

Description:
------------
Hi,

The list of functions under section "Function Reference" in PHP Manual
(http://www.php.net/manual/en/) has grown too long. The list is sorted
alphabetically, due to which many similar categories appear at very
different place in TOC. Here are a few examples"

1. ".NET Fuctions" and "COM and .NET Functions"
2. "ClibPDF Fucntions", "Haru PDF Functions", and "PDF Functions"
3. "DOM XML Functions", "libXML Functions", and "SimpleXML Functions"
4. "String Functions" and "Multibyte String Functions"
5. "Image Functions" and "Exif Functions"

I think we should group the functions categories under different
sections such as "Database", "Mail","Imaging" etc. This would make it
easier to browse or search for a particular function. The word
"Functions" can also be omitted from each category because it is
obvious.

If creating sections is not feasible, we can atleast rename the
categories so that similar functions appear togather. For example the
cateogry "Multibye String Fuctions" can be renamed to "String Functions
- Multibye" so that it appears togather with the category "String
Fuctions" in TOC.

Thanks & Regards,

Uttam Shukla
Bangalore, India

Reproduce code:
---------------
NA

Expected result:
----------------
NA

Actual result:
--------------
NA


------------------------------------------------------------------------


-- 
Edit this bug report at http://bugs.php.net/?id=41182&edit=1

Reply via email to