[clang] [clang] Document -fstrict-flex-arrays option (PR #138388)

[via cfe-commits]

llvmbot wrote:


<!--LLVM PR SUMMARY COMMENT-->

@llvm/pr-subscribers-clang

Author: None (serge-sans-paille)

<details>
<summary>Changes</summary>

Fix #<!-- -->138185

---
Full diff: https://github.com/llvm/llvm-project/pull/138388.diff


1 Files Affected:

- (modified) clang/include/clang/Driver/Options.td (+4-1) 


``````````diff
diff --git a/clang/include/clang/Driver/Options.td b/clang/include/clang/Driver/Options.td
index 2946ffaa28da0..5ceba7e3bf4c7 100644
--- a/clang/include/clang/Driver/Options.td
+++ b/clang/include/clang/Driver/Options.td
@@ -1554,7 +1554,10 @@ def fstrict_flex_arrays_EQ : Joined<["-"], "fstrict-flex-arrays=">, Group<f_Grou
   Visibility<[ClangOption, CC1Option]>,
   NormalizedValuesScope<"LangOptions::StrictFlexArraysLevelKind">,
   NormalizedValues<["Default", "OneZeroOrIncomplete", "ZeroOrIncomplete", "IncompleteOnly"]>,
-  HelpText<"Enable optimizations based on the strict definition of flexible arrays">,
+  HelpText<"Enable optimizations based on the strict definition of flexible arrays. "
+    "If ``<n>`` is equal to 0, any trailing array member is considered a flexible array. "
+    "If ``<n>`` is equal to 1, trailing array members of size 0, 1 and undefined are considered flexible arrays. "
+    "If ``<n>`` is equal to 3, only trailing array members of undefined size are considered flexible arrays.">,
   MarshallingInfoEnum<LangOpts<"StrictFlexArraysLevel">, "Default">;
 defm apple_pragma_pack : BoolFOption<"apple-pragma-pack",
   LangOpts<"ApplePragmaPack">, DefaultFalse,

``````````

</details>


https://github.com/llvm/llvm-project/pull/138388