[clang] [llvm] [Clang] Cleanup docs and comments relating to -fextend-variable-liveness (PR #124767)

Tue Jan 28 10:32:22 PST 2025

llvm-ci wrote:

LLVM Buildbot has detected a new failure on builder `flang-aarch64-libcxx` running on `linaro-flang-aarch64-libcxx` while building `clang,llvm` at step 5 "build-unified-tree".

Full details are available at: https://lab.llvm.org/buildbot/#/builders/89/builds/15409

<details>
<summary>Here is the relevant piece of the build log for the reference</summary>

```
Step 5 (build-unified-tree) failure: build (failure)
...
36.994 [4117/59/3173] Creating library symlink lib/libmlir_async_runtime.so
36.996 [4117/58/3174] Building TestTypeDefs.h.inc...
36.997 [4117/57/3175] Creating library symlink lib/libmlir_arm_runner_utils.so
36.997 [4117/56/3176] Copying clang's stdalign.h...
36.998 [4117/55/3177] Copying clang's __stdarg___gnuc_va_list.h...
36.998 [4117/54/3178] Building TestTypeDefs.cpp.inc...
37.002 [4117/53/3179] Building CXX object tools/mlir/lib/IR/CMakeFiles/obj.MLIRIR.dir/PatternMatch.cpp.o
37.004 [4117/52/3180] Building CXX object tools/mlir/lib/IR/CMakeFiles/obj.MLIRIR.dir/Verifier.cpp.o
37.005 [4117/51/3181] Copying clang's stdarg.h...
37.006 [4117/50/3182] Building Options.inc...
FAILED: tools/clang/include/clang/Driver/Options.inc /home/tcwg-buildbot/worker/flang-aarch64-libcxx/build/tools/clang/include/clang/Driver/Options.inc 
cd /home/tcwg-buildbot/worker/flang-aarch64-libcxx/build && /home/tcwg-buildbot/worker/flang-aarch64-libcxx/build/bin/llvm-tblgen -gen-opt-parser-defs -I /home/tcwg-buildbot/worker/flang-aarch64-libcxx/llvm-project/clang/include/clang/Driver -I/home/tcwg-buildbot/worker/flang-aarch64-libcxx/llvm-project/clang/include -I/home/tcwg-buildbot/worker/flang-aarch64-libcxx/build/tools/clang/include -I/home/tcwg-buildbot/worker/flang-aarch64-libcxx/build/include -I/home/tcwg-buildbot/worker/flang-aarch64-libcxx/llvm-project/llvm/include /home/tcwg-buildbot/worker/flang-aarch64-libcxx/llvm-project/clang/include/clang/Driver/Options.td --write-if-changed -o tools/clang/include/clang/Driver/Options.inc -d tools/clang/include/clang/Driver/Options.inc.d
/home/tcwg-buildbot/worker/flang-aarch64-libcxx/llvm-project/clang/include/clang/Driver/Options.td:4356:3: error: Expected comma before next argument
  Values<"all,this,none">,
  ^
37.006 [4117/49/3183] Copying clang's __stdarg___va_copy.h...
37.007 [4117/48/3184] Copying clang's __stdarg_header_macro.h...
37.011 [4117/47/3185] Building CXX object tools/mlir/lib/IR/CMakeFiles/obj.MLIRIR.dir/Operation.cpp.o
37.025 [4117/46/3186] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRDerivedAttributeOpInterface.dir/DerivedAttributeOpInterface.cpp.o
37.029 [4117/45/3187] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRDestinationStyleOpInterface.dir/DestinationStyleOpInterface.cpp.o
37.032 [4117/44/3188] Building CXX object tools/mlir/lib/IR/CMakeFiles/obj.MLIRIR.dir/TypeUtilities.cpp.o
37.033 [4117/43/3189] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRCastInterfaces.dir/CastInterfaces.cpp.o
37.035 [4117/42/3190] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRControlFlowInterfaces.dir/ControlFlowInterfaces.cpp.o
37.037 [4117/41/3191] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRMemorySlotInterfaces.dir/MemorySlotInterfaces.cpp.o
37.039 [4117/40/3192] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRFunctionInterfaces.dir/FunctionInterfaces.cpp.o
37.040 [4117/39/3193] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRFunctionInterfaces.dir/FunctionImplementation.cpp.o
37.042 [4117/38/3194] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRInferTypeOpInterface.dir/InferTypeOpInterface.cpp.o
37.043 [4117/37/3195] Building CXX object tools/mlir/lib/IR/CMakeFiles/obj.MLIRIR.dir/RegionKindInterface.cpp.o
37.045 [4117/36/3196] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRCopyOpInterface.dir/CopyOpInterface.cpp.o
37.046 [4117/35/3197] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRParallelCombiningOpInterface.dir/ParallelCombiningOpInterface.cpp.o
37.048 [4117/34/3198] Building CXX object tools/mlir/lib/Query/Matcher/CMakeFiles/obj.MLIRQueryMatcher.dir/Parser.cpp.o
37.050 [4117/33/3199] Building CXX object tools/mlir/lib/Query/Matcher/CMakeFiles/obj.MLIRQueryMatcher.dir/RegistryManager.cpp.o
37.051 [4117/32/3200] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRViewLikeInterface.dir/ViewLikeInterface.cpp.o
37.055 [4117/31/3201] Building CXX object tools/mlir/lib/IR/CMakeFiles/obj.MLIRIR.dir/Region.cpp.o
37.058 [4117/30/3202] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRInferIntRangeInterface.dir/InferIntRangeInterface.cpp.o
37.059 [4117/29/3203] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRLoopLikeInterface.dir/LoopLikeInterface.cpp.o
37.061 [4117/28/3204] Building CXX object tools/mlir/tools/tblgen-lsp-server/CMakeFiles/tblgen-lsp-server.dir/tblgen-lsp-server.cpp.o
37.062 [4117/27/3205] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRRuntimeVerifiableOpInterface.dir/RuntimeVerifiableOpInterface.cpp.o
37.065 [4117/26/3206] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRDataLayoutInterfaces.dir/DataLayoutInterfaces.cpp.o
37.067 [4117/25/3207] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRSideEffectInterfaces.dir/SideEffectInterfaces.cpp.o
37.068 [4117/24/3208] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRTilingInterface.dir/TilingInterface.cpp.o
37.068 [4117/23/3209] Linking CXX shared library lib/libmlir_runner_utils.so.20.0git
37.070 [4117/22/3210] Building CXX object tools/mlir/lib/Query/Matcher/CMakeFiles/obj.MLIRQueryMatcher.dir/Diagnostics.cpp.o
37.072 [4117/21/3211] Building CXX object lib/Object/CMakeFiles/LLVMObject.dir/IRSymtab.cpp.o
37.074 [4117/20/3212] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRVectorInterfaces.dir/VectorInterfaces.cpp.o
37.075 [4117/19/3213] Building CXX object tools/mlir/lib/Interfaces/CMakeFiles/obj.MLIRShapedOpInterfaces.dir/ShapedOpInterfaces.cpp.o
37.075 [4117/18/3214] Linking CXX shared library lib/libMLIRSparseTensorRuntime.so.20.0git
37.083 [4117/17/3215] Linking CXX shared library lib/libMLIRPDLLODS.so.20.0git
37.084 [4117/16/3216] Linking CXX shared library lib/libMLIRCAPIDebug.so.20.0git

```

</details>

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