+2024-05-12 Bruno Haible <bruno@clisp.org>
+
+ execinfo: Document known bugs.
+ * doc/glibc-functions/backtrace.texi: Mention the various bugs on
+ FreeBSD, NetBSD, OpenBSD.
+ * doc/glibc-functions/backtrace_symbols_fd.texi: Mention the glibc bug.
+
2024-05-12 Bruno Haible <bruno@clisp.org>
execinfo tests: Strengthen tests.
The second argument is of type @code{size_t}, not @code{int}, on some platforms:
FreeBSD, NetBSD, OpenBSD.
@item
+The return value may be @code{(size_t)(-1)} instead of 0 on some platforms:
+FreeBSD 12.4/i386.
+@item
+The returned stack trace is empty if it would not entirely fit into the
+provided buffer on some platforms:
+FreeBSD 14.0, NetBSD 10.0, OpenBSD 7.5.
+@item
+The returned stack trace is always empty on some platforms:
+FreeBSD 11.0/i386, FreeBSD 12.2/sparc64.
+@item
On platforms where the function is missing,
the Gnulib substitute implementation is just a stub, and does nothing.
@end itemize
The second argument is of type @code{size_t}, not @code{int}, on some platforms:
FreeBSD, NetBSD, OpenBSD.
@item
+The strings printed by this function not the same as the strings returned by
+@code{backtrace_symbols} on some platforms:
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=31730
+glibc 2.39.
+@item
On platforms where the function is missing,
the Gnulib substitute implementation is just a stub, and does nothing.
@end itemize