PHP :: Doc Bug #18756 :: August Edition Format Poorly Designed

August Edition Format Poorly Designed

Submitted:

2002-08-06 11:41 UTC

Modified:

2003-02-27 08:42 UTC

Votes:	1
Avg. Score:	4.0 ± 0.0
Reproduced:	1 of 1 (100.0%)
Same Version:	1 (100.0%)
Same OS:	1 (100.0%)

From:

xilord at yahoo dot com

Assigned:

Status:

Closed

Package:

Documentation problem

PHP Version:

4.2.2

OS:

Windows 2000 Server

Private report:

CVE-ID:

None

View Developer Edit

[2002-08-06 11:41 UTC] xilord at yahoo dot com

08-04-03: I've downloaded the new manual format today and must say I'm very surprised. Alphabetical function list is great, but where's the old Language Reference? Would be nice to have functions grouped by class/reference rather than have them all listed alphabetically. I'm pretty familiar with most PHP functions, however, I've not yet memorized the entire language reference. Having functions/methods/etc grouped by functionality (ie Images, Flash, etc) makes it much more simple to lookup functions.

Patches

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports

[2002-08-06 11:43 UTC] xilord at yahoo dot com

08-04-02 not 08-04-03 =)

[2002-08-06 12:31 UTC] hholzgra@php.net

which manual version/file-format are you talking about?
HTML, HTMP-for-print, PostScript, PDF, CHM ?

[2002-08-06 12:35 UTC] xilord at yahoo dot com

Sorry ... thought I'd included the version ... it's the CHM Windows Help formatted version.

[2002-08-07 06:58 UTC] goba@php.net

See the index page and the TOC, functions are grouped by extension as usual...

[2002-08-07 07:23 UTC] xilord at yahoo dot com

My TOC verbatim:
Appendix K. Function Index
Function Index


My Function Index verbatim:
PHP Manual
Stig S?ther Bakken
Alexander Aulbach
Egon Schmid
Jim Winstead
Lars Torben Wilson
Rasmus Lerdorf
Andrei Zmievski
Jouni Ahto
Edited by
Stig S?ther Bakken
Egon Schmid 



This file was generated: Fri Aug 02 04:10:35 2002
Go to http://www.php.net/docs.php to get the actual version.



Copyright ? 1997, 1998, 1999, 2000, 2001, 2002 the PHP Documentation Group

My Function List
Function Index
A
abs()
acos()
acosh()
addcslashes()
addslashes()
apache_child_terminate()
apache_lookup_uri()
apache_note()
apache_request_headers()
apache_response_headers()
apache_setenv()
array()
array_change_key_case()
array_chunk()
array_count_values()
array_diff()
array_fill()
array_filter()
array_flip()
array_intersect()
array_key_exists()
array_keys()
array_map()
array_merge()
array_merge_recursive()
array_multisort()
array_pad()

etc ... etc ... etc ...

As shown above. Listed alphabetically. No grouping is shown. I'm not sure if the version I'm downloading is complete or not.

[2002-08-07 07:27 UTC] xilord at yahoo dot com

One other thing, when in an actual function document, if I click 'Locate' to locate the navigation location, it goes nowhere. There is no direct navigation to each function. I have to click through the function list to get to specific function documents. Documents cannot be reached by clicking in the navigation tree directly.

[2002-08-07 07:33 UTC] goba@php.net

So this is a bug in the CHM generation. Can you please download a newer version and check if the problem still exists? Derick, can you please look at this?

[2002-08-07 08:49 UTC] xilord at yahoo dot com

I had downloaded a fresh version at the time of my last comment ... 7 Aug 7:23am

[2002-08-08 06:58 UTC] derick@php.net

will check when I'm back from vacation

Derick

[2002-10-31 11:42 UTC] iliaa@php.net

Is still still an issue in the 10th edition of the chm documentation avaliable from http://weblabor.hu/php-doc-chm/ ?

[2002-11-01 04:16 UTC] goba@php.net

Iliaa, this bug report is not about the new edition but about the usual one downloadable from php.net. BWT I'll work on it to make the new one the default one, but it will need some work to do on the language support side...

[2002-11-07 20:21 UTC] xilord at yahoo dot com

FYI ... I attempted a download of the latest version (again) and it doesn't even open on my machine. Tried downloading from the PHP.net site only. Its 988kb. I'm assuming something happened on upload.

[2003-02-27 08:42 UTC] derick@php.net

Fixed, we now check for the interegity of the uploaded files before we publish them.

Derick

	php.net \| support \| documentation \| report a bug \| advanced search \| search howto \| statistics \| random bug \| login
go to bug id or search bugs for


Copyright © 2001-2024 The PHP Group All rights reserved.	Last updated: Sat Aug 17 10:01:28 2024 UTC