git: 90ff6adf96 - main - [phb]: Document Uses=cl

The branch main has been updated by fernape:

URL: https://cgit.FreeBSD.org/doc/commit/?id=90ff6adf9629d32132150f2e1ffc8db4ff858f8e

commit 90ff6adf9629d32132150f2e1ffc8db4ff858f8e
Author:     Fernando Apesteguía <[email protected]>
AuthorDate: 2025-01-05 16:46:58 +0000
Commit:     Fernando Apesteguía <[email protected]>
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-<FASL_TARGET>`
+
+`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`