Newsgroups: php.doc,php.internals
Path: news.php.net
Xref: news.php.net php.doc:969385584 php.internals:85894
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 74.125.82.50 as permitted sender)
MIME-Version: 1.0
In-Reply-To: <CAMc0WS6zkOe2s81MT6Utft0oigD=bxMRHWyaafQqWs2bEEBQ9A@mail.gmail.com>
References: <CAMc0WS6q49-+ThWftnPwsb5ZMT_m3EVi1Eik_mO5WvtqmhBjeA@mail.gmail.com>
 <CAPg3XxLrg3bQ3VbJkqFoJgyx0hubwLaPwVPTWyKk0TZEJYeauw@mail.gmail.com>
 <CAPg3Xx+5Ny=mod1YREW6nPjmiMYzKE6unSJyT5eVFD6WOvaFGA@mail.gmail.com> <CAMc0WS6zkOe2s81MT6Utft0oigD=bxMRHWyaafQqWs2bEEBQ9A@mail.gmail.com>
Date: Wed, 22 Apr 2015 11:57:30 +0100
Message-ID: <CAPg3Xx+bqtHcNK9-Cekx0sixLwXw_FN4YHQ_K3=aaWQ_pRVQZQ@mail.gmail.com>
To: Stelian Mocanita <stelianm@php.net>
Cc: PHP Internals List <internals@lists.php.net>, PHP Documentation ML <phpdoc@lists.php.net>
Content-Type: multipart/alternative; boundary=089e013c6b5af1b25405144e0902
Subject: Re: [PHP-DEV] PDO Oracle driver
From: petercowburn@gmail.com (Peter Cowburn)

--089e013c6b5af1b25405144e0902
Content-Type: text/plain; charset=UTF-8

On 22 April 2015 at 11:40, Stelian Mocanita <stelianm@php.net> wrote:

> 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?
>

We have boilerplate text for marking PECL extensions as dead, and we would
use that again here.

However, I'd hold off on that until a decision (if any) has been made on
what to do with the extension itself, like moving it (back) to PECL. We
shouldn't be distributing a "dead" extension in the main php-src tree, nor
proclaiming an extension "dead" in the manual when that hasn't been
"officially" decided yet.


>
> 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
>>
>
>

--089e013c6b5af1b25405144e0902--