From 2b6f1df3bdf0c5dff8523eee798790c322b554d2 Mon Sep 17 00:00:00 2001 From: Warner Losh Date: Thu, 13 Dec 2001 01:29:34 +0000 Subject: [PATCH] Add two clarifying commnets: 1) Note that this file is also by example. 2) Note that you should not use files from /usr/include in kernel files. --- share/man/man9/style.9 | 8 ++++++++ 1 file changed, 8 insertions(+) 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,