commit:     d08d5f0dea3d8580c55a052d6424863d6aeb8ae9
Author:     Joonas Niilola <juippis <AT> gentoo <DOT> org>
AuthorDate: Sat Apr 23 12:32:51 2022 +0000
Commit:     Joonas Niilola <juippis <AT> gentoo <DOT> org>
CommitDate: Sun May 22 06:36:57 2022 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=d08d5f0d

general-concepts/dependencies: add new section for indirect deps

Signed-off-by: Joonas Niilola <juippis <AT> gentoo.org>

 general-concepts/dependencies/text.xml | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/general-concepts/dependencies/text.xml 
b/general-concepts/dependencies/text.xml
index ef27ac2..ab1a799 100644
--- a/general-concepts/dependencies/text.xml
+++ b/general-concepts/dependencies/text.xml
@@ -781,6 +781,23 @@ There are three kinds of circular dependencies:
   </li>
 </ol>
 
+</body>
+</section>
+
+<section>
+<title>Indirect dependencies</title>
+<body>
+
+<p>
+Always list each direct dependency that your package needs to build and run
+correctly. Do not rely on dependency chains to meet the dependency
+requirements. For example, a package needs <c>dep1</c> and <c>dep2</c>, but
+<c>dep1</c> also depends on <c>dep2</c>. You might consider just adding
+<c>dep1</c> since it currently pulls <c>dep2</c> too, but in the future,
+<c>dep1</c> might drop <c>dep2</c> as a dependency, or make it conditional with
+USE flags. This would then break building your ebuild.
+</p> 
+
 </body>
 </section>
 </chapter>

Reply via email to