style(9) manpage __P removal
ibotty
bsd at ibotty.net
Mon Sep 22 15:12:17 PDT 2003
this is a __P, that David Rhodus seems to have overlooked ;)
seriously, we should update the style(9) manpage to reflect our dislike to
__P.
my wording is surely not manpage-compliant, but this may be a start.
~ibottyIndex: style.9
===================================================================
RCS file: /home/src/dcvs/src/share/man/man9/style.9,v
retrieving revision 1.3
diff -u -3 -p -r1.3 style.9
--- style.9 14 Aug 2003 18:28:48 -0000 1.3
+++ style.9 22 Sep 2003 22:06:35 -0000
@@ -252,17 +252,18 @@ Functions that are used locally in more
separate header file, e.g.\&
.Qq Pa extern.h .
.Pp
-Only use the
+Never use the
.Dv __P
macro from the include file
.Aq Pa sys/cdefs.h
-if the source
-file in general is (to be) compilable with a K&R Old Testament compiler.
+in new source
+files, even if it is (to be) compilable with a K&R Old Testament compiler.
Use of the
.Dv __P
-macro in new code is discouraged, although modifications
-to existing files should be consistent with that file's conventions.
+macro in legacy code is also highly discouraged, even minor changes
+to existing code should remove these macros.
.Pp
+Nevertheless, modifications to existing files should be consistent with that file's conventions.
In general code can be considered
.Dq "new code"
when it makes up about 50% or more of the file(s) involved.
More information about the Submit
mailing list