Index | Thread | Search

From:
Klemens Nanni <kn@openbsd.org>
Subject:
httpd.conf.5: tag [no] options for usual discoverability
To:
OpenBSD tech <tech@openbsd.org>
Date:
Sun, 27 Sep 2026 00:55:03 +0000

Download raw body.

Thread
$ man httpd.conf | col -b | fgrep '[no]'
     [no] authenticate [realm] with htpasswd
     [no] banner
     [no] static-cache-control
	     [no] auto index
     [no] errdocs directory
     [no] fastcgi [option]
     [no] log [option]
	     [no] syslog
	     [no] rewrite path
	     [no] nodelay
	     [no] sack

None of these are reachable by tags, e.g. ":t log" does not jump
to the "log" keyword's definition because auf how auto-tagging
works, see `man -Otag=Tg mdoc' for that.

Sprinkle manual tags as advised to be able to navigate to all
these keywords in the manual pager.


Feedback? OK?

Index: httpd.conf.5
===================================================================
RCS file: /cvs/src/usr.sbin/httpd/httpd.conf.5,v
diff -u -p -r1.135 httpd.conf.5
--- httpd.conf.5	25 Jul 2026 05:48:39 -0000	1.135
+++ httpd.conf.5	27 Sep 2026 00:32:26 -0000
@@ -171,6 +171,7 @@ If not specified, it defaults to
 within the
 .Xr chroot 2
 directory.
+.Tg banner
 .It Ic no banner
 Do not send the
 .Va Server
@@ -229,6 +230,7 @@ the
 using pattern matching instead of shell globbing rules,
 see
 .Xr patterns 7 .
+.Tg authenticate
 .It Oo Ic no Oc Ic authenticate Oo Ar realm Oc Ic with Pa htpasswd
 Authenticate a remote user for
 .Ar realm
@@ -240,6 +242,7 @@ and must be readable by the www user.
 Use the
 .Ic no authenticate
 directive to disable authentication in a location.
+.Tg banner
 .It Oo Ic no Oc Ic banner
 When prefixed with the
 .Ic no
@@ -254,6 +257,7 @@ If
 is omitted, enable the banner for the current
 .Ic server
 if it was disabled globally.
+.Tg static-cache-control
 .It Oo Ic no Oc Ic static-cache-control
 Send
 .Dq Cache-Control: no-cache
@@ -350,6 +354,7 @@ Set the specified options when serving o
 Multiple options may be specified within curly braces.
 Valid options are:
 .Bl -tag -width Ds
+.Tg auto
 .It Oo Ic no Oc Ic auto index
 If no index file is found, automatically generate a directory listing.
 This is disabled by default.
@@ -362,12 +367,14 @@ Disable the directory index.
 .Xr httpd 8
 will neither display nor generate a directory index.
 .El
+.Tg errdocs
 .It Oo Ic no Oc Ic errdocs Ar directory
 Overrides or, if the
 .Ic no
 keyword is given, disables globally defined custom error documents for the
 current
 .Ic server .
+.Tg fastcgi
 .It Oo Ic no Oc Ic fastcgi Oo Ar option Oc
 Enable FastCGI instead of serving files.
 Multiple options may be specified within curly braces.
@@ -596,6 +603,7 @@ The pattern may contain captures that ca
 or
 .Ic request rewrite
 option.
+.Tg log
 .It Oo Ic no Oc Ic log Op Ar option
 Set the specified logging options.
 Logging is enabled by default using the standard
@@ -654,6 +662,7 @@ similar to the format that is used by
 .Xr relayd 8 .
 If not specified, the default is
 .Cm common .
+.Tg syslog
 .It Oo Ic no Oc Ic syslog
 Enable or disable logging to
 .Xr syslog 3
@@ -668,6 +677,7 @@ Configure the options for the request pa
 Multiple options may be specified within curly braces.
 Valid options are:
 .Bl -tag -width Ds
+.Tg rewrite
 .It Oo Ic no Oc Ic rewrite Ar path
 Enable or disable rewriting of the request.
 Unlike the redirection with
@@ -720,9 +730,11 @@ Generalized TTL Security Mechanism (GTSM
 according to RFC 5082.
 .It Ic ip ttl Ar number
 Change the default time-to-live value in the IP headers.
+.Tg nodelay
 .It Oo Ic no Oc Ic nodelay
 Enable the TCP NODELAY option for this connection.
 This is recommended to avoid delays in the data stream.
+.Tg sack
 .It Oo Ic no Oc Ic sack
 Use selective acknowledgements for this connection.
 .It Ic socket buffer Ar number