svn commit: r286170 - head/share/man/man9

[John-Mark Gurney]

Author: jmg
Date: Sun Aug  2 00:22:14 2015
New Revision: 286170
URL: https://svnweb.freebsd.org/changeset/base/286170

Log:
  mark this function as deprecated, and put the warning first, since I
  doubt most people will read to the end...  Note the use of sys/cdefs.h
  for pre-C11 compilers...
  
  I didn't included a note about being compatibile w/ userland since a
  C11 feature should be obviously usable in userland...
  
  Suggested by:	imp

Modified:
  head/share/man/man9/CTASSERT.9

Modified: head/share/man/man9/CTASSERT.9
==============================================================================
--- head/share/man/man9/CTASSERT.9	Sun Aug  2 00:18:48 2015	(r286169)
+++ head/share/man/man9/CTASSERT.9	Sun Aug  2 00:22:14 2015	(r286170)
@@ -26,7 +26,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd July 30, 2015
+.Dd August 1, 2015
 .Dt CTASSERT 9
 .Os
 .Sh NAME
@@ -39,6 +39,15 @@
 .Sh DESCRIPTION
 The
 .Fn CTASSERT
+macro is deprecated and the C11 standard
+.Fn _Static_assert
+should be used instead.
+The header
+.Fa sys/cdefs.h
+should be included to provide compatibility for pre-C11 compilers.
+.Pp
+The
+.Fn CTASSERT
 macro evaluates
 .Fa expression
 at compile time and causes a compiler error if it is false.
@@ -48,10 +57,6 @@ The
 macro is useful for asserting the size or alignment of important
 data structures and variables during compilation, which would
 otherwise cause the code to fail at run time.
-.Pp
-The
-.Fn CTASSERT
-macro is not usable in userland.
 .Sh EXAMPLES
 Assert that the size of the
 .Vt uuid