From owner-svn-doc-all@FreeBSD.ORG Sun Jun 24 13:31:58 2012 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 44123106566B; Sun, 24 Jun 2012 13:31:58 +0000 (UTC) (envelope-from issyl0@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 24AC38FC08; Sun, 24 Jun 2012 13:31:58 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q5ODVwGo012572; Sun, 24 Jun 2012 13:31:58 GMT (envelope-from issyl0@svn.freebsd.org) Received: (from issyl0@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id q5ODVvIU012570; Sun, 24 Jun 2012 13:31:57 GMT (envelope-from issyl0@svn.freebsd.org) Message-Id: <201206241331.q5ODVvIU012570@svn.freebsd.org> From: Isabell Long Date: Sun, 24 Jun 2012 13:31:57 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r39119 - head/en_US.ISO8859-1/books/porters-handbook X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 24 Jun 2012 13:31:58 -0000 Author: issyl0 Date: Sun Jun 24 13:31:57 2012 New Revision: 39119 URL: http://svn.freebsd.org/changeset/doc/39119 Log: Add more information about Portscout to the porter's handbook. Submitted by: issyl0 (as part of Google Code-In 2011) Reviewed by: gjb Approved by: gabor (mentor) Modified: head/en_US.ISO8859-1/books/porters-handbook/book.sgml Modified: head/en_US.ISO8859-1/books/porters-handbook/book.sgml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/book.sgml Sun Jun 24 13:13:54 2012 (r39118) +++ head/en_US.ISO8859-1/books/porters-handbook/book.sgml Sun Jun 24 13:31:57 2012 (r39119) @@ -16214,19 +16214,40 @@ pre-install: - The &os; Ports Distfile Scanner + Portscout: The &os; Ports Distfile Scanner The build cluster is dedicated to building the latest release of each port with distfiles that have already been fetched. However, as the Internet continually changes, - distfiles can quickly go missing. The FreeBSD Ports distfile - scanner attempts to query every download site for - every port to find out if each distfile is still currently - available. Maintainers are asked to check this report - periodically, not only to speed up the building process for - users, but to help avoid wasting bandwidth of the sites that - volunteer to host all these distfiles. + distfiles can quickly go missing. Portscout, the &os; Ports + distfile scanner, attempts to query every download site for + every port to find out if each distfile is still available. + Portscout can generate + HTML reports and send emails about newly + available ports to those who request them. Unless not + otherwise subscribed, maintainers are asked to check + periodically for changes, either by hand or using the + RSS feed. + + Portscout's first page gives + the email address of the port maintainer, the number of ports + the maintainer is responsible for, the number of those ports + with new distfiles, and the percentage of those ports that are + out-of-date. The search function allows for searching by email + address for a specific maintainer, and for selecting whether + or not only out-of-date ports should be shown. + + Upon clicking on a maintainer's email address, + a list of all of their ports is displayed, along with port + category, current version number, whether or not there is a new + version, when the port was last updated, and finally when it + was last checked. A search function on this page allows the + user to search for a specific port. + + Clicking on a port name in the list displays the + FreshPorts port + information.