[PHP-DOC] Re: [PHP-DEV] php_error_docref From: 'Ricky' S Dhatt (rdhatt <email protected>)
Date: 08/13/02

On Tue, 13 Aug 2002, Dan Kalowsky wrote:

> On Tue, 13 Aug 2002, Marcus [iso-8859-1] Börger wrote:
>
> > The point is to be able to direct to external sites not on php.net! For
> > example
> > when a function is just a wrapper around a library then you can use the
> > absolute
> > form of the docref parameter ("http://>") to point to the library's
> > website.
>
> Okay thats a point I hadn't thought of. Though I'm not sure why we'd be
> referencing outside sites. Can we then change the CODING_STANDARD
> example to NOT use the php.net website? Hopefully stopping anyone from
> using it as a reference to any php-specific documentation, and only for
> external sites.

Do you think this will help the lost PHP script writer? For example, the
cURL extension is really just a wrapper around libcurl. If they get an
error on curl_setopt() do you really want to direct them to the C API
docs on the cURL site? I think it should always point to the php.net
manual; external sites won't help the PHP script writer with their PHP
code. From the PHP manual they can go to library website if need be.

My $.02.

--Ricky 

-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php