diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml index c08a5a1670..0784ff6d39 100644 --- a/en_US.ISO8859-1/books/porters-handbook/book.sgml +++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml @@ -3449,6 +3449,56 @@ ALWAYS_KEEP_DISTFILES= yes <filename>Makefile</filename>.</para> </sect1> + <sect1 id="makefile-portscout"> + <title><makevar>PORTSCOUT</makevar></title> + + <para><application>Portscout</application> is an automated + distfile check utility for the &os; Ports Collection, + described in detail in + <xref linkend="distfile-survey">.</para> + + <para>The <makevar>PORTSCOUT</makevar> variable defines + special conditions within which the + <application>Portscout</application> distfile + scanner should be restricted.</para> + + <para>Situations where the <makevar>PORTSCOUT</makevar> + variable should be set include:</para> + + <itemizedlist> + <listitem> + <para>When distfiles should be ignored, whether for + specific versions, or specific minor revisions. For + example, to exclude version + <replaceable>8.2</replaceable> from distfile version + checks because it is known to be broken, add:</para> + + <programlisting>PORTSCOUT= ignore:8.2</programlisting> + + </listitem> + <listitem> + <para>When specific versions or specific major and minor + revisions of a distfile should be checked. For + example, if only version + <replaceable>0.6.4</replaceable> should be monitored + because newer versions have compatablity issues with + &os;, add:</para> + + <programlisting>PORTSCOUT= limit:^0\.6\.4</programlisting> + + </listitem> + <listitem> + <para>When URLs listing the available versions differ + from the download URLs. For example, to limit + distfile version checks to the download page for the + <filename role="package">databases/pgtune</filename> + port, add:</para> + + <programlisting>PORTSCOUT= site:http://pgfoundry.org/frs/?group_id=1000416</programlisting> + </listitem> + </itemizedlist> + </sect1> + <sect1 id="makefile-depend"> <title>Dependencies</title>