This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 10948 - [XPath30] editorial: 2.1.1 Static Context: statically known decimal formats
Summary: [XPath30] editorial: 2.1.1 Static Context: statically known decimal formats
Status: RESOLVED FIXED
Alias: None
Product: XPath / XQuery / XSLT
Classification: Unclassified
Component: XPath 3.0 (show other bugs)
Version: Member-only Editors Drafts
Hardware: All All
: P2 minor
Target Milestone: ---
Assignee: Jonathan Robie
QA Contact: Mailing list for public feedback on specs from XSL and XML Query WGs
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2010-10-01 07:51 UTC by Michael Dyck
Modified: 2011-09-06 17:20 UTC (History)
1 user (show)

See Also:


Attachments

Description Michael Dyck 2010-10-01 07:51:31 UTC
[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.
Comment 1 Michael Dyck 2010-10-01 08:00:29 UTC
Re [5]: Oops, XPath doesn't have a section 4.10. (I originally wrote the comment for XQuery.) So on second thought, drop the description of properties, and just refer the reader to F+O section 4.6.1.
Comment 2 Jonathan Robie 2011-04-27 19:21:28 UTC
This requires some discussion.

See
http://lists.w3.org/Archives/Member/w3c-xsl-query/2011Apr/0167.html
Comment 3 Jonathan Robie 2011-09-06 17:20:25 UTC
I have now checked in changes proposed in http://lists.w3.org/Archives/Member/w3c-xsl-query/2011Apr/0176.html.

The other changes had already been made. I am marking this bug Resolved/Fixed.