From nobody Sun Dec 29 09:48:15 2024 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 4YLZDH2xMMz5k765 for ; Sun, 29 Dec 2024 09:48:15 +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 "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4YLZDH2SLhz4MZl; Sun, 29 Dec 2024 09:48:15 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1735465695; 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=ew1knWaCSNVMVtmsuSzF5yt/VD9KmMVIjuW07EtUQuo=; b=tDGsOadvoT7yTtfIWpAcnaHzaXDrlz3iBlywzVomi302vkFtbtRFXm0ExCu7VBeTHXyLKc WK0tbDjkB7JRJf4wUL7X8DxI+1OhbNxhI9bQ4xPJ8QLSLJJPLK3UPw7vARAV4UuStzU16N YLRa0hLYuCR46MxJA7T06ewMpADLGpxQoP9+BsEukLwDjNjeUF5ZD+J6pOePBMNyE59Jjj 6AhI2mOpX4B4jsuCr7ivbd0/gibEpnQ6mUcHqNy7CvJfBGBCyw24JgAHOuGXEOK+0kmdUb 9b/rXr+73Tk6k6w2s411h43rh4SdU2Yuc+QWF7UKRJsSe7sQVgk9CbrfeFCCGg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1735465695; 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=ew1knWaCSNVMVtmsuSzF5yt/VD9KmMVIjuW07EtUQuo=; b=uceXUld5sQyNiJzcaZ9u9+WmqPZWnAQlYQ3u17SwnaVeOaE6nWipeoDDtPNqbpr877iBSG 7A/9IArG9y1zHBi4KB1yXXfC9IJ87WHrd4185cU+ua6LM5DmAuqWoKJamjO7NIOjcvjLP8 T0WoIafNL+JdZ1dBNWCKbSSfgRsjizzjglqaUxanup1xevjoXCvZxQr6hTu9dEufcXgF2V gtzchSBeWGcqKPdYhRJmWcua7YXAMGmQ3C/4PuiNXvckD1zdNzbvqduHsC3zPnoLz47syc e48BZnmMWdzeV37vXiQNDkj5/mtgn+z2vQZHNI17DFtEZDThNzMdFDhZOfEZTg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1735465695; a=rsa-sha256; cv=none; b=CiEkRFKkrMYVQ7Wau92mHTEAR9KzZ66YarR5wqPYsGAOViLqJa2mV1qH0BdmpWyAe5aV2w ZsYJeMTIYfWD/y6Itj66nXfBcwsFSDBr18RW7TLsN1fsNZ5jSDn62mPPmLLnsdtG6ym63p qyot5hg3/3CrV/GrpSI83wMFFDl0IGEm+HuW8tgoqdnF0Z4KlaIzF+9kSDWkL1pZLHOUOb JQ7VeDL2acEbdzysY7JE0fnk99WyHRU9W/ZOeYB8JjQpEPcOBT2JzFWqV/cFIUk+v5YSts +jIrFDFnQO3z8m1GHWS3T7EtecWFPPj8gtSI4VA0D/kUPnhRSHz5F6a8Ul4vDQ== 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 4YLZDH1xDLz1406; Sun, 29 Dec 2024 09:48:15 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 4BT9mFRa002235; Sun, 29 Dec 2024 09:48:15 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 4BT9mF3c002232; Sun, 29 Dec 2024 09:48:15 GMT (envelope-from git) Date: Sun, 29 Dec 2024 09:48:15 GMT Message-Id: <202412290948.4BT9mF3c002232@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 59221146cd - main - Handbook - Ports: Reword section about multiple package version 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: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-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: 59221146cd77f2afdf64c401c4fe475644e53e31 Auto-Submitted: auto-generated The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=59221146cd77f2afdf64c401c4fe475644e53e31 commit 59221146cd77f2afdf64c401c4fe475644e53e31 Author: Daniel O'Connor AuthorDate: 2024-12-29 09:45:52 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2024-12-29 09:45:52 +0000 Handbook - Ports: Reword section about multiple package version Reviewed by: carlavilla@, ziaee@ Pull Request: https://github.com/freebsd/freebsd-doc/pull/422 --- documentation/content/en/books/handbook/ports/_index.adoc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc index 8797672f9b..70c0b132a5 100644 --- a/documentation/content/en/books/handbook/ports/_index.adoc +++ b/documentation/content/en/books/handbook/ports/_index.adoc @@ -96,7 +96,9 @@ Select the technology that meets your requirements for installing a particular a * Packages are normally compiled with conservative options because they have to run on the maximum number of systems. By compiling from the port, one can change the compilation options. * Some applications have compile-time options relating to which features are installed. For example, NGINX(R) can be configured with a wide variety of different built-in options. + -In some cases, multiple packages will exist for the same application to specify certain settings. For example, NGINX(R) is available as a `nginx` package and a `nginx-lite` package, depending on whether or not Xorg is installed. Creating multiple packages rapidly becomes impossible if an application has more than one or two different compile-time options. +In some cases, multiple packages will exist for the same application with different settings. For example, NGINX(R) is available as a `nginx` package and a `nginx-lite` package, the former has many more options enabled, but this in turn requires many things to be installed as dependencies for it to work, thus increasing space consumption and attack surface. ++ +The transitive dependencies can grow quite large, for example the full `nginx` package will pull in several X libraries which can be quite surprising, so building from ports allow you to choose only the options you need without a "kitchen sink" approach.In some cases, multiple packages will exist for the same application to specify certain settings. * The licensing conditions of some software forbid binary distribution. Such software must be distributed as source code which must be compiled by the end-user. * Some people do not trust binary distributions or prefer to read through source code in order to look for potential problems. * Source code is needed in order to apply custom patches.