From nobody Sat Mar 25 19:29:55 2023 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 4PkTg752zpz41bZR for ; Sat, 25 Mar 2023 19:29:55 +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 4PkTg74b5vz3R7j; Sat, 25 Mar 2023 19:29:55 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1679772595; 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=B6en2Y1SHFFTQfASZFN3batFqhgRuqnuEh1P1FQiDU0=; b=cq/KW4KaJ3LMii7U3MfYVVtsBF9XxQYDws9xGG2vndEuRVbDH3Ku5+dGvxfR0FbkZFUSNC wYfIFUkjkj2soyi+9zNJn4Qx+XzvTaHqcgpkpkCj7U8pm2xHKrMcmX7nOzsHu7eyDjS/Lg 6EF+il72oCcigzXZS7jjZD8r+XbOKreVhUjEF23LlCjD5I5cmVChzZ+UHbsRNq72EOCTk6 6/Fmuky3yFt/duJnUeWIAnNB/hIWjODuS3SWaktNGJI0rwvkxCDaZYlrE591k7XcK91VvD MnXlui1Lj0orJWH0USoDegBlMS8NoubEWNnLQ65IBs0GMYmK7sQyOFop099oag== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1679772595; 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=B6en2Y1SHFFTQfASZFN3batFqhgRuqnuEh1P1FQiDU0=; b=nSgVUjNqh4mIwFu8Q8itrGVz9+9/j3gN8VPIYuTL1zy9d2+50MOXBl16X3UCMkmJ+/mvDg NNvEOGyd3R2heo9iwijKX38N8wXqCr+614xSHBT6iyXberzo/8n+hNdVDq3hTXYGdLpy7s Dd6R47BsXK0avbXOC0f2ijfnj54GFm5SKPmvZj3DMH0/M6vmDnmclRZDj9JkIIXvOsDIzV vTTZbfDZlFOErzeVWXiWIFtfiARioLD92wgghYID827wQs7NZyythcouGnJkqlPeHXUwSz /NmwjZC5i7Lc0YoL70V45MqHROpHDU3CZjE7e+PIEh76cBzc6Ja9VkGUGDmKYg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1679772595; a=rsa-sha256; cv=none; b=ITyxS5DXz0n+btawB25/tYY49fYWHZ5wF3RpEsNyQH5IUv2VdhuthpDonhyUgm6KkPhR+w 2VGzv7N5qFRqJVp6DyWQ078eCM9dHmVh9CHBCgZrEUymCnlnvAERqbe3iCxYaOmHWhKZZ2 MQV/Kg+yxtQLGlq43KsnoFotlvA/vvyoYJYPcT+Fs4M84rKdl27s7nfW9vc5O6oqyzJVYi zANGnv2aBrUvTdAVfl9rqjLSgSa/bgdTT2Y+vimj/YI3s04bw/sIzzCIL4HWBdtdNnTj7n +1Q/7sncUg0X8TRb7u6Ikx22qIvsMhnycrbBkCtIxtFeJRzzKjJ60C1JziBk4A== 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 4PkTg73g2vz19wr; Sat, 25 Mar 2023 19:29:55 +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 32PJTtRX009427; Sat, 25 Mar 2023 19:29:55 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 32PJTt6J009426; Sat, 25 Mar 2023 19:29:55 GMT (envelope-from git) Date: Sat, 25 Mar 2023 19:29:55 GMT Message-Id: <202303251929.32PJTt6J009426@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Graham Perrin Subject: git: b1b9aa4654 - main - About FreeBSD Ports: one sentence per line 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: grahamperrin X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: b1b9aa465426f1b17207cd002d7ff8d88d999ee9 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by grahamperrin: URL: https://cgit.FreeBSD.org/doc/commit/?id=b1b9aa465426f1b17207cd002d7ff8d88d999ee9 commit b1b9aa465426f1b17207cd002d7ff8d88d999ee9 Author: Pau Amma AuthorDate: 2023-02-11 19:08:00 +0000 Commit: Graham Perrin CommitDate: 2023-03-25 19:27:21 +0000 About FreeBSD Ports: one sentence per line Approved by: grahamperrin, wosch Differential revision: https://reviews.freebsd.org/D38509 --- website/content/en/ports/_index.adoc | 23 ++++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/website/content/en/ports/_index.adoc b/website/content/en/ports/_index.adoc index 3c628e7ad3..ec2077e778 100644 --- a/website/content/en/ports/_index.adoc +++ b/website/content/en/ports/_index.adoc @@ -13,10 +13,19 @@ include::shared/en/urls.adoc[] The FreeBSD Ports and Packages Collection offers a simple way for users and administrators to install applications. -The Ports Collection supports the latest release on the link:{faq}#current[FreeBSD-CURRENT] and link:{faq}#stable[FreeBSD-STABLE] branches. Older releases are not supported and may or may not work correctly with an up-to-date ports collection. Over time, changes to the ports collection may rely on features that are not present in older releases. Wherever convenient, we try not to gratuitously break support for recent releases, but it is sometimes unavoidable. When this occurs, patches contributed by the user community to maintain support for older releases will usually be committed. - -Each "port" listed here contains any patches necessary to make the original application source code compile and run on FreeBSD. Installing an application is as simple as typing `make install` in the port directory. If you download the framework for the entire list of ports by installing the link:{handbook}ports/#ports-using[ports hierarchy], you can have thousands of applications right at your fingertips. - -Each port's `Makefile` automatically fetches the application source code, either from a local disk or the network, unpacks it on your system, applies the patches, and compiles. If all went well, a simple `make install` will install the application and register it with the package system. - -For most ports, a precompiled `package` also exists, saving the user the work and time of having to compile anything at all. Use man:pkg-install[8] to securely download and install the precompiled version of a port. For more information see link:{handbook}ports/#pkgng-intro[Using pkg for Binary Package Management] +The Ports Collection supports the latest release on the link:{faq}#current[FreeBSD-CURRENT] and link:{faq}#stable[FreeBSD-STABLE] branches. +Older releases are not supported and may or may not work correctly with an up-to-date ports collection. +Over time, changes to the ports collection may rely on features that are not present in older releases. +Wherever convenient, we try not to gratuitously break support for recent releases, but it is sometimes unavoidable. +When this occurs, patches contributed by the user community to maintain support for older releases will usually be committed. + +Each "port" listed here contains any patches necessary to make the original application source code compile and run on FreeBSD. +Installing an application is as simple as typing `make install` in the port directory. +If you download the framework for the entire list of ports by installing the link:{handbook}ports/#ports-using[ports hierarchy], you can have thousands of applications right at your fingertips. + +Each port's `Makefile` automatically fetches the application source code, either from a local disk or the network, unpacks it on your system, applies the patches, and compiles. +If all went well, a simple `make install` will install the application and register it with the package system. + +For most ports, a precompiled `package` also exists, saving the user the work and time of having to compile anything at all. +Use man:pkg-install[8] to securely download and install the precompiled version of a port. +For more information see link:{handbook}ports/#pkgng-intro[Using pkg for Binary Package Management].