* modules/stdnoreturn-h: Renamed from modules/stdnoreturn.
* modules/stdnoreturn-h-tests: Renamed from modules/stdnoreturn-tests.
* tests/test-stdnoreturn-h.c: Renamed from tests/test-stdnoreturn.c.
* doc/posix-headers/stdnoreturn.texi: Update.
* doc/noreturn.texi: Update.
* modules/stdnoreturn: New file.
+2024-12-27 Bruno Haible <bruno@clisp.org>
+
+ Rename module stdnoreturn to stdnoreturn-h.
+ * modules/stdnoreturn-h: Renamed from modules/stdnoreturn.
+ * modules/stdnoreturn-h-tests: Renamed from modules/stdnoreturn-tests.
+ * tests/test-stdnoreturn-h.c: Renamed from tests/test-stdnoreturn.c.
+ * doc/posix-headers/stdnoreturn.texi: Update.
+ * doc/noreturn.texi: Update.
+ * modules/stdnoreturn: New file.
+
2024-12-27 Bruno Haible <bruno@clisp.org>
Rename module stdlib to stdlib-h.
@section Non-returning Functions
@cindex @code{_Noreturn}
-@cindex @code{noreturn}
-@cindex @code{stdnoreturn}
+@mindex @code{noreturn}
+@mindex @code{stdnoreturn-h}
A "non-returning" function is a function which cannot return normally.
Instead of returning, it can loop forever, or it can transfer control via
@code{abort}, @code{execvp}, @code{exit}, @code{longjmp}, @code{throw}
@code{noreturn} provides for better data-flow analysis and thus for
better warnings.
-@mindex stdnoreturn
-There is also an obsolete @code{stdnoreturn} module, but its use is no
+@mindex stdnoreturn-h
+There is also an obsolete @code{stdnoreturn-h} module, but its use is no
longer recommended.
POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/stdnoreturn.h.html}
-Gnulib module: stdnoreturn
-@mindex stdnoreturn
+Gnulib module: stdnoreturn-h
+@mindex stdnoreturn-h
Portability problems fixed by Gnulib:
@itemize
Description:
A <stdnoreturn.h> that nearly conforms to ISO C11.
+Status:
+deprecated
+
Notice:
-The module 'stdnoreturn' is deprecated.
-New code should use the '_Noreturn' keyword or the 'noreturn' module.
+This module is deprecated. Use the module 'stdnoreturn-h' instead.
Files:
-lib/stdnoreturn.in.h
-m4/stdnoreturn.m4
Depends-on:
-gen-header
-snippet/_Noreturn
+stdnoreturn-h
configure.ac:
-gl_STDNORETURN_H
-gl_CONDITIONAL_HEADER([stdnoreturn.h])
-AC_PROG_MKDIR_P
Makefile.am:
-BUILT_SOURCES += $(STDNORETURN_H)
-
-# We need the following in order to create <stdnoreturn.h> when the system
-# doesn't have one that works.
-if GL_GENERATE_STDNORETURN_H
-stdnoreturn.h: stdnoreturn.in.h $(top_builddir)/config.status $(_NORETURN_H)
-@NMD@ $(AM_V_GEN)$(MKDIR_P) '%reldir%'
- $(gl_V_at)$(SED_HEADER_STDOUT) \
- -e '/definition of _Noreturn/r $(_NORETURN_H)' \
- $(srcdir)/stdnoreturn.in.h > $@-t
- $(AM_V_at)mv $@-t $@
-else
-stdnoreturn.h: $(top_builddir)/config.status
- rm -f $@
-endif
-MOSTLYCLEANFILES += stdnoreturn.h stdnoreturn.h-t
Include:
<stdnoreturn.h>
LGPLv2+
Maintainer:
-Paul Eggert
--- /dev/null
+Description:
+A <stdnoreturn.h> that nearly conforms to ISO C11.
+
+Notice:
+The module 'stdnoreturn' is deprecated.
+New code should use the '_Noreturn' keyword or the 'noreturn' module.
+
+Files:
+lib/stdnoreturn.in.h
+m4/stdnoreturn.m4
+
+Depends-on:
+gen-header
+snippet/_Noreturn
+
+configure.ac:
+gl_STDNORETURN_H
+gl_CONDITIONAL_HEADER([stdnoreturn.h])
+AC_PROG_MKDIR_P
+
+Makefile.am:
+BUILT_SOURCES += $(STDNORETURN_H)
+
+# We need the following in order to create <stdnoreturn.h> when the system
+# doesn't have one that works.
+if GL_GENERATE_STDNORETURN_H
+stdnoreturn.h: stdnoreturn.in.h $(top_builddir)/config.status $(_NORETURN_H)
+@NMD@ $(AM_V_GEN)$(MKDIR_P) '%reldir%'
+ $(gl_V_at)$(SED_HEADER_STDOUT) \
+ -e '/definition of _Noreturn/r $(_NORETURN_H)' \
+ $(srcdir)/stdnoreturn.in.h > $@-t
+ $(AM_V_at)mv $@-t $@
+else
+stdnoreturn.h: $(top_builddir)/config.status
+ rm -f $@
+endif
+MOSTLYCLEANFILES += stdnoreturn.h stdnoreturn.h-t
+
+Include:
+<stdnoreturn.h>
+
+License:
+LGPLv2+
+
+Maintainer:
+Paul Eggert
--- /dev/null
+Files:
+tests/test-stdnoreturn-h.c
+
+Depends-on:
+
+configure.ac:
+
+Makefile.am:
+TESTS += test-stdnoreturn-h
+check_PROGRAMS += test-stdnoreturn-h
+++ /dev/null
-Files:
-tests/test-stdnoreturn.c
-
-Depends-on:
-
-configure.ac:
-
-Makefile.am:
-TESTS += test-stdnoreturn
-check_PROGRAMS += test-stdnoreturn
--- /dev/null
+/* Test of <stdnoreturn.h>.
+ Copyright 2012-2024 Free Software Foundation, Inc.
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <https://www.gnu.org/licenses/>. */
+
+/* Written by Paul Eggert. */
+
+#include <config.h>
+
+#include <stdnoreturn.h>
+
+#include <stdlib.h>
+
+noreturn void
+does_not_return (void)
+{
+ exit (0);
+}
+
+int
+main (void)
+{
+ does_not_return ();
+}
+++ /dev/null
-/* Test of <stdnoreturn.h>.
- Copyright 2012-2024 Free Software Foundation, Inc.
-
- This program is free software: you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation, either version 3 of the License, or
- (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program. If not, see <https://www.gnu.org/licenses/>. */
-
-/* Written by Paul Eggert. */
-
-#include <config.h>
-
-#include <stdnoreturn.h>
-
-#include <stdlib.h>
-
-noreturn void
-does_not_return (void)
-{
- exit (0);
-}
-
-int
-main (void)
-{
- does_not_return ();
-}