Rename module stdnoreturn to stdnoreturn-h.
authorBruno Haible <bruno@clisp.org>
Fri, 27 Dec 2024 22:29:02 +0000 (23:29 +0100)
committerBruno Haible <bruno@clisp.org>
Fri, 27 Dec 2024 22:37:12 +0000 (23:37 +0100)
* 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.

ChangeLog
doc/noreturn.texi
doc/posix-headers/stdnoreturn.texi
modules/stdnoreturn
modules/stdnoreturn-h [new file with mode: 0644]
modules/stdnoreturn-h-tests [new file with mode: 0644]
modules/stdnoreturn-tests [deleted file]
tests/test-stdnoreturn-h.c [new file with mode: 0644]
tests/test-stdnoreturn.c [deleted file]

index 5b3de5831c70ff6253dcbd03a70031f3a14dd69e..adf50e86c74e65660e6739ee4a6834c8217133c6 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+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.
index 2356eda1117e1880e0c3af081d4a9ef2d543b428..06bc7916213ddf2c22c090939009acd9ec8b21de 100644 (file)
@@ -12,8 +12,8 @@
 @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}
@@ -57,6 +57,6 @@ you should use @code{_Noreturn}; otherwise the module
 @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.
index de1cce7be052f0e6f0bdc7323150178a66873dee..03564a574d0239c1b6925bf77b36692111423fbe 100644 (file)
@@ -5,8 +5,8 @@ ISO C23 specification:@* @url{https://www.open-std.org/jtc1/sc22/wg14/www/docs/n
 
 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
index e283fd18fb201a03156c178a97314242ddb80cdc..086917e963fa124e0efe4255e9771746ea86244e 100644 (file)
@@ -1,40 +1,20 @@
 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>
@@ -43,4 +23,3 @@ License:
 LGPLv2+
 
 Maintainer:
-Paul Eggert
diff --git a/modules/stdnoreturn-h b/modules/stdnoreturn-h
new file mode 100644 (file)
index 0000000..e283fd1
--- /dev/null
@@ -0,0 +1,46 @@
+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
diff --git a/modules/stdnoreturn-h-tests b/modules/stdnoreturn-h-tests
new file mode 100644 (file)
index 0000000..ec5b72c
--- /dev/null
@@ -0,0 +1,10 @@
+Files:
+tests/test-stdnoreturn-h.c
+
+Depends-on:
+
+configure.ac:
+
+Makefile.am:
+TESTS += test-stdnoreturn-h
+check_PROGRAMS += test-stdnoreturn-h
diff --git a/modules/stdnoreturn-tests b/modules/stdnoreturn-tests
deleted file mode 100644 (file)
index 1d1f820..0000000
+++ /dev/null
@@ -1,10 +0,0 @@
-Files:
-tests/test-stdnoreturn.c
-
-Depends-on:
-
-configure.ac:
-
-Makefile.am:
-TESTS += test-stdnoreturn
-check_PROGRAMS += test-stdnoreturn
diff --git a/tests/test-stdnoreturn-h.c b/tests/test-stdnoreturn-h.c
new file mode 100644 (file)
index 0000000..8318754
--- /dev/null
@@ -0,0 +1,35 @@
+/* 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 ();
+}
diff --git a/tests/test-stdnoreturn.c b/tests/test-stdnoreturn.c
deleted file mode 100644 (file)
index 8318754..0000000
+++ /dev/null
@@ -1,35 +0,0 @@
-/* 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 ();
-}