[Bug 10864] New: [XQuery11] Wrong description of function annotation prefixes in section 4.15

http://www.w3.org/Bugs/Public/show_bug.cgi?id=10864

           Summary: [XQuery11] Wrong description of function annotation
                    prefixes in section 4.15
           Product: XPath / XQuery / XSLT
           Version: Member-only Editors Drafts
          Platform: PC
        OS/Version: Windows NT
            Status: NEW
          Severity: normal
          Priority: P2
         Component: XQuery 1.1
        AssignedTo: jonathan.robie@redhat.com
        ReportedBy: oliver@cbcl.co.uk
         QAContact: public-qt-comments@w3.org
             Group: XSLXQuery_WG


Section 4.15 contains the following sentence:

Annotations are (QName, value) pairs. If the EQName of the annotation is a
lexical QName, the prefix of the QName is resolved using the statically known
namespaces; if no prefix is present, the name is in the default function
namespace. The XQuery family of languages define annotations in the fn
namespace. Assuming this the default element namespace is fn, the annotations
%private and %fn:private both have the same annotation name.

This last sentence has a number of problems:
* The word "this" should be "that"
* "default element namespace" should read "default function namespace"
* Where it says "fn" it means "the fn namespace", or better yet
"http://www.w3.org/2005/xpath-functions"
* There should be an additional restriction "and the fn prefix is bound to
'http://www.w3.org/2005/xpath-functions'".

Applying all these changes:

"Assuming that the default function namespace is bound to its default value of
"http://www.w3.org/2005/xpath-functions" and the fn prefix is also bound to its
default value of "http://www.w3.org/2005/xpath-functions", the annotations
%private and %fn:private both have the same annotation name.

But after fixing this sentence it seems a little cumbersome, almost to the
point of being useless!

-- 
Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.

Received on Thursday, 30 September 2010 15:54:34 UTC