svn commit: r53454 - head/en_US.ISO8859-1/books/porters-handbook/makefiles

[Mathieu Arnold]

Author: mat
Date: Thu Oct  3 20:50:58 2019
New Revision: 53454
URL: https://svnweb.freebsd.org/changeset/doc/53454

Log:
  Make it clear that a port's dependencies should not be minimal.
  
  Reviewed by:	portmgr
  Differential Revision:	https://reviews.freebsd.org/D21717

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Thu Oct  3 14:53:09 2019	(r53453)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Thu Oct  3 20:50:58 2019	(r53454)
@@ -5469,6 +5469,17 @@ LICENSE_COMB=	multi</programlisting>
       also some pre-supported dependency variables for common cases,
       plus a few more to control the behavior of dependencies.</para>
 
+    <important>
+      <para>When software has extra dependencies that provide extra
+	features, the base dependencies listed in
+	<varname><replaceable>*</replaceable>_DEPENDS</varname> should
+	include the extra dependencies that would benefit most users.
+	The base dependencies should never be a <quote>minimal</quote>
+	dependency set.  The goal is not to include every dependency
+	possible.  Only include those that will benefit most
+	people.</para>
+    </important>
+
     <sect2 xml:id="makefile-lib_depends">
       <title><varname>LIB_DEPENDS</varname></title>