ericLemanissier/conan-center-index
1
0
Fork 1
mirror of https://github.com/conan-io/conan-center-index.git synced 2025-08-13 01:50:42 +00:00
Code Issues 6 Packages Projects Releases Wiki Activity

(#24723) [docs] Add zstd and ninja to version ranges supported

Browse Source 
* Add zstd and ninja to version ranges

Signed-off-by: Uilian Ries <uilianries@gmail.com>

* Include Meson

* Update docs/adding_packages/dependencies.md

* Update dependencies.md

---------

Signed-off-by: Uilian Ries <uilianries@gmail.com>
Co-authored-by: Luis Caro Campos <3535649+jcar87@users.noreply.github.com>
This commit is contained in:
Uilian Ries
2024-07-30 11:42:41 +01:00
committed by GitHub
parent ae489b3b79
commit 4c3aba03b4
1 changed files with 16 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
docs/adding_packages/dependencies.md
View File

@@ -178,7 +178,11 @@ for consumer, we do impose some limits on Conan features to provide a smoother f
Version ranges are a useful Conan feature, [documentation here](https://docs.conan.io/2/tutorial/versioning/version_ranges.html).
With the introduction of Conan 2.0, we are currently working to allow the use of version ranges and are allowing this for a handful of dependencies.
Currently, these are (except if the recipe needs a newer lower/upper version bound for specific reasons):
Version ranges are being progressively introduced by Conan team maintainers and are being rolled out in phases, and we do not intend
to do it all at once.
Version ranges for the following dependencies will be accepted in pull requests:
* OpenSSL: `[>=1.1 <4]` for libraries known to be compatible with OpenSSL 1.x and 3.x
* CMake: `[>3.XX <4]`, where `3.XX` is the minimum version of CMake required by the relevant build scripts. Note that CCI recipes assume 3.15 is installed in the system, so add this
@@ -192,6 +196,10 @@ version range only when a requirement for a newer version is needed.
* qt5: `[~5.15]`, if your library depends on qt5, only the 5.15 minor version is allowed
* qt6: `[>=6.x <7]`, where 6.x is the lower bound of your needed qt6 version
* c-ares: `[>=1.27 <2]`
* zstd: `[^1.5]` it's equivalent to `[>=1.5 <1.6]`
* ninja: `[>=1.10.2 <2]`
* meson: `[>=1.2.3 <2]`
* pkgconf: `[>=2.2 <3]`
> **Warning**: With Conan 1.x, [version ranges](https://docs.conan.io/1/versioning/version_ranges.html) adhere to a much more strict sematic version spec,
> OpenSSL 1.1.x does not follow this so the client will not resolve to that range and will pick a 3.x version. In order to select a lower version you
@@ -202,11 +210,14 @@ Conan maintainers may introduce this for other dependencies over time. Outside o
#### Adding Version Ranges
You might also see version ranges in some PR by CCI maintainers.
You might also see version ranges being added in pull requests by Conan maintainers, that
are not in the list above. These are being introduced on a case-by-case basis, and are being rolled out
in phases to ensure that they do not cause problems to users. Note that version ranges can
only be used for libraries and tools that have strong compatibility guarantees - and may not
be suitable in all cases.
These are being done on a case-by-case basis, and are being rolled out in phases to ensure
that they do not cause problems to users. Please do not open PRs that exclusively add version ranges to dependencies,
unless they are solving current conflicts, in which case we welcome them and they will be prioritized.
Please do not open PRs that exclusively add version ranges to dependencies, unless they are solving
current conflicts, in which case we welcome them and they will be prioritized.
## Handling "internal" dependencies