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

go to bug id or search bugs for

Bug #36659 Slightly confusing setup of manual links (in the error messages)
Submitted: 2006-03-09 01:40 UTC Modified: 2006-03-14 03:00 UTC
From: daniel at softel dot jp Assigned:
Status: Closed Package: Unknown/Other Function
PHP Version: 5.1.2 OS: NA
Private report: No CVE-ID: None
View Developer Edit
 [2006-03-09 01:40 UTC] daniel at softel dot jp 
Description:
------------
Hello,

The "links that point to a copy of the PHP manual" in the error messages in PHP 5 is cool but I was slightly confused. The default "manual document root" in php.ini is "phpmanual" but the download bundle from www.php.net has a folder called "html". Also, it wasn't immediately clear if the "manual document root" in php.ini should point to the manual files' parent folder or the parent-parent folder. This is very low-priority stuff, but I was hoping it would be more semantic.

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2006-03-12 16:18 UTC] takagi@php.net 
Recalssifying as a configuration issue.
 [2006-03-12 16:24 UTC] tony2001@php.net 
I don't see any "html" folder neither in php sources tarball, nor in win32 zip archive. 
What are you talking about and what do you think should be default path for something that could not exist on user computer at all?
And bear in mind that there is no standard path for local PHP documentation.
 [2006-03-13 03:03 UTC] takagi@php.net 
I think he is talking about "Many HTML files (tar.gz)" version of the manual which is found at http://www.php.net/download-docs.php

When we download "php_manual_xx.tar.gz" and expand it, we can see "html" directory there.
 [2006-03-13 06:43 UTC] daniel at softel dot jp 
Let me clarify,
Downloading and expanding the "Many HTML files (tar.gz)" documentation tarball results in a folder called "html".
However, the default "manual document root" in php.ini is "phpmanual". This is confusing. Also it isn't stated anywhere that for the documentation links in the error messages, the "Many HTML files" version of the documentation must be installed.
 [2006-03-13 08:29 UTC] tony2001@php.net 
It looks quite clear that to make docu links working you need the documentation itself.
And I don't see why it's so difficult to put the docs somewhere and change "phpmanual" to the real path.
 [2006-03-14 03:00 UTC] daniel at softel dot jp 
Closed by submitter.
 
PHP Copyright © 2001-2025 The PHP Group
All rights reserved. 		Last updated: Tue Jul 15 13:01:34 2025 UTC