X-Original-To: pgsql-docs-postgresql.org@postgresql.org Received: from localhost (mx1.hub.org [200.46.208.251]) by postgresql.org (Postfix) with ESMTP id 7A09E9FB340 for ; Tue, 5 Sep 2006 04:58:40 -0300 (ADT) Received: from postgresql.org ([200.46.204.71]) by localhost (mx1.hub.org [200.46.208.251]) (amavisd-new, port 10024) with ESMTP id 89730-02 for ; Tue, 5 Sep 2006 04:58:37 -0300 (ADT) X-Greylist: domain auto-whitelisted by SQLgrey- Received: from py-out-1112.google.com (py-out-1112.google.com [64.233.166.176]) by postgresql.org (Postfix) with ESMTP id 841D39FB2C6 for ; Tue, 5 Sep 2006 04:58:37 -0300 (ADT) Received: by py-out-1112.google.com with SMTP id d80so3001648pyd for ; Tue, 05 Sep 2006 00:58:36 -0700 (PDT) DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com; h=received:message-id:date:from:reply-to:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=ghjWFIZbcX+Q/9JG52G1EoaV4WgyvC4FkFIp7LEXeTPfuZgNfjoTi8g/R6/TDlPMe6Z0CVtXJtT9detNQb+YQevc71MImq22dlTHlIGEu8YeibzMOEqkvFslXCRKZU6CvOkO+M1L+t5UMSwmyO7NXfEok20EX93uZgYOaoMhnqM= Received: by 10.65.240.17 with SMTP id s17mr6625849qbr; Tue, 05 Sep 2006 00:58:36 -0700 (PDT) Received: by 10.64.250.15 with HTTP; Tue, 5 Sep 2006 00:58:36 -0700 (PDT) Message-ID: Date: Tue, 5 Sep 2006 11:58:36 +0400 From: "Nikolay Samokhvalov" Reply-To: nikolay@samokhvalov.com To: "Peter Eisentraut" Subject: Re: [HACKERS] New XML section for documentation Cc: "Bruce Momjian" , PostgreSQL-development , PostgreSQL-documentation In-Reply-To: <200608262041.33396.peter_e@gmx.net> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <200608261620.k7QGKn729150@momjian.us> <200608262041.33396.peter_e@gmx.net> X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=0.183 tagged_above=0 required=5 tests=AWL, DNS_FROM_RFC_ABUSE, SPF_PASS X-Spam-Level: X-Archive-Number: 200609/5 X-Sequence-Number: 3692 On 8/26/06, Peter Eisentraut wrote: > Bruce Momjian wrote: > > I made it clear in the section that the XML syntax was being checked, > > not validation against a schema. You want Check and Validation > > sections? > > "Valid" and "well-formed" have very specific distinct meanings in XML. > (Note that "check" doesn't have any meaning there.) We will eventually > want a method to verify both the validity and the well-formedness. > > I think that a function called xml_valid checks for well-formedness is > an outright bug and needs to be fixed. That's exactly what I'm talking about. xml_valid() is wrong name and it may confuse people. I what to add that, with XML section in the documentation, this bug becomes more significant. Bruce suggested to use overload to keep backward compat. - in other words, 1-arg function for checking for well-formedness and 2-arg function for validation process. That's bad too: - two _different_ actions for one function => another confusion - I (as a user) would think that 1-arg function is designed for validation process for cases when XML document contains a reference to DTD (as an example). I stand for fixing it via renaming, breaking backward compatibility. Later it will be more painful. BTW, what is the deadline for changes (additions) in docs? I would add general XML terms (such as what is XML, what is well-formed document, what is validation; short overview of XML standards and SQL/XML as a part of SQL:200n, etc Maybe about contrib/xml2 installation process - actually, XSLT support requires additional lib). Moreover, if SQL/XML patch will be accepted it will require several words too. -- Best regards, Nikolay