Document PORTSCOUT Makefile usage, and provide a few examples.

Reviewed by:	wblock
This commit is contained in:
Glen Barber 2012-08-27 03:44:33 +00:00
parent f2c2ad33b3
commit 7cc48f9a2d
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=39455

View file

@ -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;&nbsp;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>