Date: Thu, 15 Apr 2021 21:53:18 GMT From: Mateusz Piotrowski <0mp@FreeBSD.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Subject: git: 1c01d878eb - main - Update Portscout documentation Message-ID: <202104152153.13FLrIXB043828@gitrepo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202104152153.13FLrIXB043828>