diff options
Diffstat (limited to 'gnulib/doc/posix-headers/stdalign.texi')
m--------- | gnulib | 0 | ||||
-rw-r--r-- | gnulib/doc/posix-headers/stdalign.texi | 53 |
2 files changed, 53 insertions, 0 deletions
diff --git a/gnulib b/gnulib deleted file mode 160000 -Subproject 443bc5ffcf7429e557f4a371b0661abe98ddbc1 diff --git a/gnulib/doc/posix-headers/stdalign.texi b/gnulib/doc/posix-headers/stdalign.texi new file mode 100644 index 0000000..bebc70d --- /dev/null +++ b/gnulib/doc/posix-headers/stdalign.texi @@ -0,0 +1,53 @@ +@node stdalign.h +@section @file{stdalign.h} + +POSIX specification:@* Not in POSIX yet, but we expect it will be. +ISO C1X @url{http://www.open-std.org/jtc1/sc22/wg14/www/docs/n1570.pdf} +sections 6.5.3.4, 6.7.5, 7.15. +C++0X @url{http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2011/n3242.pdf} +section 18.10. + +Gnulib module: stdalign + +Portability problems fixed by Gnulib: +@itemize +@item +This header file is missing on most circa-2011 platforms. +@item +Clang 3.0's @code{<stdalign.h>} does not define @code{alignof}/@code{_Alignof}. +@end itemize + +Portability problems not fixed by Gnulib: +@itemize +@item +@code{_Alignas} and @code{alignas} are not always supported; +on platforms lacking support, the +macro @code{__alignas_is_defined} is not defined. +Supported compilers include GCC, IBM C, Sun C 5.11 and later, +and MSVC 7.0 and later. +@item +Some compilers do not support alignment via +@code{alignas}/@code{_Alignas} of @code{auto} variables (i.e., +variables on the stack). They diagnose and ignore the alignment: Sun +C 5.11. +@item +Some linkers do not support operands of @code{_Alignas}/@code{alignas} +that are greater than 8: mingw. +@item +Some compilers require the operand of @code{_Alignas}/@code{alignas} +to be a single integer constant, not an expression: MSVC 7.0 through +at least 10.0. +@item +The Sun C 5.11 compiler sometimes mishandles the alignment of multiple +external variables that are declared close together with +@code{_Alignas}/@code{alignas}. This compiler bug causes the Gnulib +module @code{stdalign-tests} to fail. The Sun Studio Developer Bug +Report Review Team assigned the internal review ID 2125432 (dated +2011-11-01) to this issue. +@item +@code{<stdalign.h>} must be #included before @samp{_Alignas} and +@samp{_Alignof} can be used. +@item +You cannot assume that @code{_Alignas} and @code{_Alignof} are reserved words; +they might be macros. +@end itemize |