doc/posix-headers/stdnoreturn.texi

   1 @node stdnoreturn.h
   2 @section @file{stdnoreturn.h}
   3
   4 ISO C23 specification:@* @url{http://www.open-std.org/jtc1/sc22/wg14/www/docs/n3220.pdf} section 7.25.
   5
   6 POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/stdnoreturn.h.html}
   7
   8 Gnulib module: stdnoreturn
   9 @mindex stdnoreturn
  10
  11 Portability problems fixed by Gnulib:
  12 @itemize
  13 @item
  14 This header file is missing on many platforms:
  15 FreeBSD 6.4, NetBSD 7.1, OpenBSD 7.5, Minix 3.3.0, AIX 7.1, HP-UX 11.31, Solaris 11.3, Cygwin 2.9.0, mingw, MSVC 14, Android 9.0.
  16 @item
  17 This file conflicts with some system header files, such as @code{<stdlib.h>} and
  18 @code{<process.h>}, on some platforms:
  19 MSVC/clang.
  20 @end itemize
  21
  22 Portability problems not fixed by Gnulib:
  23 @itemize
  24 @item
  25 @code{<stdnoreturn.h>} and the @code{noreturn} macro are obsolescent in C23.
  26 @item
  27 @code{<stdnoreturn.h>} cannot be #included in C++ mode on some platforms:
  28 FreeBSD 13.1.
  29 @item
  30 @code{<stdnoreturn.h>} should be #included before @samp{_Noreturn} is used.
  31 @item
  32 You cannot assume that @code{_Noreturn} is a reserved word;
  33 it might be a macro.
  34 @item
  35 When the macro @code{lint} is defined, standard headers define
  36 @code{_Noreturn} (and therefore @code{noreturn}) to be a macro that
  37 expands to the empty token sequence on some platforms:
  38 Cygwin 2.5.1, FreeBSD 10.3.
  39 @item
  40 On Cygwin 1.7.30 and MSVC 14, @code{noreturn} expands to the empty token
  41 sequence, to avoid problems with standard headers that use @code{noreturn}
  42 in combination with @code{__attribute__} or @code{__declspec}.  Although
  43 the resulting code operates correctly, the compiler is not informed whether
  44 @code{noreturn} functions do not return, so it may generate incorrect
  45 warnings at compile-time, or code that is slightly less optimized.  This
  46 problem does not occur with @code{_Noreturn}.
  47 @item
  48 Circa 2012 bleeding-edge GCC with @code{-Werror=old-style-declaration}
  49 requires @code{_Noreturn} or @code{noreturn} before the returned type
  50 in a declaration, and therefore rejects valid but unusually-worded
  51 declarations such as @code{void _Noreturn foo (void);}.
  52 @end itemize