doc/posix-headers/stdnoreturn.texi

   1 @node stdnoreturn.h
   2 @section @file{stdnoreturn.h}
   3
   4 POSIX specification:@* Not in POSIX yet, but we expect it will be.
   5 ISO C11 (latest free draft
   6 @url{http://www.open-std.org/jtc1/sc22/wg14/www/docs/n1570.pdf})
   7 sections 7.23.
   8
   9 Gnulib module: stdnoreturn
  10
  11 Portability problems fixed by Gnulib:
  12 @itemize
  13 @item
  14 This header file is missing on most circa-2012 platforms.
  15 @end itemize
  16
  17 Portability problems not fixed by Gnulib:
  18 @itemize
  19 @item
  20 @code{<stdnoreturn.h>} should be #included before @samp{_Noreturn} is used.
  21 @item
  22 You cannot assume that @code{_Noreturn} is a reserved word;
  23 it might be a macro.
  24 @item
  25 On MSVC 9, @code{noreturn} expands to the empty token sequence, to avoid
  26 problems with standard headers that use @code{__declspec (noreturn)}
  27 directly.  Although the resulting code operates correctly, the
  28 compiler is not informed whether @code{noreturn} functions do not
  29 return, so it may generate incorrect warnings at compile-time, or code
  30 that is slightly less optimized.  This problem does not occur with
  31 @code{_Noreturn}.
  32 @item
  33 Circa 2012 bleeding-edge GCC with @code{-Werror=old-style-declaration}
  34 requires @code{_Noreturn} or @code{noreturn} before the returned type
  35 in a declaration, and therefore rejects valid but unusually-worded
  36 declarations such as @code{void _Noreturn foo (void);}.
  37 @end itemize