From nobody Thu Jan 19 20:16:34 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 4NyYmy47Jlz2sZVj for ; Thu, 19 Jan 2023 20:16:34 +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 4NyYmy3dqJz4CBH; Thu, 19 Jan 2023 20:16:34 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674159394; 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=zVpsUhxMGXg2rKNSioM1vKRBze9AM8Egf6PgQSgGz8o=; b=hr34clVNJDbxRzwAGdrzXYpwkfgWnglwwta+lNShG56NeknUvH5eptrpPthKsmpejixreX sPWmCpVz5QbQZMVBLqYj+MWg+XEaEz+8kwBej0GWtswHPZW6PqITvIZi/GKNL/tucmpjhT 1bMSsjOvBXaPvN2I9dfRg9udbmBRvc2zUfdhipTCh7+/NMa3pjIu0V9K2ln1zlwiSo2XAq 3VOkPvtmzrhi1u5BR+elEKtDw4RcwxICQZb/XswquuXbMZ4kZrxa7KeAoqGyaRpsRQKn3l FhrcuKKxeiDAPimgysFrcLh/yb/9tqrfhc98+NOVYm2xO4VzOoxQ4ARmvrqdXw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1674159394; 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=zVpsUhxMGXg2rKNSioM1vKRBze9AM8Egf6PgQSgGz8o=; b=EuyhT2ctSTOZuz6lcVnPtqvPiya0DD0PV8lP8jygxPhffKv0NB8czqUiE4coF0Jj6CKqKK JhRWCE3dDORxgYaMmF8OlekScVdFH5eX9JD0kWvVNsy0JyorUgVP3HYzMfEQ2TMt8AHoFE 6ZgX379g8GQiK+mwyu0TXM/mHmzhCk5DPoVbrbebN/e+Ko7YFx9RTD5mmkdOXLNN1tEn1Z S674AxFqB8vfNCqMWoJ3Ppd8+E4fIxN+XZGffmtW0SDmNXG8lGUCCRMye3YYCtrUS/2nk1 p0Hj5hdwz8jZkgzydWX+zvZY7B0Ph0tQywSfyGjhKLeLZ9Srfcgx3Z+MpKTQ3A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1674159394; a=rsa-sha256; cv=none; b=TofZLRzrDdLcoQ7+PAJnHE+5SHccUMVVx5th1xQx/FPdG/gun12LHClwxAvpczczImI7S8 VvnaMyYWblHaDm0hfxwy3GT5KplqCYVwuk0HoPHOxfVd65SaVOzk1sRmdW52WRCbZyQYet GS10xnXYmVZy0fQSiDv/pZRhsxIYX4imZK6zMJ+k5Nt3XxPfQB80fBc8L9HBsTDLT9jx2Q bAvvr85tzfXBfWlbkJQRbqe5OfpME6oCaVqMuNtPS8X8kqOUkufACjEsxI/8wEx62FH6xg n1cVeYavTU5DTTwGWSCM3PT9WzrUOqhGur1Bxp7vvTNC9bIsiMJRhN08IRe3lQ== 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 4NyYmy2hPvz13V0; Thu, 19 Jan 2023 20:16:34 +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 30JKGYBS026303; Thu, 19 Jan 2023 20:16:34 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 30JKGYHw026302; Thu, 19 Jan 2023 20:16:34 GMT (envelope-from git) Date: Thu, 19 Jan 2023 20:16:34 GMT Message-Id: <202301192016.30JKGYHw026302@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: c5fa554557 - main - Ports chapter - Upgrade references to stale packages 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: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c5fa554557e5cb07eec0446c7fcef05090065fb6 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=c5fa554557e5cb07eec0446c7fcef05090065fb6 commit c5fa554557e5cb07eec0446c7fcef05090065fb6 Author: Sergio Carlavilla Delgado AuthorDate: 2023-01-19 20:16:08 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2023-01-19 20:16:08 +0000 Ports chapter - Upgrade references to stale packages --- .../content/en/books/handbook/ports/_index.adoc | 21 ++++++--------------- 1 file changed, 6 insertions(+), 15 deletions(-) diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc index f7f351013c..79e5e97cc5 100644 --- a/documentation/content/en/books/handbook/ports/_index.adoc +++ b/documentation/content/en/books/handbook/ports/_index.adoc @@ -651,27 +651,20 @@ And to unlock `nginx-lite`: Software within the FreeBSD Ports Collection can undergo major version number changes. To address this, pkg has a built-in command to update package origins. -This can be useful, for example, if package:lang/php5[] is renamed to package:lang/php53[] so that package:lang/php5[] can now represent version `5.4`. +This can be useful, for example, if package:lang/python3[] is renamed to package:lang/python311[] so that package:lang/python3[] can now represent version `3.11`. To change the package origin for the above example, run: [source,shell] .... -# pkg set -o lang/php5:lang/php53 +# pkg set -o lang/python3:lang/python311 .... -As another example, to update package:lang/ruby18[] to package:lang/ruby19[], run: +As another example, to update package:lang/ruby31[] to package:lang/ruby32[], run: [source,shell] .... -# pkg set -o lang/ruby18:lang/ruby19 -.... - -As a final example, to change the origin of the `libglut` shared libraries from package:graphics/libglut[] to package:graphics/freeglut[], run: - -[source,shell] -.... -# pkg set -o graphics/libglut:graphics/freeglut +# pkg set -o lang/ruby31:lang/ruby32 .... [NOTE] @@ -681,12 +674,10 @@ To force a reinstallation of dependent packages, run: [source,shell] .... -# pkg install -Rf graphics/freeglut +# pkg install -Rf lang/ruby32 .... ==== - - [[ports-using]] == Using the Ports Collection @@ -861,7 +852,7 @@ To save this extra step, instead use `make install clean` when compiling the por ==== Customizing Ports Installation Some ports provide build options which can be used to enable or disable application components, provide security options, or allow for other customizations. -Examples include package:www/firefox[], package:security/gpgme[], and package:mail/sylpheed-claws[]. +Examples include package:www/firefox[] and package:security/gpgme[]. If the port depends upon other ports which have configurable options, it may pause several times for user interaction as the default behavior is to prompt the user to select options from a menu. To avoid this and do all of the configuration in one batch, run `make config-recursive` within the port skeleton.