stddef: Fix kernel-doc/Sphinx warnings for __TRAILING_OVERLAP()

index 665d7a68cd98..f666ced2a9e7 100644
@@ -104,26 +104,26 @@ enum {
  * union, designated initializers for MEMBERS may overwrite portions
  * previously initialized through NAME.
  *
- * For example:
- *
- * struct flex {
- *	size_t count;
- *	u8 fam[];
- * };
- *
- * struct composite {
- *	...
- *	__TRAILING_OVERLAP(struct flex, flex, fam, __packed,
- *		u8 data;
- *	);
- * } __packed;
- *
- * static struct composite comp = {
- *	.flex = {
- *		.count = 1,
- *	},
- *	.data = 2,
- * };
+ * For example::
+ *
+ *	struct flex {
+ *		size_t count;
+ *		u8 fam[];
+ *	};
+ *
+ *	struct composite {
+ *		...
+ *		__TRAILING_OVERLAP(struct flex, flex, fam, __packed,
+ *			u8 data;
+ *		);
+ *	} __packed;
+ *
+ *	static struct composite comp = {
+ *		.flex = {
+ *			.count = 1,
+ *		},
+ *		.data = 2,
+ *	};
  *
  * In the example above, .flex and .data initialize different views of the same
  * union storage. Since .data is initialized last, it _may_ overwrite portions

@@ -133,7 +133,7 @@ enum {
  * A couple of alternatives are shown below.
  *
  * a) Initialize only one view of the overlapped storage and assign the rest
- *    at runtime:
+ *    at runtime::
  *
  *	static struct composite comp = {
  *		.flex = {

@@ -147,9 +147,7 @@ enum {
  *		...
  *	}
  *
- *	(Compiler Explorer test code: https://godbolt.org/z/zz4K1Ejvf)
- *
- * b) Alternatively, replace designated initializers with runtime assignments.
+ * b) Alternatively, replace designated initializers with runtime assignments::
  *
  *	static void foo(void)
  *	{

@@ -160,6 +158,8 @@ enum {
  *		...
  *	}
  *
+ * Compiler Explorer test code: https://godbolt.org/z/zz4K1Ejvf
+ *
  * For another example of the above see commit 5e54510a9389 ("acpi: nfit:
  * intel: avoid multiple -Wflex-array-member-not-at-end warnings")
  *