Re: [DOCS] Contrib module "xml2" status

From: Andrew Dunstan <andrew(at)dunslane(dot)net>
To: Magnus Hagander <magnus(at)hagander(dot)net>
Cc: Robert Haas <robertmhaas(at)gmail(dot)com>, Ian Lawrence Barwick <barwick(at)gmail(dot)com>, pgsql-docs <pgsql-docs(at)postgresql(dot)org>, pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: [DOCS] Contrib module "xml2" status
Date: 2013-02-21 18:06:27
Message-ID: 51266223.803@dunslane.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers


On 02/21/2013 12:56 PM, Magnus Hagander wrote:
> On Thu, Feb 21, 2013 at 6:39 PM, Robert Haas <robertmhaas(at)gmail(dot)com> wrote:
>> On Wed, Feb 20, 2013 at 11:58 AM, Ian Lawrence Barwick
>> <barwick(at)gmail(dot)com> wrote:
>>> I'm not sure if this is a documentation or hackers issue, but the
>>> documentation page for contrib module "xml2" refers to PostgreSQL 8.4 in the
>>> future tense:
>>>
>>> "It is planned that this module will be removed in PostgreSQL 8.4 in
>>> favor of the newer standard API"
>>>
>>> http://www.postgresql.org/docs/devel/static/xml2.html
>>>
>>> Are there any plans to remove this module by a forseeable date?
>> Nope. I have repeatedly been voted down on removing it, and I've also
>> been repeatedly voted down on removing the deprecation text. Could we
>> at least agree on changing the deprecation text to say "This module is
>> deprecated and may be removed in a future release"?
> Not reopening the actual discussion about rmeoving it, but assuming
> we're not, strong +1 on changing the deprecation message. And don't
> forget to backpatch the change so it shows up in the old versions of
> the docs as well.
>

Yes, we should change it to remove the reference to 8.4. The point is we
can remove the module when someone fixes and replaces the functionality
that's left in there that some people rely on. So far nobody has stepped
up to the plate, although now that we have lateral a sane replacement
for xpath_table might well be a lot easier to achieve. If someone is
interested in working on this I'd be happy to hear about it. Maybe it
would be a good Google SOC project.

cheers

andrew

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Ian Lawrence Barwick 2013-02-21 23:25:31 Re: [HACKERS] Contrib module "xml2" status
Previous Message Magnus Hagander 2013-02-21 17:56:15 Re: [HACKERS] Contrib module "xml2" status

Browse pgsql-hackers by date

  From Date Subject
Next Message Merlin Moncure 2013-02-21 18:16:35 Re: JSON Function Bike Shedding
Previous Message Magnus Hagander 2013-02-21 17:56:15 Re: [HACKERS] Contrib module "xml2" status