git: afd63daac3 - main - [hb][ports]: Briefly mention kmods repositories

From: Fernando Apesteguía <fernape_at_FreeBSD.org>
Date: Thu, 31 Jul 2025 15:57:28 UTC
The branch main has been updated by fernape:

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

commit afd63daac31c57cdb117a95afa252a52a7658155
Author:     Fernando Apesteguía <fernape@FreeBSD.org>
AuthorDate: 2025-05-20 15:47:05 +0000
Commit:     Fernando Apesteguía <fernape@FreeBSD.org>
CommitDate: 2025-07-31 15:56:27 +0000

    [hb][ports]: Briefly mention kmods repositories
    
    Reviewed by:            bcr@
    Differential Revision:  https://reviews.freebsd.org/D51614
---
 .../content/en/books/handbook/ports/_index.adoc    | 46 ++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc
index ac4cf4ce70..fe7001ab82 100644
--- a/documentation/content/en/books/handbook/ports/_index.adoc
+++ b/documentation/content/en/books/handbook/ports/_index.adoc
@@ -211,6 +211,52 @@ Then run this command to update the local package repositories catalogues for th
 # pkg update -f
 ....
 
+[[kmod-repository]]
+=== Kernel modules repositories
+
+The kernel module repositories allow users to install ready to use kernel
+modules like the ones used for graphic drivers and specific hardware.
+Starting with FreeBSD 14.3, the FreeBSD Project provides kernel modules built
+for every supported version. To create such a repository configuration if it
+does not exist, add the following to [.filename]#/usr/local/etc/pkg/repos/kmods.conf#:
+[source,shell]
+....
+FreeBSD-kmods: {
+        url: "pkg+https://pkg.FreeBSD.org/${ABI}/KMODSFLAVOR",
+        mirror_type: "srv",
+        signature_type: "fingerprints",
+        fingerprints: "/usr/share/keys/pkg",
+        enabled: yes
+}
+....
+
+`KMODSFLAVOR` respects the following pattern: `kmods_PORTBRANCH_MINORRELEASE`.
+
+For instance:
+
+.Kmodsflavor
+
+[options="header", cols="1,1,1"]
+|===
+| FreeBSD Release | ports main | ports quarterly
+
+| FreeBSD 14.2-RELEASE
+| kmods_latest_2
+| kmods_quarterly_2
+
+| FreeBSD 14.3-RELEASE
+| kmods_latest_3
+| kmods_quarterly_3
+
+| FreeBSD 14.3-STABLE
+| kmods_latest
+| kmods_quarterly
+
+| FreeBSD 15.0-CURRENT
+| kmods_latest
+| 
+|===
+
 [[pkg-configuration]]
 === Configure pkg