From nobody Fri Jul 10 18:06:15 2026 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 4gxfsS6pWQz6lV7w for ; Fri, 10 Jul 2026 18:06:20 +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 "YR1" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4gxfsS5tdlz3jGJ for ; Fri, 10 Jul 2026 18:06:20 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1783706780; 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=leeoa8+giRzjW7tf36qJXDA7N1kSenHAKugedOQKv9E=; b=j8zkrpvfi9/GFiuai6bZsw1KNkOGNt2rJWxQ3g85TxexXOkyuLvMvErLu8hmpz8scdI8j7 b9t/8AS94xFLGwI3FgTQmZuQxn3IkHw+NQNoZxpbwiLjqBx08Hxox3VipOj81YhP1Gu9cO nXltHIPpg4iARERb3Ko7ZMYfsFusuzGRmd0MysYQbL26j/DzXQG4bdcEdGd1zsB5yNd4kU l3TOLuBQ/U1QMWC7lUZxtOiW1TyFE2mcFWB92D51lcXuD8K63nS20NrOs00XuOTQGc1rut OK1sVCSJI1aSuJ0grBPOeOifORmS13CfDJgkbWemea7gHo7CxMZ1fwZXNGA5Nw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1783706780; a=rsa-sha256; cv=none; b=G6x48k3SBUJBIop0Caa3iBW4EK9uAfqw6HObVvk39WjiZxFA2KctCLhWvizBstPjNyGyIa /T20fTNeUNXY1XclQ9mXesaubTmQp5PEDDFJC+gciHL7XaX5+wL39/JoV3DDhf00sD+qaH TaqcCD5ny54T8BSf1zQVit925ObwfQetoq7hJMpyaJdXa/cDUcFjkXoRzpvGyhF/uvhVKx sv48+Xng284CAwPV6Ca+X1aUrJzw/wKLZrqc+ncD2BewXGuS2opLh4feLaZlm+naqwsKH+ +rpzvQVasQD3DAZCTgRNS8M9M1O7/Au/Me7LpF/OhFipF4qm9RVc9bKHZ9Nr3w== 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=1783706780; 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=leeoa8+giRzjW7tf36qJXDA7N1kSenHAKugedOQKv9E=; b=ilZvJcOG9oNpGALiaEQCjvUs6OGqh8Q1zxVp1gruvAu7YhtPZ2JZXdexNrurTz10NyRPc9 bjyQfZF3IftHLEjbqpikhAxnQlRmgsTxKr1TON94FSTx21Vhd26nJ1oGbnZXJOyZ8WJMCr Ld3629rJthOF4PJEGzPcBYTScyQwlS3fJyWCj5GvtmFx58Iquzgzcx3y5jEXyJDPC6akZ5 R4m2aYx4BZIIksyRKl8Klt83Rh4DCKKBEwwhlYq+AzLC/6E9ZK2Ny+IM9eOmjfGPiYgUBK D54P7y6Pl9SvQMkOACcIJ0nDGNB56gVGHCpzDGnLYKdBnYgPxcYS1Y5CTyrWxA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4gxfsS4tB6z15V8 for ; Fri, 10 Jul 2026 18:06:20 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 447d2 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Fri, 10 Jul 2026 18:06:15 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Fernando Apeste=?utf-8?Q?gu=C3=ADa?= Subject: git: 9bf095fffe - main - [phb][Uses]: Add npm 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 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: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 9bf095fffe66d74555595b2915f9f46d49609a13 Auto-Submitted: auto-generated Date: Fri, 10 Jul 2026 18:06:15 +0000 Message-Id: <6a513497.447d2.284270ae@gitrepo.freebsd.org> The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=9bf095fffe66d74555595b2915f9f46d49609a13 commit 9bf095fffe66d74555595b2915f9f46d49609a13 Author: Fernando Apesteguía AuthorDate: 2026-07-10 18:03:20 +0000 Commit: Fernando Apesteguía CommitDate: 2026-07-10 18:03:20 +0000 [phb][Uses]: Add npm Following https://cgit.freebsd.org/ports/commit/?id=ed6a84c1c9793271c9cf948458808b47b2622d21 --- .../en/books/porters-handbook/uses/_index.adoc | 36 ++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc index 2bc70fab43..e30285d720 100644 --- a/documentation/content/en/books/porters-handbook/uses/_index.adoc +++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc @@ -1954,6 +1954,42 @@ specified then `run` and/or `build` must be specified too. The `env` argument sets the environment variables `NODEJS_VERSION` and `NODEJS_SUFFIX`. Currently `lts` is an alias for 24 and `current` is an alias for 26. +[[uses-npm]] +== `npm` + +Possible arguments: ``, `fetch`, `extract`, `build`, `run`, `test` + +`` can take the following values: + +`npm`:: +The port uses NPM as package manager. + +`yarn1`:: +The port uses Yarn (v1) as package manager. + +`yarn2`:: +The port uses Yarn (v2 or v3) as package manager. + +`yarn4`:: +The port uses Yarn (v4+) as package manager. + +`pnpm`:: +The port uses PNPM as package manager. + +The following variables can be set by the port: + +`NPM_VER`:: +A version of node package manager the port uses. + +`NPM_PREFETCH`:: +Downloads node modules the port uses according to the pre-stored +[.filename]#package.json# (and [.filename]#package-lock.json#, +[.filename]#yarn.lock#, or [.filename]#pnpm-lock.yaml# depending +on the node package manager used) in `PKGJSONSDIR`. + +`NPM_EXTRACT`:: +Installs the prefetched node modules into the port's working source directory. + [[uses-objc]] == `objc`