git: c59f12da11d7 - main - accf_*.9: Rewrite broken synopsis

From: Alexander Ziaee <ziaee_at_FreeBSD.org>
Date: Sat, 07 Feb 2026 22:08:45 UTC
The branch main has been updated by ziaee:

URL: https://cgit.FreeBSD.org/src/commit/?id=c59f12da11d75502b16f9163edc76514007462db

commit c59f12da11d75502b16f9163edc76514007462db
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-02-07 21:54:59 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-02-07 21:54:59 +0000

    accf_*.9: Rewrite broken synopsis
    
    These manuals abused the name macro for every line of kernel cfg as well
    as an example command to show the module name which was mixed in without
    separation. This bugs the whatis database into thinking that `INET` and
    `kldload` are names for this page, and violates best practice by mixing
    commands and configuration in a continuous example.
    
    Rewrite to use the kernel configuration macro, Cd, and show the module
    name via an example configuration in rc.conf, according to the spec and
    established practice. Do not bump the date because these markup errors
    are not a content change.
    
    MFC after:      3 days
---
 share/man/man9/accf_data.9 | 9 ++++++---
 share/man/man9/accf_dns.9  | 9 ++++++---
 share/man/man9/accf_http.9 | 9 ++++++---
 share/man/man9/accf_tls.9  | 9 ++++++---
 4 files changed, 24 insertions(+), 12 deletions(-)

diff --git a/share/man/man9/accf_data.9 b/share/man/man9/accf_data.9
index 17584288b753..47d84d17aad7 100644
--- a/share/man/man9/accf_data.9
+++ b/share/man/man9/accf_data.9
@@ -30,9 +30,12 @@
 .Nm accf_data
 .Nd buffer incoming connections until data arrives
 .Sh SYNOPSIS
-.Nm options INET
-.Nm options ACCEPT_FILTER_DATA
-.Nm kldload accf_data
+.Cd options INET
+.Cd options ACCEPT_FILTER_DATA
+.Pp
+In
+.Xr rc.conf 5 :
+.Cd kld_list="accf_data"
 .Sh DESCRIPTION
 This is a filter to be placed on a socket that will be using
 .Fn accept
diff --git a/share/man/man9/accf_dns.9 b/share/man/man9/accf_dns.9
index 971dd964e530..00b7bcf1765d 100644
--- a/share/man/man9/accf_dns.9
+++ b/share/man/man9/accf_dns.9
@@ -30,9 +30,12 @@
 .Nm accf_dns
 .Nd buffer incoming DNS requests until the whole first request is present
 .Sh SYNOPSIS
-.Nm options INET
-.Nm options ACCEPT_FILTER_DNS
-.Nm kldload accf_dns
+.Cd options INET
+.Cd options ACCEPT_FILTER_DNS
+.Pp
+In
+.Xr rc.conf 5 :
+.Cd kld_list="accf_dns"
 .Sh DESCRIPTION
 This is a filter to be placed on a socket that will be using
 .Fn accept
diff --git a/share/man/man9/accf_http.9 b/share/man/man9/accf_http.9
index f71bb7811dc0..6037088f235d 100644
--- a/share/man/man9/accf_http.9
+++ b/share/man/man9/accf_http.9
@@ -30,9 +30,12 @@
 .Nm accf_http
 .Nd "buffer incoming connections until a certain complete HTTP request arrives"
 .Sh SYNOPSIS
-.Nm options INET
-.Nm options ACCEPT_FILTER_HTTP
-.Nm kldload accf_http
+.Cd options INET
+.Cd options ACCEPT_FILTER_HTTP
+.Pp
+In
+.Xr rc.conf 5 :
+.Cd kld_list="accf_http"
 .Sh DESCRIPTION
 This is a filter to be placed on a socket that will be using
 .Fn accept
diff --git a/share/man/man9/accf_tls.9 b/share/man/man9/accf_tls.9
index d4dbc299e5bb..ce73b370e5e7 100644
--- a/share/man/man9/accf_tls.9
+++ b/share/man/man9/accf_tls.9
@@ -28,9 +28,12 @@
 .Nm accf_tls
 .Nd "buffer incoming connections until a TLS handshake like request arrives"
 .Sh SYNOPSIS
-.Nm options INET
-.Nm options ACCEPT_FILTER_TLS
-.Nm kldload accf_tls
+.Cd options INET
+.Cd options ACCEPT_FILTER_TLS
+.Pp
+In
+.Xr rc.conf 5 :
+.Cd kld_list="accf_tls"
 .Sh DESCRIPTION
 This is a filter to be placed on a socket that will be using
 .Fn accept 2