Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1U8fWD-0005K3-Mu for pgsql-docs@arkaria.postgresql.org; Thu, 21 Feb 2013 23:25:37 +0000 Received: from localhost ([127.0.0.1] helo=postgresql.org) by malur.postgresql.org with smtp (Exim 4.72) (envelope-from ) id 1U8fWD-0006eA-1t for pgsql-docs@arkaria.postgresql.org; Thu, 21 Feb 2013 23:25:37 +0000 Received: from makus.postgresql.org ([2001:4800:7903:4::125]) by malur.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1U8fWB-0006d4-4c; Thu, 21 Feb 2013 23:25:35 +0000 Received: from ia-in-x0229.1e100.net ([2607:f8b0:4001:c02::229] helo=mail-ia0-x229.google.com) by makus.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1U8fW9-0004LN-85; Thu, 21 Feb 2013 23:25:34 +0000 Received: by mail-ia0-f169.google.com with SMTP id j5so66387iaf.28 for ; Thu, 21 Feb 2013 15:25:31 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:x-received:in-reply-to:references:date:message-id :subject:from:to:cc:content-type; bh=+rF0NlbZa5evZmC7h20/QTFKalfmdR0pwSiySVIiM5E=; b=A4P3DFFRco1cThQItY1oG4ecapdRAMA7EXUCJWSs6b1+yxUO1QW8w7mME3/8QLcYpP zN5/UzAl2SiuHbtJbZ87LTAN2pIvjmsK6oNvMZ7NYWk/ZoeW1rrSqNooAp2WaA2EfYJ9 BEO2q62631Kk0LqBwE9Kc2Rz3EWE1ALNESmytPIBQRpKXt+ijnu7IVjVk0TlpmPP9Qj5 y1nunwWlmy/LqKI8GKLnMa3bQVyOELo2BInVNTVLwhuskitqkmHamUnQFg+x8qj1I4Kg BNMvnptijtH+2ASS92I8FG0MPd/B5Ly3Ud/mz91Q07YhUbS+lkSth3wZx5j5OTy4JeT6 +o/Q== MIME-Version: 1.0 X-Received: by 10.50.237.70 with SMTP id va6mr1672845igc.66.1361489131541; Thu, 21 Feb 2013 15:25:31 -0800 (PST) Received: by 10.50.106.166 with HTTP; Thu, 21 Feb 2013 15:25:31 -0800 (PST) In-Reply-To: <51266223.803@dunslane.net> References:

<51266223.803@dunslane.net> Date: Fri, 22 Feb 2013 08:25:31 +0900 Message-ID: Subject: Re: [HACKERS] Contrib module "xml2" status From: Ian Lawrence Barwick To: Andrew Dunstan Cc: Magnus Hagander , Robert Haas , pgsql-docs , pgsql-hackers Content-Type: multipart/mixed; boundary=f46d044786f30d143004d64464c6 X-Pg-Spam-Score: -1.9 (-) List-Archive: List-Help: List-ID: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-Mailing-List: pgsql-docs Precedence: bulk Sender: pgsql-docs-owner@postgresql.org --f46d044786f30d143004d64464c6 Content-Type: text/plain; charset=UTF-8 2013/2/22 Andrew Dunstan : > > On 02/21/2013 12:56 PM, Magnus Hagander wrote: >> >> On Thu, Feb 21, 2013 at 6:39 PM, Robert Haas >> wrote: >>> >>> On Wed, Feb 20, 2013 at 11:58 AM, Ian Lawrence Barwick >>> 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 --f46d044786f30d143004d64464c6 Content-Type: application/octet-stream; name="doc-contrib-xml2-2013-02-22.patch" Content-Disposition: attachment; filename="doc-contrib-xml2-2013-02-22.patch" Content-Transfer-Encoding: base64 X-Attachment-Id: f_hdgjbit20 ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC94bWwyLnNnbWwgYi9kb2Mvc3Jj L3NnbWwveG1sMi5zZ21sCm5ldyBmaWxlIG1vZGUgMTAwNjQ0CmluZGV4IGNl NWEyZjAuLmE0Mjc3ODIKKioqIGEvZG9jL3NyYy9zZ21sL3htbDIuc2dtbAot LS0gYi9kb2Mvc3JjL3NnbWwveG1sMi5zZ21sCioqKioqKioqKioqKioqKgoq KiogMjEsMzIgKioqKgogICAgIFRoYXQgZnVuY3Rpb25hbGl0eSBjb3ZlcnMg WE1MIHN5bnRheCBjaGVja2luZyBhbmQgWFBhdGggcXVlcmllcywKICAgICB3 aGljaCBpcyB3aGF0IHRoaXMgbW9kdWxlIGRvZXMsIGFuZCBtb3JlLCBidXQg dGhlIEFQSSBpcwogICAgIG5vdCBhdCBhbGwgY29tcGF0aWJsZS4gIEl0IGlz IHBsYW5uZWQgdGhhdCB0aGlzIG1vZHVsZSB3aWxsIGJlCiEgICAgcmVtb3Zl ZCBpbiBQb3N0Z3JlU1FMIDguNCBpbiBmYXZvciBvZiB0aGUgbmV3ZXIgc3Rh bmRhcmQgQVBJLCBzbwohICAgIHlvdSBhcmUgZW5jb3VyYWdlZCB0byB0cnkg Y29udmVydGluZyB5b3VyIGFwcGxpY2F0aW9ucy4gIElmIHlvdQohICAgIGZp bmQgdGhhdCBzb21lIG9mIHRoZSBmdW5jdGlvbmFsaXR5IG9mIHRoaXMgbW9k dWxlIGlzIG5vdAohICAgIGF2YWlsYWJsZSBpbiBhbiBhZGVxdWF0ZSBmb3Jt IHdpdGggdGhlIG5ld2VyIEFQSSwgcGxlYXNlIGV4cGxhaW4KISAgICB5b3Vy IGlzc3VlIHRvIHBnc3FsLWhhY2tlcnNAcG9zdGdyZXNxbC5vcmcgc28gdGhh dCB0aGUgZGVmaWNpZW5jeQohICAgIGNhbiBiZSBhZGRyZXNzZWQuCiAgICA8 L3BhcmE+CiAgIDwvc2VjdDI+CiAgCi0tLSAyMSwzMiAtLS0tCiAgICAgVGhh dCBmdW5jdGlvbmFsaXR5IGNvdmVycyBYTUwgc3ludGF4IGNoZWNraW5nIGFu ZCBYUGF0aCBxdWVyaWVzLAogICAgIHdoaWNoIGlzIHdoYXQgdGhpcyBtb2R1 bGUgZG9lcywgYW5kIG1vcmUsIGJ1dCB0aGUgQVBJIGlzCiAgICAgbm90IGF0 IGFsbCBjb21wYXRpYmxlLiAgSXQgaXMgcGxhbm5lZCB0aGF0IHRoaXMgbW9k dWxlIHdpbGwgYmUKISAgICByZW1vdmVkIGluIGEgZnV0dXJlIFBvc3RncmVT UUwgdmVyc2lvbiBpbiBmYXZvciBvZiB0aGUgbmV3ZXIgCiEgICAgc3RhbmRh cmQgQVBJLCBzbyB5b3UgYXJlIGVuY291cmFnZWQgdG8gdHJ5IGNvbnZlcnRp bmcgeW91cgohICAgIGFwcGxpY2F0aW9ucy4gIElmIHlvdSBmaW5kIHRoYXQg c29tZSBvZiB0aGUgZnVuY3Rpb25hbGl0eSBvZiB0aGlzIAohICAgIG1vZHVs ZSBpcyBub3QgYXZhaWxhYmxlIGluIGFuIGFkZXF1YXRlIGZvcm0gd2l0aCB0 aGUgbmV3ZXIgQVBJLCAKISAgICBwbGVhc2UgZXhwbGFpbiB5b3VyIGlzc3Vl IHRvIHBnc3FsLWhhY2tlcnNAcG9zdGdyZXNxbC5vcmcgc28gdGhhdAohICAg IHRoZSBkZWZpY2llbmN5IGNhbiBiZSBhZGRyZXNzZWQuCiAgICA8L3BhcmE+ CiAgIDwvc2VjdDI+CiAgCg== --f46d044786f30d143004d64464c6 Content-Type: text/plain Content-Disposition: inline Content-Transfer-Encoding: 8bit MIME-Version: 1.0 -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs --f46d044786f30d143004d64464c6--