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

[Mateusz Piotrowski]

Author: 0mp
Date: Tue Nov  3 12:39:32 2020
New Revision: 54673
URL: https://svnweb.freebsd.org/changeset/doc/54673

Log:
  Explain why BINARY_ALIASES cannot be used for programs from TEST_DEPENDS
  
  PR:		247637

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	Tue Nov  3 12:16:41 2020	(r54672)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Tue Nov  3 12:39:32 2020	(r54673)
@@ -8233,5 +8233,16 @@ BINARY_ALIAS=	python3=${PYTHON_CMD}</programlisting>
       <para>See <xref linkend="using-python" /> for more information
 	about <literal>USES=python</literal>.</para>
     </example>
+
+    <note>
+      <para>Binary aliases are created after the dependencies
+        provided via <literal>BUILD_DEPENDS</literal> and
+        <literal>LIB_DEPENDS</literal> are processed and before the
+        <buildtarget>configure</buildtarget> target.  This leads
+        to various limitations. For example, programs installed via
+        <literal>TEST_DEPENDS</literal> cannot be used to create
+        a binary alias as test dependencies specified this way
+        are processed after binary aliases are created.</para>
+    </note>
   </sect1>
 </chapter>