<description>The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> greater than or equal to its specified <seecref="T:Hive.Versioning.Version"/>.</description>
<description>
The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> greater than or equal to its specified<seecref="T:Hive.Versioning.Version"/>.
</description>
</item>
</item>
<item>
<item>
<term><c><=</c></term>
<term><c><=</c></term>
<description>The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> less than or equal to its specified <seecref="T:Hive.Versioning.Version"/>.</description>
<description>
The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> less than or equal to its specified <seecref="T:Hive.Versioning.Version"/>.
</description>
</item>
</item>
<item>
<item>
<term><c>></c></term>
<term><c>></c></term>
<description>The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> greater than its specified <seecref="T:Hive.Versioning.Version"/>.</description>
<description>
The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> greater than its specified <seecref="T:Hive.Versioning.Version"/>.
</description>
</item>
</item>
<item>
<item>
<term><c><</c></term>
<term><c><</c></term>
<description>The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> less than its specified <seecref="T:Hive.Versioning.Version"/>.</description>
<description>
The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> less than its specified <seecref="T:Hive.Versioning.Version"/>.
</description>
</item>
</item>
<item>
<item>
<term><c>=</c></term>
<term><c>=</c></term>
<description>The range matches only the <seecref="T:Hive.Versioning.Version"/> that it is specified with.</description>
<description>
The range matches only the <seecref="T:Hive.Versioning.Version"/> that it is specified with.
</description>
</item>
</item>
</list><para>Note that unbounded ranges using the <c>=</c> comparison operator cannot be part of a bounded region.</para><para>Additionally, there are the following shorthand comparison operators that expand to bounded regions:</para><listtype="table">
</list><para>Note that unbounded ranges using the <c>=</c> comparison operator cannot be part of a bounded region.</para><para>Additionally, there are the following shorthand comparison operators that expand to bounded regions:</para><listtype="table">
<item>
<item>
@ -577,15 +587,38 @@
to <c>>=0.4.2 <0.5.0</c>.
to <c>>=0.4.2 <0.5.0</c>.
</description>
</description>
</item>
</item>
</list><para>There are also a few special ranges:</para><listtype="table">
<item>
<term><c>*</c></term>
<description>
The <seecref="P:Hive.Versioning.VersionRange.Everything"/> range. This range matches every possible version.
</description>
</item>
<item>
<term><c>z</c> or <c>Z</c></term>
<description>
The <seecref="P:Hive.Versioning.VersionRange.Nothing"/> range. This range matches nothing.
</description>
</item>
</list><para>
</list><para>
A bounded region may also be specified using star syntax. This takes the form of either a single <c>*</c> alone, matching any version,
A bounded region may also be specified using star syntax. This takes the form of either a single <c>*</c> alone, matching any version,
or a version with some numbers substituted with an asterisk. Once an element has been substituted, however, any following elements must
or a version with some numbers substituted with an asterisk. Once an element has been substituted, however, any following elements must
either not be present or be a star themselves. Prereleases and build ids cannot be specified when using star syntax. For example,
either not be present or be a star themselves. Prereleases and build ids cannot be specified when using star syntax. For example,
<c>*</c> is valid, <c>*.3</c> is not. <c>1.*</c> and <c>1.*.*</c> are valid (and equivalent), but <c>1.*.2</c> is not. <c>1.2.*</c> is
<c>*</c> is valid, <c>*.3</c> is not. <c>1.*</c> and <c>1.*.*</c> are valid (and equivalent), but <c>1.*.2</c> is not. <c>1.2.*</c> is
valid, but <c>1.2.*-pre.1</c> is not. Importantly, <c>*.*.*</c> or anything similar is also not valid. Just use <c>*</c>.
valid, but <c>1.2.*-pre.1</c> is not. Importantly, <c>*.*.*</c> or anything similar is also not valid. Just use <c>*</c>. In all cases
except the singular <c>*</c>, any <c>*</c> may also be an <c>x</c> or <c>X</c>.
</para><para>
A bounded regioon may also be specified using hyphen syntax, though it is generally not recommended, as it is not always clear to a reader
what exactly is meant, and is remarkably easy to mess up. The syntax for this is <c>1.2.3 - 4.5.6</c>, of course substituting <c>1.2.3</c>
and <c>4.5.6</c> with any valid version. The space before is <b>required</b>. This is important. the space <i>after the first version,
before the hyphen, is</i><b>required</b>. This is because <c>1.2.3-4.5.6</c> is a valid, and <i>complete</i>, version, causing the parser
to try to read the first version in the hyphen range, then hit the end of input instead of a hyphen and back out, eventually rejecting the
range altogether, because <b>a version by itself is not a valid version range</b>. <c>1.2.3- 4.5.6</c> is also not valid, because it
is an <i>incomplete</i> version followed by a complete, simple version. Since incomplete versions are rejected, it means that this attempts
to parse a first version, fails, and tries other forms a range can take before eventually failing out.
<exceptioncref="T:System.ArgumentException">Thrown when <paramrefname="text"/> is not a valid <seecref="T:Hive.Versioning.VersionRange"/>.</exception>
<exceptioncref="T:System.ArgumentException">Thrown when <paramrefname="text"/> is not a valid <seecref="T:Hive.Versioning.VersionRange"/>.</exception>
@ -604,23 +637,33 @@
</para><listtype="table">
</para><listtype="table">
<item>
<item>
<term><c>>=</c></term>
<term><c>>=</c></term>
<description>The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> greater than or equal to its specified <seecref="T:Hive.Versioning.Version"/>.</description>
<description>
The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> greater than or equal to its specified<seecref="T:Hive.Versioning.Version"/>.
</description>
</item>
</item>
<item>
<item>
<term><c><=</c></term>
<term><c><=</c></term>
<description>The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> less than or equal to its specified <seecref="T:Hive.Versioning.Version"/>.</description>
<description>
The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> less than or equal to its specified <seecref="T:Hive.Versioning.Version"/>.
</description>
</item>
</item>
<item>
<item>
<term><c>></c></term>
<term><c>></c></term>
<description>The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> greater than its specified <seecref="T:Hive.Versioning.Version"/>.</description>
<description>
The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> greater than its specified <seecref="T:Hive.Versioning.Version"/>.
</description>
</item>
</item>
<item>
<item>
<term><c><</c></term>
<term><c><</c></term>
<description>The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> less than its specified <seecref="T:Hive.Versioning.Version"/>.</description>
<description>
The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> less than its specified <seecref="T:Hive.Versioning.Version"/>.
</description>
</item>
</item>
<item>
<item>
<term><c>=</c></term>
<term><c>=</c></term>
<description>The range matches only the <seecref="T:Hive.Versioning.Version"/> that it is specified with.</description>
<description>
The range matches only the <seecref="T:Hive.Versioning.Version"/> that it is specified with.
</description>
</item>
</item>
</list><para>Note that unbounded ranges using the <c>=</c> comparison operator cannot be part of a bounded region.</para><para>Additionally, there are the following shorthand comparison operators that expand to bounded regions:</para><listtype="table">
</list><para>Note that unbounded ranges using the <c>=</c> comparison operator cannot be part of a bounded region.</para><para>Additionally, there are the following shorthand comparison operators that expand to bounded regions:</para><listtype="table">
<item>
<item>
@ -631,12 +674,35 @@
to <c>>=0.4.2 <0.5.0</c>.
to <c>>=0.4.2 <0.5.0</c>.
</description>
</description>
</item>
</item>
</list><para>There are also a few special ranges:</para><listtype="table">
<item>
<term><c>*</c></term>
<description>
The <seecref="P:Hive.Versioning.VersionRange.Everything"/> range. This range matches every possible version.
</description>
</item>
<item>
<term><c>z</c> or <c>Z</c></term>
<description>
The <seecref="P:Hive.Versioning.VersionRange.Nothing"/> range. This range matches nothing.
</description>
</item>
</list><para>
</list><para>
A bounded region may also be specified using star syntax. This takes the form of either a single <c>*</c> alone, matching any version,
A bounded region may also be specified using star syntax. This takes the form of either a single <c>*</c> alone, matching any version,
or a version with some numbers substituted with an asterisk. Once an element has been substituted, however, any following elements must
or a version with some numbers substituted with an asterisk. Once an element has been substituted, however, any following elements must
either not be present or be a star themselves. Prereleases and build ids cannot be specified when using star syntax. For example,
either not be present or be a star themselves. Prereleases and build ids cannot be specified when using star syntax. For example,
<c>*</c> is valid, <c>*.3</c> is not. <c>1.*</c> and <c>1.*.*</c> are valid (and equivalent), but <c>1.*.2</c> is not. <c>1.2.*</c> is
<c>*</c> is valid, <c>*.3</c> is not. <c>1.*</c> and <c>1.*.*</c> are valid (and equivalent), but <c>1.*.2</c> is not. <c>1.2.*</c> is
valid, but <c>1.2.*-pre.1</c> is not. Importantly, <c>*.*.*</c> or anything similar is also not valid. Just use <c>*</c>.
valid, but <c>1.2.*-pre.1</c> is not. Importantly, <c>*.*.*</c> or anything similar is also not valid. Just use <c>*</c>. In all cases
except the singular <c>*</c>, any <c>*</c> may also be an <c>x</c> or <c>X</c>.
</para><para>
A bounded regioon may also be specified using hyphen syntax, though it is generally not recommended, as it is not always clear to a reader
what exactly is meant, and is remarkably easy to mess up. The syntax for this is <c>1.2.3 - 4.5.6</c>, of course substituting <c>1.2.3</c>
and <c>4.5.6</c> with any valid version. The space before is <b>required</b>. This is important. the space <i>after the first version,
before the hyphen, is</i><b>required</b>. This is because <c>1.2.3-4.5.6</c> is a valid, and <i>complete</i>, version, causing the parser
to try to read the first version in the hyphen range, then hit the end of input instead of a hyphen and back out, eventually rejecting the
range altogether, because <b>a version by itself is not a valid version range</b>. <c>1.2.3- 4.5.6</c> is also not valid, because it
is an <i>incomplete</i> version followed by a complete, simple version. Since incomplete versions are rejected, it means that this attempts
to parse a first version, fails, and tries other forms a range can take before eventually failing out.
</para>
</para>
</remarks>
</remarks>
<paramname="text">The string to try to parse.</param>
<paramname="text">The string to try to parse.</param>
@ -660,23 +726,33 @@
</para><listtype="table">
</para><listtype="table">
<item>
<item>
<term><c>>=</c></term>
<term><c>>=</c></term>
<description>The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> greater than or equal to its specified <seecref="T:Hive.Versioning.Version"/>.</description>
<description>
The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> greater than or equal to its specified<seecref="T:Hive.Versioning.Version"/>.
</description>
</item>
</item>
<item>
<item>
<term><c><=</c></term>
<term><c><=</c></term>
<description>The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> less than or equal to its specified <seecref="T:Hive.Versioning.Version"/>.</description>
<description>
The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> less than or equal to its specified <seecref="T:Hive.Versioning.Version"/>.
</description>
</item>
</item>
<item>
<item>
<term><c>></c></term>
<term><c>></c></term>
<description>The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> greater than its specified <seecref="T:Hive.Versioning.Version"/>.</description>
<description>
The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> greater than its specified <seecref="T:Hive.Versioning.Version"/>.
</description>
</item>
</item>
<item>
<item>
<term><c><</c></term>
<term><c><</c></term>
<description>The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> less than its specified <seecref="T:Hive.Versioning.Version"/>.</description>
<description>
The unbounded range matches any <seecref="T:Hive.Versioning.Version"/> less than its specified <seecref="T:Hive.Versioning.Version"/>.
</description>
</item>
</item>
<item>
<item>
<term><c>=</c></term>
<term><c>=</c></term>
<description>The range matches only the <seecref="T:Hive.Versioning.Version"/> that it is specified with.</description>
<description>
The range matches only the <seecref="T:Hive.Versioning.Version"/> that it is specified with.
</description>
</item>
</item>
</list><para>Note that unbounded ranges using the <c>=</c> comparison operator cannot be part of a bounded region.</para><para>Additionally, there are the following shorthand comparison operators that expand to bounded regions:</para><listtype="table">
</list><para>Note that unbounded ranges using the <c>=</c> comparison operator cannot be part of a bounded region.</para><para>Additionally, there are the following shorthand comparison operators that expand to bounded regions:</para><listtype="table">
<item>
<item>
@ -687,12 +763,35 @@
to <c>>=0.4.2 <0.5.0</c>.
to <c>>=0.4.2 <0.5.0</c>.
</description>
</description>
</item>
</item>
</list><para>There are also a few special ranges:</para><listtype="table">
<item>
<term><c>*</c></term>
<description>
The <seecref="P:Hive.Versioning.VersionRange.Everything"/> range. This range matches every possible version.
</description>
</item>
<item>
<term><c>z</c> or <c>Z</c></term>
<description>
The <seecref="P:Hive.Versioning.VersionRange.Nothing"/> range. This range matches nothing.
</description>
</item>
</list><para>
</list><para>
A bounded region may also be specified using star syntax. This takes the form of either a single <c>*</c> alone, matching any version,
A bounded region may also be specified using star syntax. This takes the form of either a single <c>*</c> alone, matching any version,
or a version with some numbers substituted with an asterisk. Once an element has been substituted, however, any following elements must
or a version with some numbers substituted with an asterisk. Once an element has been substituted, however, any following elements must
either not be present or be a star themselves. Prereleases and build ids cannot be specified when using star syntax. For example,
either not be present or be a star themselves. Prereleases and build ids cannot be specified when using star syntax. For example,
<c>*</c> is valid, <c>*.3</c> is not. <c>1.*</c> and <c>1.*.*</c> are valid (and equivalent), but <c>1.*.2</c> is not. <c>1.2.*</c> is
<c>*</c> is valid, <c>*.3</c> is not. <c>1.*</c> and <c>1.*.*</c> are valid (and equivalent), but <c>1.*.2</c> is not. <c>1.2.*</c> is
valid, but <c>1.2.*-pre.1</c> is not. Importantly, <c>*.*.*</c> or anything similar is also not valid. Just use <c>*</c>.
valid, but <c>1.2.*-pre.1</c> is not. Importantly, <c>*.*.*</c> or anything similar is also not valid. Just use <c>*</c>. In all cases
except the singular <c>*</c>, any <c>*</c> may also be an <c>x</c> or <c>X</c>.
</para><para>
A bounded regioon may also be specified using hyphen syntax, though it is generally not recommended, as it is not always clear to a reader
what exactly is meant, and is remarkably easy to mess up. The syntax for this is <c>1.2.3 - 4.5.6</c>, of course substituting <c>1.2.3</c>
and <c>4.5.6</c> with any valid version. The space before is <b>required</b>. This is important. the space <i>after the first version,
before the hyphen, is</i><b>required</b>. This is because <c>1.2.3-4.5.6</c> is a valid, and <i>complete</i>, version, causing the parser
to try to read the first version in the hyphen range, then hit the end of input instead of a hyphen and back out, eventually rejecting the
range altogether, because <b>a version by itself is not a valid version range</b>. <c>1.2.3- 4.5.6</c> is also not valid, because it
is an <i>incomplete</i> version followed by a complete, simple version. Since incomplete versions are rejected, it means that this attempts
to parse a first version, fails, and tries other forms a range can take before eventually failing out.
</para>
</para>
</remarks>
</remarks>
<paramname="text">The string to try to parse.</param>
<paramname="text">The string to try to parse.</param>