From nobody Sun Oct 09 17:00:42 2022 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4MlpG25VJqz4f5w5 for ; Sun, 9 Oct 2022 17:00:42 +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 4MlpG250JCz43lL; Sun, 9 Oct 2022 17:00:42 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1665334842; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=y6p0OgGMERHxVKvbNOYUuQr0Larp9JUTi4lRfnIEl+8=; b=FXloaX/dXE3pXVf4HODpjh91BCwQvuW3In5hemHv4ofJBOIlg8oVxt7J0UlbedX1f9oJ9G IuSE7oJHF5i6pJ8fJh5sQgdzjB8879azf1/Rcr5UvlDAiQum2sexDBizwL6WTBkpSwTR89 MbvlIRm1sDazUxZYWK3M3QDry+Md4apOJ73MMVEwEkicH91CAwf1RuaIGlw8JiVCtopz9Y PLcbiq0C11b25X1IzV0OkrW/SjPg0nKOBZCTPwBMcuHezvFpC7fI6VyV2Xn939dsY9fjjw VFymNFem2xzyM9tiJyCi7q1jpI3vPn/Yp0XE77tgYYrB/ZBEbZnzTcpGkoumkw== 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 4MlpG243zHzLdP; Sun, 9 Oct 2022 17:00:42 +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 299H0gY7053835; Sun, 9 Oct 2022 17:00:42 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 299H0gnP053834; Sun, 9 Oct 2022 17:00:42 GMT (envelope-from git) Date: Sun, 9 Oct 2022 17:00:42 GMT Message-Id: <202210091700.299H0gnP053834@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Muhammad Moinur Rahman Subject: git: 6feb98a171 - main - handbooks: Remove references to portsnap List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bofh X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 6feb98a1718ebd4abf0c4cfc0445c1be3337db1a Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1665334842; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=y6p0OgGMERHxVKvbNOYUuQr0Larp9JUTi4lRfnIEl+8=; b=JBoG5VDPxD0KK8aTnHMq/L9AaC/ezQ2UR0tJIA98hvngFMVW0pVHcLjbJwkQb5QxDXzC5D j2AfrfS59VZISeZKqXCgZMJYawBk7+SMf2nDCXiJ8qUNe9nIvpG3nRm1xHugo1ZQcoJXHD Elg1rohkJPmgponpMD7HB4UO/1NFuUbSt4yIqKuj8Q9aQZz8D2qI9QM4XZ6eCoizeu4Qio I9zpMlDAilUXSLlAAfysq8RfGR1RA2QQRqaVsDriitRoHP1zwj024hBO/bXHjW6EvWhfrF M1AZcyr2sTBus7KepX+Oo+Jrx2DwDC69mikAib/LgCJrdbtWNBX6w6ed4wI9Lw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1665334842; a=rsa-sha256; cv=none; b=HJo2pEk0s2gBiZAW2PBVUgx2mJc1hojAJPX3hAFHJm4WnWsw2u9icSNE3XTQt26uUD+wPq CH+mopJuOfCt8cyYnNrVpvGFu73rzbV1NLzObk0tmpWEpL+k0VZ08tbuDtwuvQ4uHrSo1X tpe2lgERHXixhC4AD5Sg+8nk4cVC7yFdLp/fJa81u6+oLgSxBTvDBnimaDdpSalxDWUqKp hJtbVLUXsVc5f4yzdtmfkNYs33rYqJXUYFC9/VOcucSNbBH+eHa+VXWF90WnQcHnp4shel KBn3THqos4XcWe72Pmq0vxd8okqEc29BoqV6N6d/arEYuBwxGcGTEWhIwMg8yQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by bofh: URL: https://cgit.FreeBSD.org/doc/commit/?id=6feb98a1718ebd4abf0c4cfc0445c1be3337db1a commit 6feb98a1718ebd4abf0c4cfc0445c1be3337db1a Author: Muhammad Moinur Rahman AuthorDate: 2022-10-09 16:57:41 +0000 Commit: Muhammad Moinur Rahman CommitDate: 2022-10-09 16:57:41 +0000 handbooks: Remove references to portsnap Although we are still generating portsnap deltas it is no longer the recommended methods and git should be promoted. So remove references to portsnap. Additionally - Remove training whitespace - Remove trailing consecutive blank lines By no means this is an indication that portsnap is going to be removed from the base or that portmgr@ is going to stop producing deltas. This is just to demote the usages of portsnap and promote git. PR: 264763 Approved by: carlavilla (mentor) --- .../content/en/articles/linux-users/_index.adoc | 8 ++-- .../content/en/books/handbook/jails/_index.adoc | 4 +- .../content/en/books/handbook/mirrors/_index.adoc | 4 +- .../content/en/books/handbook/ports/_index.adoc | 49 +--------------------- .../en/books/porters-handbook/testing/_index.adoc | 14 ++----- website/content/en/ports/installing.adoc | 2 +- 6 files changed, 13 insertions(+), 68 deletions(-) diff --git a/documentation/content/en/articles/linux-users/_index.adoc b/documentation/content/en/articles/linux-users/_index.adoc index 37f9a4126d..9db8a0eeea 100644 --- a/documentation/content/en/articles/linux-users/_index.adoc +++ b/documentation/content/en/articles/linux-users/_index.adoc @@ -113,8 +113,8 @@ For more information on packages refer to section 5.4 of the FreeBSD Handbook: e The FreeBSD Ports Collection is a framework of [.filename]#Makefiles# and patches specifically customized for installing applications from source on FreeBSD. When installing a port, the system will fetch the source code, apply any required patches, compile the code, and install the application and any required dependencies. -The Ports Collection, sometimes referred to as the ports tree, can be installed to [.filename]#/usr/ports# using man:portsnap[8]. -Detailed instructions for installing the Ports Collection can be found in extref:{handbook}[section 5.5, ports-using] of the FreeBSD Handbook. +The Ports Collection, sometimes referred to as the ports tree, can be installed to [.filename]#/usr/ports# using link:{handbook}mirrors/#git[Git]. +Detailed instructions for installing the Ports Collection can be found in extref:{handbook}[section 4.5.1, ports-using-installation-methods] of the FreeBSD Handbook. To compile a port, change to the port's directory and start the build process. The following example installs Apache 2.4 from the Ports Collection: @@ -141,10 +141,10 @@ Refer to extref:{handbook}[Using the Ports Collection, ports-using] for more inf Many Linux(R) distributions use the SysV init system, whereas FreeBSD uses the traditional BSD-style man:init[8]. Under the BSD-style man:init[8], there are no run-levels and [.filename]#/etc/inittab# does not exist. Instead, startup is controlled by man:rc[8] scripts. -At system boot, [.filename]#/etc/rc# reads [.filename]#/etc/rc.conf# and [.filename]#/etc/defaults/rc.conf# to determine which services are to be started. +At system boot, [.filename]#/etc/rc# reads [.filename]#/etc/rc.conf# and [.filename]#/etc/defaults/rc.conf# to determine which services are to be started. The specified services are then started by running the corresponding service initialization scripts located in [.filename]#/etc/rc.d/# and [.filename]#/usr/local/etc/rc.d/#. These scripts are similar to the scripts located in [.filename]#/etc/init.d/# on Linux(R) systems. -The scripts found in [.filename]#/etc/rc.d/# are for applications that are part of the "base" system, such as man:cron[8], man:sshd[8], and man:syslog[3]. +The scripts found in [.filename]#/etc/rc.d/# are for applications that are part of the "base" system, such as man:cron[8], man:sshd[8], and man:syslog[3]. The scripts in [.filename]#/usr/local/etc/rc.d/# are for user-installed applications such as Apache and Squid. Since FreeBSD is developed as a complete operating system, user-installed applications are not considered to be part of the "base" system. diff --git a/documentation/content/en/books/handbook/jails/_index.adoc b/documentation/content/en/books/handbook/jails/_index.adoc index f59416450b..5b2d469e0b 100644 --- a/documentation/content/en/books/handbook/jails/_index.adoc +++ b/documentation/content/en/books/handbook/jails/_index.adoc @@ -401,7 +401,7 @@ The file system layout is as follows: This section describes the steps needed to create the master template. It is recommended to first update the host FreeBSD system to the latest -RELEASE branch using the instructions in crossref:cutting-edge[makeworld,“Updating FreeBSD from Source”]. -Additionally, this template uses the package:sysutils/cpdup[] package or port and portsnap will be used to download the FreeBSD Ports Collection. +Additionally, this template uses the package:sysutils/cpdup[] package or port and link:{handbook}mirrors/#git[Git] will be used to download the FreeBSD Ports Collection. [.procedure] . First, create a directory structure for the read-only file system which will contain the FreeBSD binaries for the jails. Then, change directory to the FreeBSD source tree and install the read-only file system to the jail template: @@ -419,7 +419,7 @@ Additionally, this template uses the package:sysutils/cpdup[] package or port an .... # cd /home/j/mroot # mkdir usr/ports -# portsnap -p /home/j/mroot/usr/ports fetch extract +# git clone -o freebsd https://git.FreeBSD.org/ports.git /home/j/mroot/usr/ports # cpdup /usr/src /home/j/mroot/usr/src .... diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index b97c43d334..34a866c3b1 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -295,7 +295,7 @@ As of April 2021, FreeBSD uses git as the only version control system for storin [NOTE] ==== Git is generally a developer tool. -Users may prefer to use `freebsd-update` (crossref:cutting-edge[updating-upgrading-freebsdupdate,“FreeBSD Update”]) to update the FreeBSD base system, and `portsnap` (crossref:ports[ports-using,“Using the Ports Collection”]) to update the FreeBSD Ports Collection. +Users may prefer to use `freebsd-update` (crossref:cutting-edge[updating-upgrading-freebsdupdate,“FreeBSD Update”]) to update the FreeBSD base system, and `git` (crossref:ports[ports-using,“Using the Ports Collection”]) to update the FreeBSD Ports Collection. ==== This section demonstrates how to install Git on a FreeBSD system and use it to create a local copy of a FreeBSD source code repository. @@ -430,7 +430,7 @@ As of April 2021, FreeBSD uses git as the only version control system for storin [NOTE] ==== Subversion is generally a developer tool. -Users may prefer to use `freebsd-update` (crossref:cutting-edge[updating-upgrading-freebsdupdate,“FreeBSD Update”]) to update the FreeBSD base system, and `portsnap` (crossref:ports[ports-using,“Using the Ports Collection”]) to update the FreeBSD Ports Collection. +Users may prefer to use `freebsd-update` (crossref:cutting-edge[updating-upgrading-freebsdupdate,“FreeBSD Update”]) to update the FreeBSD base system, and `git` (crossref:ports[ports-using,“Using the Ports Collection”]) to update the FreeBSD Ports Collection. After March 2021, subversion use is only for legacy branches (`stable/11` and `stable/12`). ==== diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc index 9ef5fc049d..b7c29721c5 100644 --- a/documentation/content/en/books/handbook/ports/_index.adoc +++ b/documentation/content/en/books/handbook/ports/_index.adoc @@ -666,53 +666,6 @@ The extract portion of building a port will automatically save the downloaded so 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: -[[ports-using-portsnap-method]] -[.procedure] -**** -*Procedure: Portsnap Method* - -The base system of FreeBSD includes Portsnap. -This is a fast and user-friendly tool for retrieving the Ports Collection and is the recommended choice for most users not running FreeBSD-CURRENT. -This utility connects to a FreeBSD site, verifies the secure key, and downloads a new copy of the Ports Collection. -The key is used to verify the integrity of all downloaded files. - -Note that Portsnap updates are generated from a snapshot of the main -branch of the Ports Collection and cannot be configured to use a -different branch (for example, `quarterly`). -If it is necessary to use a different branch of the Ports Collection -(for instance as referenced earlier in conjunction with binary -packages), then the <> must be used. - -. To download a compressed snapshot of the Ports Collection into [.filename]#/var/db/portsnap#: -+ -[source,shell] -.... -# portsnap fetch -.... -+ -. When running Portsnap for the first time, extract the snapshot into [.filename]#/usr/ports#: -+ -[source,shell] -.... -# portsnap extract -.... -+ -. After the first use of Portsnap has been completed as shown above, [.filename]#/usr/ports# can be updated as needed by running: -+ -[source,shell] -.... -# portsnap fetch -# portsnap update -.... -+ -When using `fetch`, the `extract` or the `update` operation may be run consecutively, like so: -+ -[source,shell] -.... -# portsnap fetch update -.... -**** - [[ports-using-git-method]] [.procedure] **** @@ -945,7 +898,7 @@ Over time, newer versions of software become available in the Ports Collection. This section describes how to determine which software can be upgraded and how to perform the upgrade. To determine if newer versions of installed ports are available, ensure that the latest version of the ports tree is installed, -using the updating command described in either <> or <>. +using the updating command described in <>. On FreeBSD 10 and later, or if the system has been converted to pkg, the following command will list the installed ports which are out of date: [source,shell] diff --git a/documentation/content/en/books/porters-handbook/testing/_index.adoc b/documentation/content/en/books/porters-handbook/testing/_index.adoc index 9491c07530..c23c29766c 100644 --- a/documentation/content/en/books/porters-handbook/testing/_index.adoc +++ b/documentation/content/en/books/porters-handbook/testing/_index.adoc @@ -266,7 +266,6 @@ Choose a server location which is close, for example if the machine is located i `SVN_HOST`:: The server from where jails are installed and updated when using Subversion. -Also used for ports tree when not using man:portsnap[8]. Again, choose a nearby location. A list of official Subversion mirrors can be found in the extref:{handbook}[FreeBSD Handbook Subversion section, svn-mirrors]. @@ -375,21 +374,14 @@ For example, if the building machine has 6 CPUs, use: === Setting Up Ports Trees for Use with Poudriere There are multiple ways to use ports trees in Poudriere. -The most straightforward way is to have Poudriere create a default ports tree for itself, using either man:portsnap[8] (if running FreeBSD {rel121-current} or {rel114-current}) or Git (if running FreeBSD-CURRENT): - -[source,shell] -.... -# poudriere ports -c -m portsnap -.... - -or +The most straightforward way is to have Poudriere create a default ports tree for itself, using link:{handbook}mirrors/#git[Git]: [source,shell] .... # poudriere ports -c -m git+https -B main .... -These commands create `tank/poudriere/ports/default`, mount it on [.filename]#/poudriere/ports/default#, and populate it using Git, man:portsnap[8], or Subversion. +These commands create `tank/poudriere/ports/default`, mount it on [.filename]#/poudriere/ports/default#, and populate it using Git. Afterward it is included in the list of known ports trees: [source,shell] @@ -406,7 +398,7 @@ Each of the build commands explained later will implicitly use this ports tree u To use another tree, add `-p _treename_` to the commands. ==== -While useful for regular bulk builds, having this default ports tree with the man:portsnap[8] method may not be the best way to deal with local modifications for a ports contributor. +The best way to deal with local modifications for a ports contributor is to use link:{handbook}mirrors/#git[Git]. As with the creation of jails, it is possible to use a different method for creating the ports tree. To add an additional ports tree for testing local modifications and ports development, checking out the tree via Subversion (as described above) is preferable. diff --git a/website/content/en/ports/installing.adoc b/website/content/en/ports/installing.adoc index ddc619e673..cd69270646 100644 --- a/website/content/en/ports/installing.adoc +++ b/website/content/en/ports/installing.adoc @@ -15,4 +15,4 @@ include::shared/en/urls.adoc[] The FreeBSD installer programs allow the Ports Collection to be installed at the same time as the operating system. See link:{handbook}bsdinstall[installing FreeBSD]. -If not initially installed, it can be added with link:{handbook}ports/#ports-using-portsnap-method[portsnap] or link:{handbook}ports/#ports-using-git-method[Git]. +If not initially installed, it can be added with link:{handbook}ports/#ports-using-git-method[Git].