diff options
author | 2020-01-19 14:53:05 +0100 | |
---|---|---|
committer | 2020-01-19 21:10:03 +0100 | |
commit | 7becf8322c2e53b484faa5565df3c3fcde2be85d (patch) | |
tree | 720e4fd3832b6e148f1e3cfc44753d160065f89f | |
parent | filesystem: Policy against absolute symlink targets (diff) | |
download | policy-guide-7becf8322c2e53b484faa5565df3c3fcde2be85d.tar.gz policy-guide-7becf8322c2e53b484faa5565df3c3fcde2be85d.tar.bz2 policy-guide-7becf8322c2e53b484faa5565df3c3fcde2be85d.zip |
dependencies: =-deps with no revision
Closes: https://bugs.gentoo.org/705842
Closes: https://github.com/gentoo/policy-guide/pull/6
Signed-off-by: Michał Górny <mgorny@gentoo.org>
-rw-r--r-- | dependencies.rst | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/dependencies.rst b/dependencies.rst index ff6756f..51038be 100644 --- a/dependencies.rst +++ b/dependencies.rst @@ -30,6 +30,34 @@ This is especially important for packages that take long time to build. by the Council but no reference implementation has been written. +.. index:: dependency; = with no revision + +=-dependencies with no revision +------------------------------- +:Source: QA +:Reported: by repoman and pkgcheck + +Whenever a non-wildcard ``=`` (equals) dependency is used on a package, +the requested revision must be specified explicitly. When the zeroth +revision is requested, ``-r0`` must be used. When no specific revision +is necessary, the ``~`` (tilde) operator must be used instead. + +*Example*:: + + # BAD: + =dev-libs/libfrobnicate-1.2.3 + # GOOD: + =dev-libs/libfrobnicate-1.2.3-r0 + =dev-libs/libfrobnicate-1.2.3-r3 + ~dev-libs/libfrobnicate-1.2.3 + +*Rationale*: using ``=`` operator in place of ``~`` to mean a specific +version has been a common mistake. This policy uses the fact that +no revision and explicit ``-r0`` are equivalent. By explicitly +requesting the latter, it warns developers to reconsider whether they +used the correct operator. + + .. index:: pair: slot/subslot; dependency |