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
This commit is contained in:
Alexander Ziaee
2026-02-07 16:54:59 -05:00
parent 525d00dcf4
commit c59f12da11
4 changed files with 24 additions and 12 deletions
+6 -3
View File
@@ -30,9 +30,12 @@
.Nm accf_data .Nm accf_data
.Nd buffer incoming connections until data arrives .Nd buffer incoming connections until data arrives
.Sh SYNOPSIS .Sh SYNOPSIS
.Nm options INET .Cd options INET
.Nm options ACCEPT_FILTER_DATA .Cd options ACCEPT_FILTER_DATA
.Nm kldload accf_data .Pp
In
.Xr rc.conf 5 :
.Cd kld_list="accf_data"
.Sh DESCRIPTION .Sh DESCRIPTION
This is a filter to be placed on a socket that will be using This is a filter to be placed on a socket that will be using
.Fn accept .Fn accept
+6 -3
View File
@@ -30,9 +30,12 @@
.Nm accf_dns .Nm accf_dns
.Nd buffer incoming DNS requests until the whole first request is present .Nd buffer incoming DNS requests until the whole first request is present
.Sh SYNOPSIS .Sh SYNOPSIS
.Nm options INET .Cd options INET
.Nm options ACCEPT_FILTER_DNS .Cd options ACCEPT_FILTER_DNS
.Nm kldload accf_dns .Pp
In
.Xr rc.conf 5 :
.Cd kld_list="accf_dns"
.Sh DESCRIPTION .Sh DESCRIPTION
This is a filter to be placed on a socket that will be using This is a filter to be placed on a socket that will be using
.Fn accept .Fn accept
+6 -3
View File
@@ -30,9 +30,12 @@
.Nm accf_http .Nm accf_http
.Nd "buffer incoming connections until a certain complete HTTP request arrives" .Nd "buffer incoming connections until a certain complete HTTP request arrives"
.Sh SYNOPSIS .Sh SYNOPSIS
.Nm options INET .Cd options INET
.Nm options ACCEPT_FILTER_HTTP .Cd options ACCEPT_FILTER_HTTP
.Nm kldload accf_http .Pp
In
.Xr rc.conf 5 :
.Cd kld_list="accf_http"
.Sh DESCRIPTION .Sh DESCRIPTION
This is a filter to be placed on a socket that will be using This is a filter to be placed on a socket that will be using
.Fn accept .Fn accept
+6 -3
View File
@@ -28,9 +28,12 @@
.Nm accf_tls .Nm accf_tls
.Nd "buffer incoming connections until a TLS handshake like request arrives" .Nd "buffer incoming connections until a TLS handshake like request arrives"
.Sh SYNOPSIS .Sh SYNOPSIS
.Nm options INET .Cd options INET
.Nm options ACCEPT_FILTER_TLS .Cd options ACCEPT_FILTER_TLS
.Nm kldload accf_tls .Pp
In
.Xr rc.conf 5 :
.Cd kld_list="accf_tls"
.Sh DESCRIPTION .Sh DESCRIPTION
This is a filter to be placed on a socket that will be using This is a filter to be placed on a socket that will be using
.Fn accept 2 .Fn accept 2