git: 478a3eb82a - main - [phg][Uses]: Add Uses=postgis

From: Fernando Apesteguía <fernape_at_FreeBSD.org>
Date: Mon, 12 Oct 2026 18:07:22 UTC
The branch main has been updated by fernape:

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

commit 478a3eb82a6d47b38eb55f5c9b74a24a55ea98ce
Author:     Fernando Apesteguía <fernape@FreeBSD.org>
AuthorDate: 2026-10-05 15:04:09 +0000
Commit:     Fernando Apesteguía <fernape@FreeBSD.org>
CommitDate: 2026-10-12 18:06:51 +0000

    [phg][Uses]: Add Uses=postgis
    
    Following
    https://cgit.freebsd.org/ports/commit/Mk/Uses/postgis.mk?id=6324d2d4a8fe20ec1c76adcc5a3736e1e6926ef0
---
 .../content/en/books/porters-handbook/uses/_index.adoc        | 11 ++++++++++-
 1 file changed, 10 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 b268df6afb..4bf2e4470e 100644
--- a/documentation/content/en/books/porters-handbook/uses/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc
@@ -2249,6 +2249,16 @@ Uses package:devel/pkgconf[].
 With no arguments or with the `build` argument, it implies `pkg-config` as a build-time dependency.
 `run` implies a run-time dependency and `both` implies both run-time and build-time dependencies.
 
+[[uses-postgis]]
+== `postgis`
+
+Possible arguments: (none), `33`,`34`,`35`,`36`,`37`
+
+PostGIS version to depend on. If omitted, `POSTGIS_DEFAULT` is used.
+
+`postgis` must appear before `pgsql` in `USES` so that the PostgreSQL version
+constraint required by the selected PostGIS version is applied first.
+
 [[uses-pure]]
 == `pure`
 
@@ -2348,7 +2358,6 @@ Enable tests which are otherwise ignored by `PYTEST_BROKEN_TESTS`.
 Enable tests which are otherwise ignored by `PYTEST_IGNORED_TESTS` and
 `PYTEST_BROKEN_TESTS`.
 
-
 [[uses-python]]
 == `python`