From nobody Sun Dec 18 08:38:37 2022 X-Original-To: dev-commits-ports-main@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 4NZbpQ1sn6z1Gv0q; Sun, 18 Dec 2022 08:38:38 +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 4NZbpQ0qR6z3DTT; Sun, 18 Dec 2022 08:38:38 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1671352718; 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=LgTA5oK0p+ul/C6g2BpXLYDNP5T4Lu9VyavB5xQww70=; b=XH029rkJlKCae6wDKyx7cTOYBAGJNnyNO7dtTg1IZdpFaDoUdlAfb/fUq+cPFujsR2FDSX zXIH0r8ZhpB5MOzU2vczcrc+b1srbNXfoPyaNvUPNvnmu8jonNrEhOw9fVjsBgCapUyej4 KPVzXD9/piCL2yVnFQQ9JtOaGkmYc27Jkz7wMKF5gsKZ/aD8fScnrwbdqcwaUElvU0if3o j4dx5hmSf6pZLMNGh2r4zF7X7bXB3WM/xJ7yLW4AXYwKdrF8uWnqVZ2v3znQOiug9vHBMF 6wRKib62IAZBvbpxhtdBbz00vOZEEEFvA3rgXqT1NQcyqo5CCDcYRPOSuR90Hg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1671352718; 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=LgTA5oK0p+ul/C6g2BpXLYDNP5T4Lu9VyavB5xQww70=; b=THUgx6RkzQl/j2ghXGZCp9jUVioUNhkhXa+Zu0NSZdCnC3IX/5culoI0Qhidbpj8PMrm+9 nD8Sk0JXFQNc+afW77EzMs7NH0MjYyWxBON360WKbUoL/ENk3A69GR4kG7F2g2pwiengZd Vlj1nWp2eJTDpJjXJFbuH5UdXWDw0iwgLkNsXy9874mE1C9EV8l7vLbiugE8Q8iuGxQuHr TQIj902SEaUx8YLjFfAW5nzfkV2Qo9QOZGATWRMsW/yzox1jyEszZK3hZCMGjO36CbqHfw rE0MUcOZe725l3KjeTsUqhSYSQtMekSOoP5OcNgHohTZLE3I6RwKiMVC7HXi+w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1671352718; a=rsa-sha256; cv=none; b=jxs5BqyJqEvfl59NZ1Z5AlQViLRUOr/8JVjy8ltUm9XtMG/YO0ZtzOoJyWFfk3jrNwT8LD FLkJiQXSMVoDWtyKCpe7glZoEivtGm3jNBN/LmqBM42tk/udmmbpGe9t+TsrnCkkUxXYJQ kn2TO9ok12772dscbQQlcb3ADY9gUvfYg0eonXXAV5c7m+pT2YLMhQNM68DEMMBSEnK8fI 0o4FQ3bF9/k1qvBsXokxxCtFGu1FSIiEtre1Dq5x7vIOiAgMBPeVGQfjd9yvT2USJVyUDk pzNOC0Ir56h7sPWlTBcmg/9jMHoOTHrPX9Iz2lEVDwQhn9QWRPEdyx6v9QrjSQ== 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 4NZbpP71Wjz1NZW; Sun, 18 Dec 2022 08:38:37 +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 2BI8cbJE018447; Sun, 18 Dec 2022 08:38:37 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 2BI8cbWY018446; Sun, 18 Dec 2022 08:38:37 GMT (envelope-from git) Date: Sun, 18 Dec 2022 08:38:37 GMT Message-Id: <202212180838.2BI8cbWY018446@gitrepo.freebsd.org> To: ports-committers@FreeBSD.org, dev-commits-ports-all@FreeBSD.org, dev-commits-ports-main@FreeBSD.org From: "Tobias C. Berner" Subject: git: 48eb5a86c10a - main - framework: improve llvm.mk documentation List-Id: Commits to the main branch of the FreeBSD ports repository List-Archive: https://lists.freebsd.org/archives/dev-commits-ports-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-ports-main@freebsd.org X-BeenThere: dev-commits-ports-main@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: tcberner X-Git-Repository: ports X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 48eb5a86c10ac70ffe3be4d54f59d64f5bcae6c3 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by tcberner: URL: https://cgit.FreeBSD.org/ports/commit/?id=48eb5a86c10ac70ffe3be4d54f59d64f5bcae6c3 commit 48eb5a86c10ac70ffe3be4d54f59d64f5bcae6c3 Author: Tobias C. Berner AuthorDate: 2022-12-18 08:34:05 +0000 Commit: Tobias C. Berner CommitDate: 2022-12-18 08:38:06 +0000 framework: improve llvm.mk documentation Previously it contained a copy-and-pasted unedited line for step 3). Switch to the better documentation copied from CHANGES. Reported by: arrowd --- Mk/Uses/llvm.mk | 40 ++++++++++++++++++++++++++++------------ 1 file changed, 28 insertions(+), 12 deletions(-) diff --git a/Mk/Uses/llvm.mk b/Mk/Uses/llvm.mk index 6fa1f60c5d41..2cae756fd280 100644 --- a/Mk/Uses/llvm.mk +++ b/Mk/Uses/llvm.mk @@ -1,17 +1,33 @@ # Provides support to depend on LLVM # -# It chooses the llvm port to be used based on the following constraint: -# 1) no constraints given => ${LLVM_DEFAULT} -# 2) exact constraint given => ${exact} -# 2) max constraint given && ${max} < ${LLVM_DEFAULT} => ${max} -# 3) min constraint given && ${LLVM_DEFAULT} < ${LLVM_DEFAULT} => ${LLVM_DEFAULT} - -# Usage: -# USES= llvm - default version chosen -# USES= llvm:15 - exact constraint -# USES= llvm:min=9 - min constraint: max(min,default) -# USES= llvm:max=10 - max constraint: min(max,default) -# USES= llvm:min=10,max=11 - all constraint: max(min(max,default),default) +# USES=llvm supports two kinds of arguments: +# +# * mode +# : defaults to build +# build: add a BUILD_DEPENDS on chosen llvm-port +# run: add a RUN_DEPENDS on chosen llvm-port +# lib: add a LIB_DEPENDS on chosen llvm-port +# +# * version +# : defaults to ${LLVM_DEFAULT} +# number: use explicitly the specified version +# min=number: use specified min if ${LLVM_DEFAULT} is lower +# max=number: use specified max if ${LLVM_DEFAULT} is higher +# +# An example usage might be: +# USES= llvm +# or +# USES= llvm:13,build +# or +# USES= llvm:min=14,lib +# +# The following variables are exposed to be used in the ports tree at the moment: +# * LLVM_VERSION version chosen from the arguments to llvm.mk +# * LLVM_PORT chosen llvm port +# * LLVM_CONFIG llvm-config of the chosen port +# * LLVM_LIBLLVM libLLVM.so of the chosen port +# * LLVM_PREFIX installation prefix of the chosen port +# .if !defined(_INCLUDE_USES_LLVM_MK) _INCLUDE_USES_LLVM_MK= YES