[llvm] [llvm][Docs] Explain how to handle excessive formatting changes (PR #126239)

Andrzej WarzyƄski via llvm-commits llvm-commits at lists.llvm.org
Mon Feb 10 00:23:23 PST 2025


================
@@ -73,15 +73,33 @@ recent commit:
 
   % git clang-format HEAD~1
 
-Note that this modifies the files, but doesn't commit them -- you'll likely want
-to run
+.. note::
+  For some patches, formatting them may add changes that obscure the intent of
+  the patch. For example, adding to an enum that was not previously formatted
+  may result in the entire enum being reformatted. This happens because not all
+  of the LLVM Project conforms to clang-format at this time.
----------------
banach-space wrote:

[nit] `clang-format` is just a tool. Conform to `clang-format style`? `clang-format set-up file`? `clang-format setting`?
```suggestion
  of the LLVM Project conforms to clang-format set-up at this time.
```

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


More information about the llvm-commits mailing list