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

[Niclas Zeising]

Author: zeising
Date: Thu Jul 26 11:31:15 2012
New Revision: 39267
URL: http://svn.freebsd.org/changeset/doc/39267

Log:
  Update the porters handbook with information about the new USE_PKGCONFIG
  Makefile macro.
  
  Submitted by:	bapt (via IRC) (small fixes from me and joel)
  Approved by:	joel (mentor)

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/book.sgml

Modified: head/en_US.ISO8859-1/books/porters-handbook/book.sgml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/book.sgml	Wed Jul 25 19:16:39 2012	(r39266)
+++ head/en_US.ISO8859-1/books/porters-handbook/book.sgml	Thu Jul 26 11:31:15 2012	(r39267)
@@ -5492,6 +5492,45 @@ IGNORE=	may not be redistributed because
       </sect2>
     </sect1>
 
+    <sect1 id="using-pkg-config">
+      <title>Using <literal>pkg-config</literal></title>
+
+      <para>If your ports requires <literal>pkg-config</literal>,
+	just set <makevar>USE_PKGCONFIG</makevar> to the following
+	possible values:</para>
+      <table frame="none">
+	<title>Values for <makevar>USE_PKGCONFIG</makevar></title>
+
+	<tgroup cols="2">
+	  <thead>
+	    <row>
+	      <entry>Definition</entry>
+	      <entry>Description</entry>
+	    </row>
+	  </thead>
+
+	  <tbody>
+	    <row>
+	      <entry><makevar>USE_PKGCONFIG= yes</makevar></entry>
+	      <entry>The ports uses pkg-config only at build time</entry>
+	    </row>
+	    <row>
+	      <entry><makevar>USE_PKGCONFIG= build</makevar></entry>
+	      <entry>The ports uses pkg-config only at build time</entry>
+	    </row>
+	    <row>
+	      <entry><makevar>USE_PKGCONFIG= run</makevar></entry>
+	      <entry>The ports uses pkg-config only at run time</entry>
+	    </row>
+	    <row>
+	      <entry><makevar>USE_PKGCONFIG= both</makevar></entry>
+	      <entry>The ports uses pkg-config both at build and run time</entry>
+	    </row>
+	  </tbody>
+	</tgroup>
+      </table>
+    </sect1>
+
     <sect1 id="using-gettext">
       <title>Using GNU <literal>gettext</literal></title>