1 files changed, 82 insertions, 0 deletions

diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml
index 1f7588eb52..27f2c1ce9b 100644
--- a/en_US.ISO8859-1/books/porters-handbook/book.sgml
+++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml
@@ -6072,6 +6072,88 @@ USE_SDL+=   mixer
 
     </sect1>
 
+    <sect1 id="using-wx">
+      <title>Using wxWidgets</title>
+
+      <para>If your port uses <application>wxWidgets</application>
+	cross-platform toolkit, define <literal>USE_WX=yes</literal>.
+	A specific version can be requested by setting
+	<literal>USE_WX=2.6</literal>.  Ranges (<literal>2.4-2.6</literal>)
+	and partial ranges (<literal>-2.4</literal>, <literal>2.6+</literal>)
+	are also possible.</para>
+
+      <para>List of required wxWidgets components can be set as
+	<makevar>WX_COMPS</makevar>.  Unless specified otherwise, port will
+	depend on wxWidgets library (<literal>wx</literal>).  Available
+	components are:</para>
+
+      <table frame="none">
+	<title>Possible values for <makevar>WX_COMPS</makevar></title>
+
+	<tgroup cols="2">
+	  <thead>
+	    <row>
+	      <entry>Value</entry>
+
+	      <entry>Means</entry>
+	    </row>
+	  </thead>
+
+	  <tbody>
+	    <row>
+	      <entry><literal>wx</literal></entry>
+
+	      <entry>wxWidget libraries</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>contrib</literal></entry>
+
+	      <entry>wxWidget contributed libraries</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>python</literal></entry>
+
+	      <entry>wxPython</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>mozilla</literal></entry>
+
+	      <entry>wxMozilla (only available for 2.4)</entry>
+	    </row>
+
+	    <row>
+	      <entry><literal>svg</literal></entry>
+
+	      <entry>wxSVG (only available for 2.6)</entry>
+	    </row>
+	  </tbody>
+	</tgroup>
+      </table>
+
+      <para>If locating wxWidget libraries needs a configure argument in
+	addition to the <makevar>WX_CONFIG</makevar> variable, define
+	<makevar>WX_CONF_ARGS</makevar> in your port.  Possible values
+	are <literal>absolute</literal> resulting in
+	<literal>--with-wx-config=${WX_CONFIG}</literal>, and
+	<literal>relative</literal> resulting in
+	<literal>--with-wx=${X11BASE}</literal> being added to configure
+	script arguments.</para>
+
+      <para>Define <literal>WX_UNICODE=yes</literal> if your port needs
+	the Unicode version of the wxWidgets libraries.</para>
+
+      <para>Example of port requiring Unicode versions of wxWidgets 2.6 and
+	contrib libraries:</para>
+
+      <programlisting>USE_WX=      2.6
+WX_COMPS=    wx contrib
+WX_UNICODE=  yes</programlisting>
+
+    </sect1>
+
     <sect1 id="rc-scripts">
       <title>Starting and stopping services (rc scripts)</title>