summaryrefslogtreecommitdiffstats
path: root/share/man/man9/style.9
diff options
context:
space:
mode:
authorimp <imp@FreeBSD.org>2003-09-27 22:17:37 +0000
committerimp <imp@FreeBSD.org>2003-09-27 22:17:37 +0000
commit9d6689c4a78aa15eeea04d8fc8d55500ebf7b56c (patch)
tree0dce8a3037d6bda95212c1f5b81fc3bb89bdfa75 /share/man/man9/style.9
parentd0dceae232c439e34b42bed2045241fb1ebcbfa0 (diff)
downloadFreeBSD-src-9d6689c4a78aa15eeea04d8fc8d55500ebf7b56c.zip
FreeBSD-src-9d6689c4a78aa15eeea04d8fc8d55500ebf7b56c.tar.gz
Two minor fixes:
o It is the /usr/include files, not the /usr include files. o Document the practice of converting to the c99 standard uintXX_t form from the older, but non-standard, BSD-style u_intXX_t. This has been going on in the tree for a while now, and I've heard other developers also state that this conversion is happening. Note also that this is a slow process and should be treated like whitespace changes.
Diffstat (limited to 'share/man/man9/style.9')
-rw-r--r--share/man/man9/style.917
1 files changed, 15 insertions, 2 deletions
diff --git a/share/man/man9/style.9 b/share/man/man9/style.9
index 8791c20..a27e396 100644
--- a/share/man/man9/style.9
+++ b/share/man/man9/style.9
@@ -120,8 +120,8 @@ Do not use files in
for files in the kernel.
.Pp
Leave a blank line before the next group, the
-.Pa /usr
-include files,
+.Pa /usr/include
+files,
which should be sorted alphabetically by name.
.Bd -literal
#include <stdio.h>
@@ -247,6 +247,19 @@ is treated as
#endif /* !COMPAT_43*/
.Ed
.Pp
+The project is slowly moving to use the
+.St -isoC-99
+unsigned integer identifiers of the form
+.Ic uintXX_t
+in preference to the older BSD-style integer identifiers of the form
+.Ic u_intXX_t .
+New code should use the former, and old code should be converted to
+the new form if other major work is being done in that area and
+there's no overriding reason to prefer the older BSD-style.
+Like white-space commits, care should be taken in making
+.Ic uintXX_t
+only commits.
+.Pp
Enumeration values are all uppercase.
.Bd -literal
enum enumtype { ONE, TWO } et;
OpenPOWER on IntegriCloud