git: b8e6a72b3c - main - [phb][Uses]: Add missing Uses=trigger

From: Fernando Apesteguía <fernape_at_FreeBSD.org>
Date: Sun, 09 Mar 2025 18:27:11 UTC
The branch main has been updated by fernape:

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

commit b8e6a72b3c84c9dcd295317101809124082d17ab
Author:     Fernando Apesteguía <fernape@FreeBSD.org>
AuthorDate: 2025-02-20 09:21:04 +0000
Commit:     Fernando Apesteguía <fernape@FreeBSD.org>
CommitDate: 2025-03-09 18:26:49 +0000

    [phb][Uses]: Add missing Uses=trigger
    
    Differential Revision: https://reviews.freebsd.org/D49074
---
 .../content/en/books/porters-handbook/uses/_index.adoc   | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc
index 4d83495605..3ac53fa9a6 100644
--- a/documentation/content/en/books/porters-handbook/uses/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc
@@ -2853,6 +2853,22 @@ Same as arguments for `tcl`
 Small wrapper when using both Tcl and Tk.
 The same variables are returned as when using Tcl.
 
+[[uses-trigger]]
+== `trigger`
+
+Possible arguments: (none)
+
+Provide support for ports requiring triggers to be executed by man:pkg[8].
+Triggers are executed at the end of a transaction if the conditions are met.
+
+The following variable can be set by ports:
+
+`TRIGGERS`::
+List of triggers to package. Defaults to `${PORTNAME}`.
+
+Triggers are specified in UCL format and are usually placed in the
+[.filename]#files/# directory of the port.
+
 [[uses-uidfix]]
 == `uidfix`