diff --git a/share/man/man5/style.mdoc.5 b/share/man/man5/style.mdoc.5 --- a/share/man/man5/style.mdoc.5 +++ b/share/man/man5/style.mdoc.5 @@ -160,7 +160,7 @@ \&.El .Ed .El -.Ss Synopsis Formatting +.Ss SYNOPSIS Section .Bl -dash -width "" .It Do not put whitespace between alternative parameters separated with a pipe @@ -226,6 +226,27 @@ are not stylized as they do not belong to the syntax of the .Fl -meet flag. +.It +SYNOPSIS sections may contain all kinds of relevant information +other than utility invocation syntax, function call syntax, +or device configuration. +For example, +.Xr rc.conf 5 +variables, sysctls, and loader tunables can be listed as well, e.g.: +.Bd -literal -offset indent +\&.Cd "options EXAMPLE" +\&.Pp +\&In +\&.Xr rc.conf 5 : +\&.Cd example_enable="YES" +\&.Pp +\&In +\&.Xr loader.conf 5 +\&or +\&.Xr sysctl.conf 5 : +\&.Cd kern.example.%d.config +\&.Cd kern.example.debugflags +.Ed .El .Ss Quoting .Bl -dash -width ""