From owner-svn-doc-all@freebsd.org Wed Nov 18 10:32:33 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 22BBB2EAAF9; Wed, 18 Nov 2020 10:32:33 +0000 (UTC) (envelope-from 0mp@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 4CbfJd0Spdz3DXZ; Wed, 18 Nov 2020 10:32:33 +0000 (UTC) (envelope-from 0mp@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 0304E10D23; Wed, 18 Nov 2020 10:32:33 +0000 (UTC) (envelope-from 0mp@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id 0AIAWWoJ066857; Wed, 18 Nov 2020 10:32:32 GMT (envelope-from 0mp@FreeBSD.org) Received: (from 0mp@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id 0AIAWWXH066856; Wed, 18 Nov 2020 10:32:32 GMT (envelope-from 0mp@FreeBSD.org) Message-Id: <202011181032.0AIAWWXH066856@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: 0mp set sender to 0mp@FreeBSD.org using -f From: Mateusz Piotrowski <0mp@FreeBSD.org> Date: Wed, 18 Nov 2020 10:32:32 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r54691 - head/en_US.ISO8859-1/books/handbook/ports X-SVN-Group: doc-head X-SVN-Commit-Author: 0mp X-SVN-Commit-Paths: head/en_US.ISO8859-1/books/handbook/ports X-SVN-Commit-Revision: 54691 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.34 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, 18 Nov 2020 10:32:33 -0000 Author: 0mp Date: Wed Nov 18 10:32:32 2020 New Revision: 54691 URL: https://svnweb.freebsd.org/changeset/doc/54691 Log: Add a warning regarding mixing ports(7) and pkg(8) to install software I think it's something that has been missing from the handbook for a long time. Unfortunately, this patch does not explain all the subtleties of the ports framework (like, e.g., that ports create packages during the build process which are then installed via pkg). We should probably hint the reader about it somewhere, but that's something for another patch. What's important here is to warn new users about problems they might encounter. Also, add some examples of working with quarterly with Subversion. PR: 251195 Submitted by: Fred Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Tue Nov 17 21:30:01 2020 (r54690) +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Wed Nov 18 10:32:32 2020 (r54691) @@ -837,6 +837,24 @@ security/sudo By default, the Ports Collection itself is stored as a subdirectory of /usr/ports. + + Before installing and using the Ports Collection, please + be aware that it is generally ill-advised to use the + Ports Collection in conjunction with the binary packages + provided via pkg to install + software. pkg, by default, + tracks quarterly branch-releases of the ports + tree and not HEAD. Dependencies could be different for a port + in HEAD compared to its counterpart in a quarterly branch + release and this could result in conflicts between + dependencies installed by pkg + and those from the Ports Collection. + If the Ports Collection and pkg + must be used in conjunction, then be sure that your + Ports Collection and pkg are + on the same branch release of the ports tree. + + Before an application can be compiled using a port, the Ports Collection must first be installed. If it was not installed during the installation of &os;, use one of the @@ -917,17 +935,31 @@ security/sudo - Check out a copy of the ports tree: + Check out a copy of the HEAD branch of the ports + tree: &prompt.root; svn checkout https://svn.FreeBSD.org/ports/head /usr/ports + Or, check out a copy of a quarterly branch: + + &prompt.root; svn checkout https://svn.FreeBSD.org/ports/branches/2020Q3 /usr/ports + + + As needed, update /usr/ports after the initial Subversion checkout: &prompt.root; svn update /usr/ports + + + + As needed, switch /usr/ports to a + different quarterly branch: + + &prompt.root; svn switch http://svn.freebsd.org/ports/branches/2020Q4/ /usr/ports