style.mdoc.5: Document use of rc.conf, loader.conf, and sysctl.conf in SYNOPSIS

[0mp]

Summary

Suggested by: Alexander Ziaee

[ziaee]

Hey, thanks for doing this. Initial bikeshed:

share/man/man5/style.mdoc.5

230

This is very broad. According to mdoc(7), it's very specifically:

"Documents the utility invocation syntax, function call syntax, or *device configuration*."

So, OtherBSDs interpret "device configuration" to mean exclusively the config(8) declarations, but in FreeBSD for drivers only (afaik), we've seemingly always interpreted this to also include the files that configure devices at runtime.

236

[0mp]

share/man/man5/style.mdoc.5

230

Hey! I've read mdoc's take on this as well. I just thought that it would be nice to document what we already do. I couldn't think of a better phrase for now than "all kinds of relevant information". Perhaps we could just list what's allowed, which would be:

• config(8)
• loader.conf(5)
• sysctl.conf(5)
• rc.conf(5)
• command-line syntax
• function syntax

anything else?