From owner-svn-doc-all@freebsd.org Wed Aug 5 11:09:22 2020 Return-Path: Delivered-To: svn-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 BAD05371C74; Wed, 5 Aug 2020 11:09:22 +0000 (UTC) (envelope-from bcr@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 "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4BM85Z4WnJz4h3L; Wed, 5 Aug 2020 11:09:22 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 7E8C214EF6; Wed, 5 Aug 2020 11:09:22 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id 075B9Mk8072739; Wed, 5 Aug 2020 11:09:22 GMT (envelope-from bcr@FreeBSD.org) Received: (from bcr@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id 075B9Mdu072738; Wed, 5 Aug 2020 11:09:22 GMT (envelope-from bcr@FreeBSD.org) Message-Id: <202008051109.075B9Mdu072738@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: bcr set sender to bcr@FreeBSD.org using -f From: Benedict Reuschling Date: Wed, 5 Aug 2020 11:09:22 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r54396 - head/en_US.ISO8859-1/books/porters-handbook/testing X-SVN-Group: doc-head X-SVN-Commit-Author: bcr X-SVN-Commit-Paths: head/en_US.ISO8859-1/books/porters-handbook/testing X-SVN-Commit-Revision: 54396 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.33 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: Wed, 05 Aug 2020 11:09:22 -0000 Author: bcr Date: Wed Aug 5 11:09:22 2020 New Revision: 54396 URL: https://svnweb.freebsd.org/changeset/doc/54396 Log: Deprecate references to portsnap. FreeBSD versions newer than 12.1 won't use portsnap anymore, so advise to use Subversion instead. While here, fix an errand plural. Submitted by: pauamma_gundo.com Approved by: bcr Differential Revision: https://reviews.freebsd.org/D25801 Modified: head/en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml Wed Aug 5 11:02:12 2020 (r54395) +++ head/en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml Wed Aug 5 11:09:22 2020 (r54396) @@ -471,7 +471,7 @@ SVN_HOST=svn.FreeBSD.org kernels can build and run older jails. For instance, a 13.0-CURRENT kernel can build and run a 11.3-STABLE - Poudriere jails if the + Poudriere jail if the COMPAT_FREEBSD11 kernel option was compiled in (on by default in 13.0-CURRENT @@ -534,19 +534,27 @@ JAILNAME VERSION ARCH METH Poudriere. The most straightforward way is to have Poudriere create a default ports - tree for itself: + tree for itself, using either &man.portsnap.8; (if running + &os; &rel121.current; or &rel114.current;) or + Subversion (if running + &os.current;): - &prompt.root; poudriere ports -c + &prompt.root; poudriere ports -c -m portsnap - This command creates + or + + &prompt.root; poudriere ports -c -m svn+https + + These commands create tank/poudriere/ports/default, mount it on /poudriere/ports/default, and populate it - using &man.portsnap.8;. Afterward it is included in the list - of known ports trees: + using either &man.portsnap.8; or + Subversion. Afterward it is + included in the list of known ports trees: &prompt.root; poudriere ports -l -PORTSTREE METHOD PATH -default portsnap /poudriere/ports/default +PORTSTREE METHOD TIMESTAMP PATH +default svn+https 2020-07-20 04:23:56 /poudriere/ports/default Note that the default ports tree is @@ -564,10 +572,9 @@ default portsnap /poudriere/ports/defaultSubversion is possible: + Subversion (as described above) + is preferable. - &prompt.root; poudriere ports -c -m svn+https -p subversive - The http and https methods need devel/subversion @@ -575,17 +582,6 @@ default portsnap /poudriere/ports/default - Creates tank/poudriere/ports/subversive - and mounts it on - /poudriere/ports/subversive. It is then - populated using Subversion. - Finally, it is added to the list of known ports trees: - - &prompt.root; poudriere ports -l -PORTSTREE METHOD PATH -default portsnap /poudriere/ports/default -subversive svn+https /poudriere/ports/subversive - The svn method allows extra qualifiers to tell Subversion @@ -625,11 +621,11 @@ subversive svn+https /poudriere/ports/subve This will be listed in the table of known trees: &prompt.root; poudriere ports -l -PORTSTREE METHOD PATH -development - /work/ports +PORTSTREE METHOD TIMESTAMP PATH +development null 2020-07-20 05:06:33 /work/ports - The dash in the METHOD column means + The dash or null in the METHOD column means that Poudriere will not update or change this ports tree, ever. It is completely up to the user to maintain this tree, including all local