[Bug 28215] [XSLT30] EBNF for versions incomplete for VersionTo production and ambiguous explanation for VersionPrefix

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

--- Comment #1 from Abel Braaksma <abel.braaksma@xs4all.nl> ---
(Editorial)
In addition, I think it would help if we add some more examples, esp. where it
concerns NamePart, as that may cause confusion (as we found while discussing
it). Here are some suggestions we thought of (the bullet points as they are now
are quoted):

<quote>
The range VersionRanges matches a version if any constituent VersionRange
matches that version.
<quote>

<suggestion>
[...]. For example: "2.3" matches only 2.3, "2.3, 2.4 to 3.3.*" matches 2.3,
2.4.5, 3.2, 3.3.4 but not 3.4, "1.2, 1.4, 1.6" only matches those specific
versions, "1.1-alpha, 1.2.*" matches 1.1-alpha exactly, 1.2, 1.2.5, 1.2-beta
but not 1.1 or 1.3.
</suggestion>

<quote>
The range VersionPrefix matches any version whose leading components are the
same as the components listed. For example, 1.3.* matches 1.3,  1.3.5, 
1.3.10.2,  and 1.3-beta.
</quote>

<suggestion>
[...] but not 1 or 1.4. And 3.5-beta.* matches only the exact version 3.5-beta,
not 3.5-beta.1 or 3.5-beta-build3.
</suggestion>

<quote>
The range VersionFrom matches any version that is greater than or equal to the
version supplied. For example 1.3+ matches 1.3,  1.3.2,  1.4,  or 2.1.
</quote>

<suggestion>
[...] but not 1.3-alpha or 1.2. And 1.3-alpha+ matches 1.3.beta, 1.3.0, 1.4,
5.2, but not 1.3-alph or 1.3-a2.
</suggestion>

<quote>
The range VersionTo matches any version that is less than or equal to some
version that matches the VersionPrefix. For example, to 4.0 matches 1.5,  2.3, 
3.8,  4.0,  and 4.0-beta (but not 4.0.1), while to 3.3.* matches 1.5 or 2.0.6
or 3.3.4621, but not 3.4.0 or 3.4.0-beta.
</quote>

Nothing to add, I don't see ambiguities.

<quote>
The range VersionFromTo matches any version that is greater than or equal to
the starting PackageVersion, and less than or equal to some version that
matches the VersionPrefix. For example, 1 to 5 matches 1.1,  2.1,  3.1,  or 5.0
(but not 5.1), while 1 to 5.* matches all of these, plus versions such as 5.7.2
(but not 6.0 or 6.0-beta).
</quote>

<suggestion>
[...] And 1.0-beta to 1.0 matches 1.0-beta, 1.0-beta.build1, 1.0, 1.0-gamma but
not 1.0.1, 1.0-alpha or 1.0-b.
</suggestion>

(I hope I understood the rules correctly when writing these examples. If they
don't end up in the spec, they can perhaps be used in test cases)

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

Received on Saturday, 14 March 2015 17:56:10 UTC