From fcff74d3b7bc1a5f0fb1bcd92cf8c820d2104950 Mon Sep 17 00:00:00 2001
From: Niclas Zeising <zeising@FreeBSD.org>
Date: Thu, 26 Jul 2012 11:31:15 +0000
Subject: [PATCH] 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)
---
 .../books/porters-handbook/book.sgml          | 39 +++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml
index 5c658b5966..424906eb1c 100644
--- a/en_US.ISO8859-1/books/porters-handbook/book.sgml
+++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml
@@ -5492,6 +5492,45 @@ IGNORE=	may not be redistributed because of licensing reasons. Please visit <rep
       </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>