Newsgroups: php.doc,php.internals
Path: news.php.net
Xref: news.php.net php.doc:969385583 php.internals:85893
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.215.47 as permitted sender)
MIME-Version: 1.0
Sender: stelian.mocanita@gmail.com
In-Reply-To: <CAPg3Xx+5Ny=mod1YREW6nPjmiMYzKE6unSJyT5eVFD6WOvaFGA@mail.gmail.com>
References: <CAMc0WS6q49-+ThWftnPwsb5ZMT_m3EVi1Eik_mO5WvtqmhBjeA@mail.gmail.com>
	<CAPg3XxLrg3bQ3VbJkqFoJgyx0hubwLaPwVPTWyKk0TZEJYeauw@mail.gmail.com>
	<CAPg3Xx+5Ny=mod1YREW6nPjmiMYzKE6unSJyT5eVFD6WOvaFGA@mail.gmail.com>
Date: Wed, 22 Apr 2015 12:40:01 +0200
Message-ID: <CAMc0WS6zkOe2s81MT6Utft0oigD=bxMRHWyaafQqWs2bEEBQ9A@mail.gmail.com>
To: Peter Cowburn <petercowburn@gmail.com>
Cc: PHP Internals List <internals@lists.php.net>, PHP Documentation ML <phpdoc@lists.php.net>
Content-Type: multipart/alternative; boundary=089e013d1010050f3905144dc9d5
Subject: Re: [PHP-DEV] PDO Oracle driver
From: stelianm@php.net (Stelian Mocanita)

--089e013d1010050f3905144dc9d5
Content-Type: text/plain; charset=UTF-8

Peter,

I did not know about the documentation part, thanks for clearing that out.

I would like to ask though, what is the benefit of having the dead
extensions there?
From my point of view, it does more harm than good having them in the
manual
(I am only referring here to extensions that never got to a production
grade).

On marking the extension as dead, how would we proceed in this case?

Thank you,
Stelian

On Wed, Apr 22, 2015 at 12:34 PM, Peter Cowburn <petercowburn@gmail.com>
wrote:

>
>
> On 22 April 2015 at 11:24, Peter Cowburn <petercowburn@gmail.com> wrote:
>
>> cc-ing doc list
>>
>> On 22 April 2015 at 10:40, Stelian Mocanita <stelian.mocanita@gmail.com>
>> wrote:
>>
>>> Hello internals,
>>>
>>> I would like to ask what on your thoughts on removing the Oracle drive
>>> for
>>> PDO from the documentation (http://us1.php.net/manual/en/ref.pdo-oci.php
>>> )
>>> at least since it's been experimental for a long time now, and it has
>>> long
>>> standing open bugs, such as:
>>>
>>
> From the documentation point of view:
>
> Just because an extension is considered experimental, or indeed
> unmaintained, is no reason to remove the extension from the manual.  We
> have a bunch of extensions marked as experimental [1] or dead [2] and I
> don't see why pdo_oci should be any different.
>
>
>>
>>> https://bugs.php.net/bug.php?id=37706
>>> https://bugs.php.net/bug.php?id=46728
>>> https://bugs.php.net/bug.php?id=60994
>>>
>>> I know that the extension is marked as experimental already but based on
>>> the current status, it's not even that and a significant amount of basic
>>> functionality is broken.
>>>
>>
> Let's mark the extension as "dead" in the manual, as we do with other dead
> extensions.
>
>
>>
>>> Regards,
>>> Stelian
>>>
>>
>>
> [1] bcompiler, blenc, dbplus, haru, memtrack, ming, paradox, pdo_4d,
> pdo_oci, sca, sdodasrel, spl_types, svn, swish, vpopmail, xmlrpc
> [2] classkit, fam, fdf, iisfunc, msession, nis, session_pgsql
>

--089e013d1010050f3905144dc9d5--