#36659 [Opn->Bgs]: Slightly confusing setup of manual links (in the error messages)

From: Date: Mon, 13 Mar 2006 07:29:52 +0000
Subject: #36659 [Opn->Bgs]: Slightly confusing setup of manual links (in the error messages)
References: 1  Groups: php.bugs 
Request: Send a blank email to php-bugs+get-94246@lists.php.net to get a copy of this message
 ID:               36659
 Updated by:       tony2001@php.net
 Reported By:      daniel at softel dot jp
-Status:           Open
+Status:           Bogus
 Bug Type:         Unknown/Other Function
 Operating System: NA
 PHP Version:      5.1.2
 New Comment:

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.



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

[2006-03-13 06:43:41] 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 03:03:10] 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-12 16:24:22] 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-12 16:18:28] takagi@php.net

Recalssifying as a configuration issue.

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

[2006-03-09 01:40:38] 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.



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


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


Thread (7 messages)

« previous php.bugs (#94246) next »