diff --git a/share/man/man9/style.9 b/share/man/man9/style.9 index fd8cf464d07..422e5a7d6d4 100644 --- a/share/man/man9/style.9 +++ b/share/man/man9/style.9 @@ -34,6 +34,10 @@ This file specifies the preferred style for kernel source files in the .Fx source tree. It is also a guide for preferred userland code style. +Many of the style rules are implicit in the examples. +Be careful to check the examples before assuming that +.Xr style 9 +is silent on an issue. .Bd -literal /* * Style guide for FreeBSD. Based on the CSRG's KNF (Kernel Normal Form). @@ -104,6 +108,10 @@ For a network program, put the network include files next. #include .Ed .Pp +Do not use files in +.Pa /usr/include +for files in the kernel. +.Pp Leave a blank line before the next group, the .Pa /usr include files,