From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 15:23:25 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 E81C75F5DAD for ; Mon, 19 Apr 2021 15:23:25 +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 4FP9Z56Hgjz4XYm; Mon, 19 Apr 2021 15:23:25 +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 CAD0C21679; Mon, 19 Apr 2021 15:23:25 +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 13JFNPsB091196; Mon, 19 Apr 2021 15:23:25 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JFNPoX091195; Mon, 19 Apr 2021 15:23:25 GMT (envelope-from git) Date: Mon, 19 Apr 2021 15:23:25 GMT Message-Id: <202104191523.13JFNPoX091195@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 5dddbce327 - main - FAQ: Do not explain how to get ports twice 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: 5dddbce32755648605f510517d66181af6bbb4d0 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: Mon, 19 Apr 2021 15:23:26 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=5dddbce32755648605f510517d66181af6bbb4d0 commit 5dddbce32755648605f510517d66181af6bbb4d0 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 15:15:59 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 15:23:30 +0000 FAQ: Do not explain how to get ports twice Instead, point users to the appropriate chapter in the handbook. I've named the anchor "ports-using-installation-methods" for consistency with the existing ones. There is no need to break existing bookmarks. At least for now. --- documentation/content/en/books/faq/_index.adoc | 5 +---- documentation/content/en/books/handbook/ports/_index.adoc | 1 + 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/documentation/content/en/books/faq/_index.adoc b/documentation/content/en/books/faq/_index.adoc index c5829704e8..5db269a12b 100644 --- a/documentation/content/en/books/faq/_index.adoc +++ b/documentation/content/en/books/faq/_index.adoc @@ -839,10 +839,7 @@ FreeBSD supports compressed binary packages to easily install and uninstall port [[how-do-download-ports-tree]] === How do I download the Ports tree? Should I be using Git? -Any of the methods listed here work: - -* Use man:portsnap[8] for most use cases. Refer to link:{handbook}#ports-using/[Using the Ports Collection] for instructions on how to use this tool. -* Use Git if custom patches to the ports tree are needed or if running FreeBSD-CURRENT. Refer to link:{handbook}mirrors/#git[Using Git] for details. +See crossref:handbook[ports-using-installation-methods,Installing the Ports Collection]. [[ports-4x]] === Why can I not build this port on my {rel2-relx} -, or {rel-relx} -STABLE machine? diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc index 68d2d09676..cd49ab7eb9 100644 --- a/documentation/content/en/books/handbook/ports/_index.adoc +++ b/documentation/content/en/books/handbook/ports/_index.adoc @@ -591,6 +591,7 @@ Some ports include [.filename]#pkg-message# or other files to handle special sit The port does not include the actual source code, also known as a [.filename]#distfile#. The extract portion of building a port will automatically save the downloaded source to [.filename]#/usr/ports/distfiles#. +[[ports-using-installation-methods]] === Installing the Ports Collection 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 FreeBSD, use one of the following methods to install it: