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