]> Savannah Git Hosting - gnulib.git/commitdiff
attribute: Improve comments.
authorBruno Haible <bruno@clisp.org>
Thu, 30 May 2024 14:47:24 +0000 (16:47 +0200)
committerBruno Haible <bruno@clisp.org>
Thu, 30 May 2024 14:47:47 +0000 (16:47 +0200)
* m4/gnulib-common.m4 (gl_COMMON_BODY): Mention each macro name at the
beginning of its commentary.

ChangeLog
m4/gnulib-common.m4

index 2792ccbb794c4efe61250509bad4f1fe7323f55f..6ea227c411d350583c3023e95d5d697be2e35357 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2024-05-30  Bruno Haible  <bruno@clisp.org>
+
+       attribute: Improve comments.
+       * m4/gnulib-common.m4 (gl_COMMON_BODY): Mention each macro name at the
+       beginning of its commentary.
+
 2024-05-30  Collin Funk  <collin.funk1@gmail.com>
 
        endian: Quote variables that may be undefined (regr. 2024-05-18).
index a1254cf678089d071c89366018d50a7ddbc1bc12..fba5158ced248652cccadb98d903e1ad6bea1c11 100644 (file)
@@ -203,7 +203,8 @@ AC_DEFUN([gl_COMMON_BODY], [
 # endif
 #endif
 
-/* It is OK for a compiler to move calls to the function and to omit
+/* _GL_ATTRIBUTE_CONST declares:
+   It is OK for a compiler to move calls to the function and to omit
    calls to the function if another call has the same arguments or the
    result is not used.
    This attribute is safe for a function that neither depends on
@@ -521,7 +522,8 @@ AC_DEFUN([gl_COMMON_BODY], [
 # endif
 #endif
 
-/* It is OK for a compiler to move calls to the function and to omit
+/* _GL_ATTRIBUTE_PURE declares:
+   It is OK for a compiler to move calls to the function and to omit
    calls to the function if another call has the same arguments or the
    result is not used, and if observable state is the same.
    This attribute is safe for a function that does not affect observable state
@@ -539,7 +541,8 @@ AC_DEFUN([gl_COMMON_BODY], [
 # endif
 #endif
 
-/* It is OK for a compiler to move calls to the function and to omit duplicate
+/* _GL_ATTRIBUTE_REPRODUCIBLE declares:
+   It is OK for a compiler to move calls to the function and to omit duplicate
    calls to the function with the same arguments, so long as the state
    addressed by its arguments is the same and is updated in time for
    the rest of the program.
@@ -584,7 +587,8 @@ AC_DEFUN([gl_COMMON_BODY], [
 # endif
 #endif
 
-/* It is OK for a compiler to move calls to the function and to omit duplicate
+/* _GL_ATTRIBUTE_UNSEQUENCED declares:
+   It is OK for a compiler to move calls to the function and to omit duplicate
    calls to the function with the same arguments, so long as the state
    addressed by its arguments is the same.
    This attribute is safe for a function that is effectless, idempotent,