[Bug 28693] Editorial: consistency in names relating to formatting decimals

https://www.w3.org/Bugs/Public/show_bug.cgi?id=28693

--- Comment #3 from Michael Kay <mike@saxonica.com> ---

(A)

First, the description of the static context (XQuery/XPath 2.1.1). I propose:

(A1) we align the names of the properties with the keywords used in XQuery and
XSLT. The only change is digit-sign -> digit.

(A2) we call them properties, not attributes (currently both names are used).

(A3) we avoid the use of alternative terms within the definition, and instead
explain the usage of the property in plain English. So for example

[Definition: decimal-separator specifies the character used for the
decimal-separator-symbol; the default value is the period character (.)]

becomes

[Definition: decimal-separator specifies the character used to separate the
integer part of the number from the fractional part; the default value is the
period character (.)]

(B)

In XQuery 4.10, in the definition of "decimal format declaration", change the
sentence "The mapping between these properties and the equivalent
fn:format-number() properties is discussed in *statically known decimal
formats*, which also specifies the defaults for each value." to read "If the
form "decimal-format EQName" is used, then the declaration defines the
properties of the decimal format whose name is EQName; while the form "default
decimal-format" defines the properties of the decimal format with no visible
name. The declaration contains a set of (DFPropertyName, StringLiteral) pairs,
where the DFPropertyName is the name of the property and the StringLiteral is
its value. The valid values and default values for each property are defined in
*statically known decimal formats*."

(C) In XSLT 5.5

[C1] change the paragraph:

The attributes of the xsl:decimal-format declaration define the value of the
corresponding attribute in the relevant decimal format in the Statically known
decimal formatsXP30 component of the static context for all XPath expressions
in the package. The attribute names used in the XSLT 3.0 syntax are the same as
the attribute names used in the definition of the static context, except that
the digit attribute of xsl:decimal-format corresponds to the digit-sign
attribute in the static context.

to read:

The attributes of the xsl:decimal-format declaration define the value of the
corresponding property in the relevant decimal format in the Statically known
decimal formatsXP30 component of the static context for all XPath expressions
in the package. The attribute names used in the XSLT 3.0 syntax are the same as
the property names used in the definition of the static context.

[C2] Change other instances of "attribute" to "property" where appropriate.

[D] F+O

[D1] In the table in F+O 4.7.1, align the property names and descriptions with
the names and descriptions used in the definition of the static context.

[D2] Replace all uses of the old F+O names with the static context property
names, for example decimal-separator-sign becomes decimal-separator. Link these
terms to their definitions in the XPath specification (replacing use of
italics), and qualify them as "the X property" or "the value of the X property"
where necessary for clarity, e.g.

In 4,7,3, "A picture-string consists either of a sub-picture, or of two
sub-pictures separated by a pattern-separator-sign." becomes "A picture-string
consists either of a sub-picture, or of two sub-pictures separated by the
character that is the value of the *pattern-separator* property." 

In 4.7.5, "If the input number is positive or negative infinity, the result is
the concatenation of the appropriate prefix, the infinity-symbol, and the
appropriate suffix." becomes "If the input number is positive or negative
infinity, the result is the concatenation of the appropriate prefix, the value
of the *infinity* property, and the appropriate suffix."

-- 
You are receiving this mail because:
You are the QA Contact for the bug.

Received on Tuesday, 2 June 2015 11:45:48 UTC