git: 1c01d878eb - main - Update Portscout documentation

[Mateusz Piotrowski]

The branch main has been updated by 0mp:

URL: https://cgit.FreeBSD.org/doc/commit/?id=1c01d878eb36e103f7910d7fa53bf5d8dba91308

commit 1c01d878eb36e103f7910d7fa53bf5d8dba91308
Author:     Mateusz Piotrowski <0mp at FreeBSD.org>
AuthorDate: 2021-04-15 21:48:53 +0000
Commit:     Mateusz Piotrowski <0mp at FreeBSD.org>
CommitDate: 2021-04-15 21:48:53 +0000

    Update Portscout documentation
    
    - Fix the description of the ignore Portscout key. The ignore key is not
      meant to take a list of versions to skip as a value. This is the role
      of the skipv Portscout key.
    - Document the skipv Portscout key.
    - Indicate that more documentation is available in the Portscout repository.
---
 .../content/en/books/porters-handbook/keeping-up/_index.adoc  |  2 ++
 .../content/en/books/porters-handbook/makefiles/_index.adoc   | 11 +++++++++--
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/documentation/content/en/books/porters-handbook/keeping-up/_index.adoc b/documentation/content/en/books/porters-handbook/keeping-up/_index.adoc
index ea01a72767..b92aa1bac5 100644
--- a/documentation/content/en/books/porters-handbook/keeping-up/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/keeping-up/_index.adoc
@@ -70,6 +70,8 @@ Upon clicking on a maintainer's email address, a list of all of their ports is d
 
 Clicking on a port name in the list displays the http://freshports.org[FreshPorts] port information.
 
+Additional documentation is available in the https://github.com/freebsd/portscout[Portscout repository].
+
 [[portsmon]]
 == The FreeBSD Ports Monitoring System
 
diff --git a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
index 2859252fd2..2d12903488 100644
--- a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
@@ -3079,11 +3079,18 @@ Portscout is an automated distfile check utility for the FreeBSD Ports Collectio
 
 Situations where `PORTSCOUT` is set include:
 
-* When distfiles have to be ignored, whether for specific versions, or specific minor revisions. For example, to exclude version _8.2_ from distfile version checks because it is known to be broken, add:
+* When distfiles have to be ignored for specific versions. For example, to exclude version _8.2_ and version _8.3_ from distfile version checks because they are known to be broken, add:
 +
 [.programlisting]
 ....
-PORTSCOUT=	ignore:8.2
+PORTSCOUT=	skipv:8.2,8.3
+....
+
+* When distfile version checks have to be disabled completely. For example, if a port is not going to be updated ever again, add:
++
+[.programlisting]
+....
+PORTSCOUT=	ignore:1
 ....
 
 * When specific versions or specific major and minor revisions of a distfile must be checked. For example, if only version _0.6.4_ must be monitored because newer versions have compatibility issues with FreeBSD, add: