From owner-dev-commits-doc-all@freebsd.org Thu Apr 15 21:53:18 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 52AB45D9D1D for ; Thu, 15 Apr 2021 21:53:18 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FLtPp1tr2z4vTQ; Thu, 15 Apr 2021 21:53:18 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 2940519383; Thu, 15 Apr 2021 21:53:18 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 13FLrIKi043829; Thu, 15 Apr 2021 21:53:18 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13FLrIXB043828; Thu, 15 Apr 2021 21:53:18 GMT (envelope-from git) Date: Thu, 15 Apr 2021 21:53:18 GMT Message-Id: <202104152153.13FLrIXB043828@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 1c01d878eb - main - Update Portscout documentation MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 1c01d878eb36e103f7910d7fa53bf5d8dba91308 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 15 Apr 2021 21:53:18 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=1c01d878eb36e103f7910d7fa53bf5d8dba91308 commit 1c01d878eb36e103f7910d7fa53bf5d8dba91308 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-15 21:48:53 +0000 Commit: Mateusz Piotrowski <0mp@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: