From nobody Thu May 07 22:17:32 2026 X-Original-To: dev-commits-src-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 4gBRSs5bWcz6c5CH for ; Thu, 07 May 2026 22:17:33 +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 "R13" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4gBRSs0RB0z3d3f for ; Thu, 07 May 2026 22:17:33 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1778192253; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=hVIeQQRdoKgfn0zvBClS5dOddYax0yr//hnYnaYyZJU=; b=nQu4W939dYNmw3SwWUtSO5Wi1oMcqQHSjhPAQfw30cs2YBynnIfB0nSxc6PfsF6135+74X rWonJUUbnS1DARMODQlcDhJD4zBsOcgAV9yr5IIInejGYAhDGhZ8y1doXFeN8DENe5NiJL 9ZTTu4ILpna8Shofw8sKL/pF/0g8iSARzyh/5kLULw9CkBH6joyMiC+RpjIiySEqTipCTs CCdKI9EB3CFnwE4Kq3Vl12OKYlaUiOGWd7PVO+44lfwBLxbxG/44nEOGT+ufkBaNBS1t9a eJiDlH0SNAA100zkdPo/et0FGeTsE1oqiJtPot2d18OL27SYN330XcBOK+O2Xw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1778192253; a=rsa-sha256; cv=none; b=dKGTFbH6aMeI8JVY23d2bHj8U2k1LA0I7af9wcXHHMFz5df48vQQW+R7MkpgzotMsUcdr7 AXl0rn9kg9ZV36h2Zyr3tizGYwzDAZQc7iu0O0zNe9TtlbK6GLriucUzYAhRsc9xlpvzcB m0u1Hn4f/LtZCyYOmpMikul1so4MI/A0NTNVYB6vmQXGihsqO7VOa1ZiwTbAskmqH45Q6C N2oEHaXn3oDIbw3b18csj+72TTCvoi4Y9oTYb0ZUfZmOjXWMasamHRpPL/I+q32OwMnVFc egWhnwA9MT50zZXA1+BfQvMbE/g5q86t0ULc9k1fsRnD3M7M2isyI2WwcZwdzg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1778192253; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=hVIeQQRdoKgfn0zvBClS5dOddYax0yr//hnYnaYyZJU=; b=cXNltsGlxSNdEyvcltRsK+05B8NObcbd4R2s0gacwnGE6lTPtOLY2vdbqFhHLI8Wn99bDu 9uc7++gcndCdDA9tDgPTwJy8jEuKTiiMFOCoRzp9VaCuxUBlvx+NWpmc8QDnukW0uGnIc7 z1DUZUpmNKfrNm2hDFZ4UOZjx4oz+/iK0DZZq1t/xJbXQEnSnOVoSF3HlxBUNw0cZ6oXuP tUoyNjiaEIp9tyleygjZyY6lbZfmcXmmCI2ryBJ04Be7e7YF2eb7T48+5LnBCkFhJASkRO fpSi+nD4FuevPkuMaEOpvhq9wBpPNfnk0k/2pDgzod5AzuSdOIwBXIa/Ry/6jw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4gBRSr4NVMzlcJ for ; Thu, 07 May 2026 22:17:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 32db5 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Thu, 07 May 2026 22:17:32 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org Cc: Alexander Ziaee From: Colin Percival Subject: git: 1b5b7867b67f - releng/15.1 - ports.7/FILES: Expand and refactor into 3 tables List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: cperciva X-Git-Repository: src X-Git-Refname: refs/heads/releng/15.1 X-Git-Reftype: branch X-Git-Commit: 1b5b7867b67fdbe412cc4136834f21dbeef26bea Auto-Submitted: auto-generated Date: Thu, 07 May 2026 22:17:32 +0000 Message-Id: <69fd0f7c.32db5.10ee48b2@gitrepo.freebsd.org> The branch releng/15.1 has been updated by cperciva: URL: https://cgit.FreeBSD.org/src/commit/?id=1b5b7867b67fdbe412cc4136834f21dbeef26bea commit 1b5b7867b67fdbe412cc4136834f21dbeef26bea Author: Alexander Ziaee AuthorDate: 2026-05-03 17:25:41 +0000 Commit: Colin Percival CommitDate: 2026-05-07 22:16:28 +0000 ports.7/FILES: Expand and refactor into 3 tables Add make.conf, CHANGES, CONTRIBUTING.Md, UPDATING, and Tools/scripts. Refactor the FILES section of the ports reference manual into a bigger table with three sections separated by root directory. Remove preceeding article from all but "the big Kahuna", and root dirs where reasonable. Approved by: re (cperciva) MFC after: 3 days Relnotes: yes Reported by: adamw, arrowd, linimon Differential Revision: https://reviews.freebsd.org/D55441 (cherry picked from commit 28deec9b7e2b08b00160eb39de84ade6f27eb125) (cherry picked from commit aa519edfe50a65db516e62752914cb6922b3227f) --- share/man/man7/ports.7 | 47 +++++++++++++++++++++++++++++------------------ 1 file changed, 29 insertions(+), 18 deletions(-) diff --git a/share/man/man7/ports.7 b/share/man/man7/ports.7 index 6e28f85da964..f187a1d8c1ce 100644 --- a/share/man/man7/ports.7 +++ b/share/man/man7/ports.7 @@ -25,7 +25,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd February 21, 2026 +.Dd February 24, 2026 .Dt PORTS 7 .Os .Sh NAME @@ -596,30 +596,41 @@ Which directory to use for the data. .El .Sh FILES -.Bl -tag -width "/usr/ports/Mk/bsd.port.mk" -compact -.It Pa /usr/ports/ -The default ports directory. -.It Pa /usr/ports/Mk/bsd.port.mk -The big Kahuna. -.It Pa /var/db/ports/ -The directory where the results of configuring -.Va OPTIONS -are stored. +.Bl -tag -width "ports/CONTRIBUTING.md" -compact +.It Pa ports/CHANGES +BREAKING NEWS to read before creating ports! +.It Pa ports/CONTRIBUTING.md +Instructions for contributing to the ports tree. +.It Pa ports/Mk/bsd.port.mk +The inner workings of the ports framework. +.It Pa ports/Tools/scripts/ +Grab bag of tools for maintaining ports. +.It Pa ports/UPDATING +BREAKING NEWS to read before upgrading ports! +.It Pa ports/distfiles/ +Directory where fetched files are stored. +.Pp .It Pa ${PORT}/Makefile -The specification for building the port. -.It Pa ${PORT}/distfiles -The directory where fetched files are stored. +Specification for building the port. .It Pa ${PORT}/distinfo -The checksums generated with +Checksums generated with .Ql make makesum . .It Pa ${PORT}/files/ -The directory for any patches. +Directory for patches or any additional files. .It Pa ${PORT}/pkg-descr -The long description of the port. +Long description of the port. .It Pa ${PORT}/pkg-plist -The list of all files installed by the port. -.It Pa ${PORT}/work +List of all files installed by the port. +.It Pa ${PORT}/work/ The port's building and staging directory. +.Pp +.It Pa /etc/make.conf +Settings for the port-building framework. +.It Pa /usr/ports/ +Canonical ports tree location. +.It Pa /var/db/ports/ +Directory for storing configured +.Va OPTIONS . .El .Sh EXAMPLES .Bl -tag -width 0n