From nobody Sun Jan 5 18:59:24 2025 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 4YR6705Yl4z5k5vB for ; Sun, 05 Jan 2025 18:59:24 +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 "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4YR6704QWwz4L4Z; Sun, 5 Jan 2025 18:59:24 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1736103564; 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=5Omca2BFTXZbgTo3K5mRBMSBDW10oEqHPHjOcXwudTM=; b=BfFg51MPB2JMy+XaD7ysgz+P1dG8nODhkDxz1R8RG8Rhn6h7FNcCFI0T5gRVpx958QGSpY gdLfQr2gDJ/mcKzrHgeCyCmy/a5TucfR/YBp5YZNuqBe/it2C/j+xK7gAtHPM6KKCUCDf2 P1WPavTzBGD6oMSGLKH1swygj08ENEv0tUourx8ckfmUjsbTP92iPC55S78dXu+L94ijzZ JDQ3Y0zLdbYISL4pwxF0XgsSPU5t2c8yVgcUy97vCwkydwfFyNpPXjviZrWwLnkHoXheus ZAeH1JrFjeBxyY/HR7VNJjNigjoyc+n5/lIoo9JIjw74bgEh69fZXC9qOyDW7A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1736103564; 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=5Omca2BFTXZbgTo3K5mRBMSBDW10oEqHPHjOcXwudTM=; b=Tsgr96XlaBeriA0mvzr25S1G/hVvZv1Lbylh4iGxtJeigh269bRqPpl8B6cluetltJiORZ DPCssIlTWh2oqOd0cfjlElt1qVn0s071pN79Zkdw2DuAsMauQFj9bg3zPsJwylh0NMenIx BC6EPtNjFh2hjbYnj4YOlJUDv9ksK4taU9UoAM/UMUz8S1xZi04qEX/J3VD9CyN0Fq0zpH n7c0bQv0aPCoLnOVRb3dKsTTc6h0G5aLU1Qekko3PUXa5WNfI5/xT3mxYSPsGJLd+Ro3M7 x8NtNeKk0gpYdMw6bLtjR4IZGk7XeXbSGoDLA1DWI9dzsblQ10LEO1ReGvGNGg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1736103564; a=rsa-sha256; cv=none; b=XL1eMarR5pQDZfw3K+6Viv2xifoR863fyd9+T4gkn/s4EE9qlDXXSdQPx/pi//75YvXCB5 fnr6RKZnR14uj+uv2mSHkT4qHmU7QR9rmuj+KJjJ1FrF8eUrR1SKZta3t9T9KdVDHC9IUa 4qyIJ9oRqEIwdHLvi93lZpmwxHVA/8dmyzEFA7JqDAbwUeE89tsQ6AXMj5x3UiR6y0Fv9O CC1BWk9evGeACv2IkwXr2zFCyiG8Lwr5CBsAq+4FmciaKWewVqbxf+L1jGvrnwQ1Vi7ScA X8uefmn02lPULl9tR9SK2K0M6IOkJUofGpliQ1dW3FQOyj5HQaBn4IlIcjecIQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4YR6703cWQzqxK; Sun, 05 Jan 2025 18:59:24 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 505IxO1C007430; Sun, 5 Jan 2025 18:59:24 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 505IxOjh007427; Sun, 5 Jan 2025 18:59:24 GMT (envelope-from git) Date: Sun, 5 Jan 2025 18:59:24 GMT Message-Id: <202501051859.505IxOjh007427@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Fernando =?utf-8?Q?Apestegu=C3=ADa?= Subject: git: 90ff6adf96 - main - [phb]: Document Uses=cl 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 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: 90ff6adf9629d32132150f2e1ffc8db4ff858f8e Auto-Submitted: auto-generated The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=90ff6adf9629d32132150f2e1ffc8db4ff858f8e commit 90ff6adf9629d32132150f2e1ffc8db4ff858f8e Author: Fernando Apesteguía AuthorDate: 2025-01-05 16:46:58 +0000 Commit: Fernando Apesteguía CommitDate: 2025-01-05 18:59:07 +0000 [phb]: Document Uses=cl --- .../en/books/porters-handbook/uses/_index.adoc | 60 ++++++++++++++++++++++ 1 file changed, 60 insertions(+) diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc index ea41b8647d..0bec4ee1a1 100644 --- a/documentation/content/en/books/porters-handbook/uses/_index.adoc +++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc @@ -282,6 +282,66 @@ Prevents the port from installing [.filename]#charset.alias#. This must be installed only by package:converters/libiconv[]. `CHARSETFIX_MAKEFILEIN` can be set to a path relative to `WRKSRC` if [.filename]#charset.alias# is not installed by [.filename]#${WRKSRC}/Makefile.in#. +[[uses-cl]] +== `cl` + +Possible arguments: (none) + +Provides support for Common Lisp ports. + +The framework provides the following variables that can be set by ports: + +`ASDF_MODULES`:: +List of `ASDF` modules to build when `FASL_TARGET` is set (defaults to `PORTNAME`) + +`FASL_TARGET`:: +Build fasl variant of port (one of `ccl`, `clisp`, or `sbcl`) + +`USE_ASDF`:: +Depend on package:devel/cl-asdf[] + +`USE_ASDF_FASL`:: +Depend on `devel/cl-asdf-` + +`USE_CCL`:: +Depend on package:lang/ccl[]; implied when `FASL_TARGET=ccl` + +`USE_CLISP`:: +Depend on package:lang/clisp[]; implied when `FASL_TARGET=clisp` + +`USE_SBCL`:: +Depend on package:lang/sbcl[]; implied when `FASL_TARGET=SBCL` + + +The framework provides the following variables that can be read by ports: + +`ASDF_PATHNAME`:: +Path to CL source + +`ASDF_REGISTRY`:: +Path to CL registry containing asd files + +`CCL`:: +Path to the Clozure Common Lisp compiler + +`CLISP`:: +Path to the GNU Common Lisp compiler + +`CL_LIBDIR_REL`:: +CL library directory relative to `LOCALBASE` or `PREFIX` + +`FASL_DIR_REL`:: +Relative path to compiled fasl files; depends on `FASL_TARGET` + +`FASL_PATHNAME`:: +Path to CL fasl + +`LISP_EXTRA_ARG`:: +Extra arguments used when building fasl + +`SBCL`:: +Path to the Steel Bank Common Lisp compiler + [[uses-cmake]] == `cmake`