conan-io / conan-io/docs

[bug] Documentation issues with example for version ranges

Open
#4,176 5 comments 0 reactions 1 assignee Claimed by @AbrilRBS View on GitHub
Dominant language
C++
Stars
125
Forks
382
Avg merge
22h 39m
Merged PRs (30d)
21

Description

### Describe the bug

Hey,
at the bottom of https://docs.conan.io/2/tutorial/versioning/version_ranges.html it seems to say that 1.0-pre.1 will be included in the range `[>1 <2, include_prerelease]`, but I tried it and it isn't.
Maybe it's meant to say `>=1`?

I also got quite confused by the upper bound where it says 2.0-pre1 is outside `<2`, which it is.
But a bit further up it says
> A pre-release happens earlier in time than the release it is qualifying. So 1.1-alpha.1 is older than 1.1, not newer.

So logically, 2.0-pre1 should be _included_, because it's older=less than 2.

The real rule appears to be that pre-release qualifiers on packages are ignored in ranges comparisons.
As in "1.0-pre.1 is included with >=1 because for purposes of comparison it's 1.0, and not something less than 1.0".

Maybe the documentation can be made a bit clearer in that regard to avoid confusion for others.
Thanks!

### How to reproduce it

_No response_

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.