diff options
authorMichał Górny <>2020-01-08 09:47:43 +0100
committerMichał Górny <>2020-01-08 10:41:06 +0100
commit0be5e7a4005354e985f7659f328f1aa7855add1a (patch)
parentInitial version (diff)
Optional RDEPEND policy
Signed-off-by: Michał Górny <>
1 files changed, 33 insertions, 0 deletions
diff --git a/dependencies.rst b/dependencies.rst
new file mode 100644
index 0000000..2b63f7f
--- /dev/null
+++ b/dependencies.rst
@@ -0,0 +1,33 @@
+.. index:: RDEPEND; optional
+.. index:: USE flags; for optional RDEPEND
+Optional runtime dependencies
+:Source: QA
+:Reported: no
+Using USE flags to control optional runtime dependencies is not
+acceptable except under very specific circumstances, such as a package
+being nonfunctional unless at least one of a set of optional runtime
+dependencies is installed.
+There is no specific preference as to how user should be informed
+of optional runtime dependencies. The two possible options include
+using ``elog`` messages and ``readme.gentoo-r1`` eclass.
+*Rationale*: toggling USE flags in order to enable or disable optional
+runtime dependencies causes needless rebuilds of packages in question.
+This is especially important for packages that take long time to build.
+.. Note::
+ `GLEP 62`_ proposes a solution permitting flipping USE flags without
+ rebuilding package in question. It has been tentatively approved
+ by the Council but no reference implementation has been written.
+.. _GLEP 62: