Date: Thu, 06 Aug 2026 22:31:34 +0000 From: Alexander Ziaee <ziaee@FreeBSD.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org Subject: git: d2d03e485bd2 - stable/14 - accf_*.9: Rewrite broken synopsis Message-ID: <6a750b46.1fd3a.59546ad1@gitrepo.freebsd.org>
index | next in thread | raw e-mail
The branch stable/14 has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=d2d03e485bd2a50881188eee249145d86993b75a commit d2d03e485bd2a50881188eee249145d86993b75a Author: Alexander Ziaee <ziaee@FreeBSD.org> AuthorDate: 2026-02-07 21:54:59 +0000 Commit: Alexander Ziaee <ziaee@FreeBSD.org> CommitDate: 2026-08-06 22:20:24 +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 (cherry picked from commit c59f12da11d75502b16f9163edc76514007462db) --- 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 f48894807312..e19b540f21f5 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 requests arrive" .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 331ea2aa4fb8..cdc025c24da6 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 requests arrive" .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 2home | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?6a750b46.1fd3a.59546ad1>