Re: [HACKERS] Contrib module "xml2" status

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

2013/2/22 Andrew Dunstan <andrew(at)dunslane(dot)net>:
>
> 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.

Documentation patch attached.

> 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.

It might be worth adding an explicit entry in the TODO list for removing this
and summarising what needs to be done.

https://wiki.postgresql.org/wiki/Todo#XML

Regards

Ian Barwick

Attachment Content-Type Size
doc-contrib-xml2-2013-02-22.patch application/octet-stream 1.4 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Peter Eisentraut 2013-02-23 05:30:40 Re: Incomplete compatibility information for triggers
Previous Message Andrew Dunstan 2013-02-21 18:06:27 Re: [DOCS] Contrib module "xml2" status

Browse pgsql-hackers by date

  From Date Subject
Next Message Andres Freund 2013-02-21 23:32:08 Re: Materialized views WIP patch
Previous Message Fabrízio de Royes Mello 2013-02-21 23:07:41 Re: Call for Google Summer of Code mentors, admins