[Bug 10948] New: [XPath21] editorial: 2.1.1 Static Context: statically known decimal formats

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

           Summary: [XPath21] editorial: 2.1.1 Static Context: statically
                    known decimal formats
           Product: XPath / XQuery / XSLT
           Version: Member-only Editors Drafts
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: minor
          Priority: P2
         Component: XPath 2.1
        AssignedTo: jonathan.robie@redhat.com
        ReportedBy: jmdyck@ibiblio.org
         QAContact: public-qt-comments@w3.org


[Affects XQuery11 too.]

2.1.1 Static Context
Statically known decimal formats.

[1]
The spec is inconsistent on "decimal format" vs "decimal-format".
(Also true for F+O spec.)

[2]
"This is the set of known decimal formats."
    It would be more consistent to say that it's
        a set of (EQName, decimal format) pairs
    or
        a mapping from EQNames to decimal formats

[3]
"Each format is used for serializing decimal numbers using
fn:format-number()."

    [3a] Change "is" to "can be" (because the declaration of a format
    is not a guarantee that it will be used).

    [3b] Change "decimal numbers" to just "numbers" (because fn:format-number
    "can be used to format any numeric quantity", not just xs:decimals).

[4]
"Each format is identified by a QName, except for the default format,
which has no visible name."
    It would be more consistent to have a separate
    'default decimal format' component.

[5]
"Each format contains the properties described in the following
paragraphs."
    I think it would make more sense for the description of the
    properties to be in section 4.10 Decimal-Format Declaration.

[6]
"The following attributes control the interpretation of characters in the
picture string supplied to the format-number function."
    [6a] Change "attributes" to "properties".
    [6b] Change "format-number" to "<code>fn:format-number</code>".

[7]
"The following attributes specify characters or strings that may appear
in the result of formatting the number:"
    Change "attributes" to "properties" again.

-- 
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 Friday, 1 October 2010 07:51:34 UTC