From: Junio C Hamano Date: Fri, 1 Aug 2025 17:06:55 +0000 (-0700) Subject: CodingGuidelines: clarify that S_release() does not reinitialize X-Git-Tag: v2.51.0-rc0~4^2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=4ac3302a1a77cf833fc7085a0b6a6b49024d1bc5;p=thirdparty%2Fgit.git CodingGuidelines: clarify that S_release() does not reinitialize In the section for naming various API functions, the fact that S_release() only releases the resources without preparing the structure for immediate reuse becomes only apparent when you readentries for S_release() and S_clear(). Clarify the description of S_release() a bit to make the entry self sufficient. Signed-off-by: Junio C Hamano --- diff --git a/Documentation/CodingGuidelines b/Documentation/CodingGuidelines index 3263245b03..ea6b9652e4 100644 --- a/Documentation/CodingGuidelines +++ b/Documentation/CodingGuidelines @@ -610,8 +610,9 @@ For C programs: - `S_init()` initializes a structure without allocating the structure itself. - - `S_release()` releases a structure's contents without freeing the - structure. + - `S_release()` releases a structure's contents without reinitializing + the structure for immediate reuse, and without freeing the structure + itself. - `S_clear()` is equivalent to `S_release()` followed by `S_init()` such that the structure is directly usable after clearing it. When