From nobody Fri Jun 24 08:24:23 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 BAC53869125 for ; Fri, 24 Jun 2022 08:24:23 +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 4LTqsg4v0Tz3Dx1; Fri, 24 Jun 2022 08:24:23 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1656059063; 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=5TPbswFTdh+WVLW+UzKxHt1H8Q9WXybRdN5QQDHQZZs=; b=PcWRhebIS/DsX151b54HDf4xEl+XMVvqkFl9YP3T0SuP/sLQO8RpnbJso0KsjkSz9vFCvM Fcr24AhQJT4ub60TnFY3AlKCF/dwvUz+oYdwGfgNflj/Fp+hCyLbk4TFkru370jQTkGTbJ KKelkxLviX1ShEWR+9Oannr9T/zzkGmKXJmQTFGvM2+sOLkxWx8LPjaslSZxlJY6DXSMBJ zFT8JBE7ivJSiFAsOTksRD+ibRK2QyowaOd5qd5fJk/pqheg4RIU2GmY8+4rPakqbe757d iRzvXYVUwfa3plWolq6luXoFEUZBgj8a2eX4SlHtdllN4cqUL0MFbBl7Goyd9A== 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 7DC0B4558; Fri, 24 Jun 2022 08:24:23 +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 25O8ON3u070795; Fri, 24 Jun 2022 08:24:23 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 25O8ONMa070794; Fri, 24 Jun 2022 08:24:23 GMT (envelope-from git) Date: Fri, 24 Jun 2022 08:24:23 GMT Message-Id: <202206240824.25O8ONMa070794@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 49d3b452a0 - main - Update pkg_version reference to pkg version in comitters guide 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: 49d3b452a0945e3c11ff94cb55308d1f43773519 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1656059063; 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=5TPbswFTdh+WVLW+UzKxHt1H8Q9WXybRdN5QQDHQZZs=; b=JRICh0e3DyY/DxUT5OdxbSVE12lB6YBv0Ymo0Q/NLDfldSReyOSyYbPDe6AfbijtU+C3hp uHZhuyIWfMwFyxqgmTdNy/9WSTElujMEBO9Pdqqmmo6MOzJ+JHERMCjmJ3yXoInPGsT3pF ocmFlNvvyj51nSeV+1JjqN4VMjYI7jQIAJK3fui5go0fCUVO/+O86nTT2L7sPtli23DF3D xj2XODWemSJYBQnWxHkQZvJNIRNVNLn/GMTdH4imkZd9xbEZzIeeqA/wrLueN7UxbFBS6U gcbsfSufMMRUXsGF5AHXA9hFhgosl8Eopu2ITSgU9gVTkK3AgNmuDoupqkoZ3g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1656059063; a=rsa-sha256; cv=none; b=KvnkKqIs0+83yRc953ak+7WQzAvaAg42Q0jcc2JMwY2aY0C45YIbgR7lqUUvWdIGpU7Bxc z2gLbJo2QrtOgTKSMnrw2KYdoG4E3UbFSm93qPKlbfxgd5+MTKc+B9mWcbt6EG3qjD6qHG 5/KoXYLjdltuEdX1mgDZwnFEkeIIAAZujFOZlWzXxn9L8c+8eaS5MYECBbTzGLAkp/rUG3 CcXMf+ssvDS4po62rsngSiz2tVhKW9WSqFhNEEFp8Lb+k466HL8HOzMGmlvodXpQeWpNcg LGaboVnMwHaMRN9V0CvV19bUfX+23S0J7uIxbD86Dn7+zjndcjui6WtiDCqLMg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=49d3b452a0945e3c11ff94cb55308d1f43773519 commit 49d3b452a0945e3c11ff94cb55308d1f43773519 Author: Pau Amma AuthorDate: 2022-06-24 08:23:17 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2022-06-24 08:23:17 +0000 Update pkg_version reference to pkg version in comitters guide Approved by: carlavilla@, bapt@ Differential Revision: https://reviews.freebsd.org/D35273 --- documentation/content/en/articles/committers-guide/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index 517ecee405..6a4009aa76 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -3889,7 +3889,7 @@ To do this, you will need to: . If you want to be really thorough, now might be a good time to run man:portlint[1]. ====== + -. Check that the ``PKGORIGIN``s are correct. The ports system uses each port's `CATEGORIES` entry to create its `PKGORIGIN`, which is used to connect installed packages to the port directory they were built from. If this entry is wrong, common port tools like man:pkg_version[1] and man:portupgrade[1] fail. +. Check that the ``PKGORIGIN``s are correct. The ports system uses each port's `CATEGORIES` entry to create its `PKGORIGIN`, which is used to connect installed packages to the port directory they were built from. If this entry is wrong, common port tools like man:pkg-version[8] and man:portupgrade[1] fail. + To do this, use the [.filename]#chkorigin.sh# tool: `env PORTSDIR=/path/to/ports sh -e /path/to/ports/Tools/scripts/chkorigin.sh`. This will check every port in the ports tree, even those not connected to the build, so you can run it directly after the move operation. Hint: do not forget to look at the ``PKGORIGIN``s of any slave ports of the ports you just moved! . On your own local system, test the proposed changes: first, comment out the SUBDIR entries in the old ports' categories' [.filename]##Makefile##s; then enable building the new category in [.filename]#ports/Makefile#. Run make checksubdirs in the affected category directories to check the SUBDIR entries. Next, in the [.filename]#ports/# directory, run make index. This can take over 40 minutes on even modern systems; however, it is a necessary step to prevent problems for other people.