summaryrefslogtreecommitdiff
path: root/gnulib/doc/posix-headers/stdalign.texi
diff options
context:
space:
mode:
Diffstat (limited to 'gnulib/doc/posix-headers/stdalign.texi')
m---------gnulib0
-rw-r--r--gnulib/doc/posix-headers/stdalign.texi53
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