From: Junio C Hamano <gitster@pobox.com>
Date: Fri, 1 Aug 2025 18:27:13 +0000 (-0700)
Subject: Merge branch 'jc/document-test-balloons-in-flight'
X-Git-Tag: v2.51.0-rc0~24
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=cbcde15e7316a28f9deb49b4f48e9748b5a903d2;p=thirdparty%2Fgit.git

Merge branch 'jc/document-test-balloons-in-flight'

To help our developers, document what C99 language features are
being considered for adoption, in addition to what past experiments
have already decided.

* jc/document-test-balloons-in-flight:
  CodingGuidelines: document test balloons in flight
---

cbcde15e7316a28f9deb49b4f48e9748b5a903d2
diff --cc Documentation/CodingGuidelines
index 528b42d1dd,0776d15a95..f474120425
--- a/Documentation/CodingGuidelines
+++ b/Documentation/CodingGuidelines
@@@ -298,9 -298,14 +298,17 @@@ For C programs
     . since late 2021 with 44ba10d6, we have had variables declared in
       the for loop "for (int i = 0; i < 10; i++)".
  
 +   . since late 2023 with 8277dbe987 we have been using the bool type
 +     from <stdbool.h>.
 +
+    C99 features we have test balloons for:
+ 
+    . since late 2024 with v2.48.0-rc0~20, we have test balloons for
+      compound literal syntax, e.g., (struct foo){ .member = value };
+      our hope is that no platforms we care about have trouble using
+      them, and officially adopt its wider use in mid 2026.  Do not add
+      more use of the syntax until that happens.
+ 
     New C99 features that we cannot use yet:
  
     . %z and %zu as a printf() argument for a size_t (the %z being for