git: 1af729223f - main - [phb][Uses]: Add missing Uses=angr

The branch main has been updated by fernape:

URL: https://cgit.FreeBSD.org/doc/commit/?id=1af729223f944de80710d638d2fc714120643ccc

commit 1af729223f944de80710d638d2fc714120643ccc
Author:     Fernando Apesteguía <fernape@FreeBSD.org>
AuthorDate: 2025-02-21 16:41:43 +0000
Commit:     Fernando Apesteguía <fernape@FreeBSD.org>
CommitDate: 2025-02-21 16:41:43 +0000

    [phb][Uses]: Add missing Uses=angr
---
 .../en/books/porters-handbook/uses/_index.adoc     | 24 ++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc
index 2e4c2b13e4..a174d5a48f 100644
--- a/documentation/content/en/books/porters-handbook/uses/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc
@@ -115,6 +115,30 @@ Possible arguments: (none), `6`, `12`, `(run)`
 Depends on an Ada-capable compiler, and sets `CC` accordingly.
 Defaults to use `gcc6-aux` from ports.
 
+[[uses-angr]]
+== `angr`
+
+Possible arguments: `binaries`, `nose`
+
+Provide support for ports that need the https://github.com/angr/angr[angrinary analysis platform].
+
+If the `binaries` argument is present, the port requires the special `angr`
+binaries for testing.
+
+If the `nose` argument is present, the port uses `nosetests` for the test
+target. This argument implies `USES=python:test`.
+
+The framework provides the following variables to be set by the port:
+
+`ANGR_VERSION`::
+The version of the `angr` project programs.
+
+`ANGR_BINARIES_TAGNAME`::
+The tagname of the `angr` binaries.
+
+`ANGR_NOSETESTS`::
+The path to the `nosetests` program.
+
 [[uses-autoreconf]]
 == `autoreconf`