From nobody Thu Dec 08 17:23:47 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 4NSgx01czCz4k0FQ for ; Thu, 8 Dec 2022 17:23:48 +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 4NSgx017zKz47p9; Thu, 8 Dec 2022 17:23:48 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1670520228; 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=HjgsnobmCd94ouhen99igMPgRDTlT66ObLXJr20eRQg=; b=oK4odwlq8TkxweJ/nXqK6ghDRPTDZ4dTnr6F846Dt4+ZrRvhfVbo+XuwoxUzEp0ak9CEzP 5trZQlc+uFgq6UVLZHiyXpVjmeAm6jUkwMc6WUmsFS1qG2uvtoRLhUmFpgzkKR5vbt3lXu 4IkPEf4DHOCqcRzoKzn3ulGY70HFFzDv12Op78wU5Fdtw9Pt3P74HXmtDxblGdFZNZgJlf c8qco1F5hgIYcc/zikmUdf+fWYoKLhP3NYXxMNqPmK6h6o0okRDUYIr+/bhtuRoHik3sAn MUtVVAMpM6ON1QGnA6Pbod02LMaa7Sp2M9PKxgQDLgsWgoaQIrUfgBw1tTgRlg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1670520228; 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=HjgsnobmCd94ouhen99igMPgRDTlT66ObLXJr20eRQg=; b=AQBwpWgo8tBIeFaA5P1aSXWEryirGaXtEgVO8acO9xVKEiJt2Nqd/j2PQpUsOma9eHqyO0 gh18EooIRwudDPEcCrzkErltB/cuZR0WgXA3mK91KAMz19BP5ErJ75VnRKpJqqjWm2HHHH qbNLSAsrxLGFRaoTuGYyTR2nNyxjuym5uRKt3qxd5cYAFkCuwjNIWvNH5xhipwVlEychVT bMfPVqXHK99fY2AzRdgwu0A6gpSwyTaI9sBMe38JPaG9rgh+1wSTGR/FE2a7ypYZWnNE70 TK0lNtPn62YZebqg2w/jC81H40VsEZKe1hP3tf6jMf0PirlhsEVtgwIESO5+Ew== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1670520228; a=rsa-sha256; cv=none; b=VytZYbX+9lMdYd7PR+zr1ABGIYwUNMcwGC1w2lhWYU2GzOO28p3qQB3DR2ZMPUkDQ78G1i fzsHmwGIcoXBTEUPFoa5e3hL0DJI1K9OU38c9NRiG9L3VK2Wbbl7haUFbybWQgPkPZC3P4 5CmnFuH0vaA5zSjKE1+dFlD3m5uDS2jGkofQu182NCwBGfzQsR1lO5JjP/alfpyCnuH4dV 3mG4tPROJSpzfnrkXhDYfUWlJb7Gf40mRap5jfni/EGgQ8ZqS0MQoppdSG2m9ZcXvLsMZP ZqFmaiaY5XTYNi6du+cXFxLmTktiZVGDcezbxmhYO7l4mawPYuEioEJtuG9bdA== 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 4NSgx00CQrz143Z; Thu, 8 Dec 2022 17:23:48 +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 2B8HNlqI070180; Thu, 8 Dec 2022 17:23:47 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 2B8HNlQc070179; Thu, 8 Dec 2022 17:23:47 GMT (envelope-from git) Date: Thu, 8 Dec 2022 17:23:47 GMT Message-Id: <202212081723.2B8HNlQc070179@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?Q?Fernando=20Apestegu=C3=ADa?= Subject: git: f55bb91726 - main - [phb][uses] Document erlang 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: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: f55bb91726b6ad07362bf8aedb6a3aa9d62bd41f Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=f55bb91726b6ad07362bf8aedb6a3aa9d62bd41f commit f55bb91726b6ad07362bf8aedb6a3aa9d62bd41f Author: Fernando Apesteguía AuthorDate: 2022-12-01 07:09:14 +0000 Commit: Fernando Apesteguía CommitDate: 2022-12-08 17:12:40 +0000 [phb][uses] Document erlang Document erlang facilities in the ports framework. Reviewers: dch@, olgeni@ Differential Revision: https://reviews.freebsd.org/D37578 --- .../en/books/porters-handbook/uses/_index.adoc | 23 ++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc index dad36f57b2..cfa218a8b9 100644 --- a/documentation/content/en/books/porters-handbook/uses/_index.adoc +++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc @@ -425,6 +425,29 @@ ELF_FEATURES= featurelist:path/to/file1 \ The format of `featurelist` is described in man:elfctl[1]. The file paths are relative to ${BUILD_WRKSRC}. +[[uses-erlang]] +== `erlang` + +Possible arguments: (none), `enc`, `rebar`, `rebar3` + +Adds a build and run time dependency on package:lang/erlang[]. +Depending on the argument, it adds additional build dependencies. `enc` adds a +dependency on package:devel/erlang-native-compiler[], `rebar` adds a dependency on +package:devel/rebar[] and `rebar3` adds a dependency on package:devel/rebar3[]. + +In addition, the following variables are available to the port: + +* `ERL_APP_NAME`: Erlang app name as installed in Erlang's lib dir (minus version) +* `ERL_APP_ROOT`: Root directory for this Erlang app +* `REBAR_CMD`: Path to the "rebar" command +* `REBAR3_CMD`: Path to the "rebar3" command +* `REBAR_PROFILE`: Rebar profile +* `REBAR_TARGETS`: Rebar target list (usually compile, maybe escriptize) +* `ERL_BUILD_NAME`: Build name for rebar3 +* `ERL_BUILD_DEPS`: List of BUILD_DEPENDS in category/portname format +* `ERL_RUN_DEPS`: List of RUN_DEPENDS in category/portname format +* `ERL_DOCS`: List of documentation files and directories + [[uses-fakeroot]] == `fakeroot`