From nobody Wed Nov 23 11:48:14 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 4NHKBk6PYzz4jRsl for ; Wed, 23 Nov 2022 11:48:14 +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 4NHKBk5rJFz4RnF; Wed, 23 Nov 2022 11:48:14 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1669204094; 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=xpiYSgMlgh7I0CGeKpkrkWB0Dbymy19FSw7L836EPe4=; b=YZMF/VwRzclAtDtKT84N5K8lWZLI9z+6aZqI02SKYULZxnPBF10NY7nFJcBop0gly4b55N VnRFS5ly1omKuzR63776iwDkAW4X/qXW7y8cc1ZGLmB8dNNCv5vkzCCRDWeZEKnslw/eIe QYcAk6dyAj7+lCJE9nuhbbSv4zFmyq+TOu2OuFUsPnn+fS5eAZfj40RSXxhuxAsGk746QN SPhkBKGqfpzgZpBPP1A2vneNfSrvabp1ysctuMgEWd4aMNGBl7NhcocNgapUtzqnLV87xA qh8D+22D8lg56rb6m2HLM7ciBoiToXytZjMtYd5K82Fx2Amz1xxjFnkUWibr/Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1669204094; 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=xpiYSgMlgh7I0CGeKpkrkWB0Dbymy19FSw7L836EPe4=; b=QQ2W7lWwiyGGpJvN5bsmBItmf3c1ehuLavct205ORnwzWde2ao8fkVp1/czJF9jBFvK8cr Tww++/xUWzQWogcbwPWdAeB13CTt2vDE923Dl54t/15YzNHUZHaeZAJL+zDQCgJSRph9xE sPgtTUbyK5lHzlaqf3IjMAMi8yDtchJUo+tAHE5wisUMGuChMKP/eB/LuSgaDRWEm3jVgo U4/Zf3/UHI+VQbjrEwsW+WlS01j+4yiJDQ3TkGizlQq+z/UF+36aUjrkhw5PCwIBCALQT1 5TKSN046P+/k5TT/YpzRveecWGrICbaVnGVZj532UkkYHR90dIOQfECwr/5+zQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1669204094; a=rsa-sha256; cv=none; b=kBT058DY+nKtn850izfRRIaxFEnuQXmKqV6UMySOrwu1SkuwG1q36yPGig7jBga9k3TjB1 m7GQafZHVZ9oTTGBrpMOwhvKXWrFUyJsEP2ubB3lBmh+NmvPvoox+ALKHLITXLWjn4NDd9 g/A2EBqJXgjeHyNwv+/i2y8Mvs2OSpEQcJudqChYlG23eMdhjknKAKVimffF0c62FNfR/d yPlIURNTQBzO93OW4e3SljIIsLzfPr+2M/JcbYr2i/g+y1qiLhXVIpj1W88lZpo07RhrXv +V9riRDegR1IkOWdloEdqxe6npF9ybD0zv44FWnvpWvJqwcAWX1NXALgjutO5A== 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 4NHKBk4gjYzLnW; Wed, 23 Nov 2022 11:48:14 +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 2ANBmEp1085933; Wed, 23 Nov 2022 11:48:14 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 2ANBmEhh085932; Wed, 23 Nov 2022 11:48:14 GMT (envelope-from git) Date: Wed, 23 Nov 2022 11:48:14 GMT Message-Id: <202211231148.2ANBmEhh085932@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Gleb Popov Subject: git: ef23f41eb5 - main - porter-handbook: Document recently added CABAL_REVISION knob. 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: arrowd X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: ef23f41eb565c84fc675bc9dbf1810e51c616799 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by arrowd (ports committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=ef23f41eb565c84fc675bc9dbf1810e51c616799 commit ef23f41eb565c84fc675bc9dbf1810e51c616799 Author: Gleb Popov AuthorDate: 2022-11-23 08:43:07 +0000 Commit: Gleb Popov CommitDate: 2022-11-23 11:48:05 +0000 porter-handbook: Document recently added CABAL_REVISION knob. Reviewed By: #docs, fernape Differential Revision: https://reviews.freebsd.org/D37474 --- documentation/content/en/books/porters-handbook/uses/_index.adoc | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc index 3a05b70c57..dad36f57b2 100644 --- a/documentation/content/en/books/porters-handbook/uses/_index.adoc +++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc @@ -199,10 +199,14 @@ This argument is implicitly added if `USE_GITHUB` or `USE_GITLAB` is present. The framework provides the following variables: +`CABAL_REVISION`:: +Haskell packages hosted on Hackage may have revisions. +Set this knob to an integer number to pull in revised package description. + `USE_CABAL`:: If the software uses Haskell dependencies, list them in this variable. Each item should be present on Hackage and be listed in form `packagename-_0.1.2_`. -Dependencies can have revisions, which are specified after the `_` symbol. +Dependencies can have revisions too, which are specified after the `_` symbol. Automatic generation of the dependency list is supported, see crossref:special[using-cabal,Building Haskell Applications with `cabal`]. `CABAL_FLAGS`::