[clang] [clang-format] Add Natural option for SortIncludes (PR #210788)

[via cfe-commits]

github-actions[bot] wrote:

<!--PREMERGE ADVISOR COMMENT: Windows-->
# :window: Windows x64 Test Results

* 55794 tests passed
* 1420 tests skipped
* 1 test failed

## Failed Tests
(click on a test name to see its output)

### Clang
<details>
<summary>Clang.Format/docs_updated.test</summary>

```
Exit Code: 1

Command Output (stdout):
--
# RUN: at line 1
"C:\Python312\python.exe" C:\_work\llvm-project\llvm-project\clang\test\Format/../../docs/tools/dump_format_style.py -o C:\_work\llvm-project\llvm-project\build\tools\clang\test\Format\Output\docs_updated.test.tmp.style
# executed command: 'C:\Python312\python.exe' 'C:\_work\llvm-project\llvm-project\clang\test\Format/../../docs/tools/dump_format_style.py' -o 'C:\_work\llvm-project\llvm-project\build\tools\clang\test\Format\Output\docs_updated.test.tmp.style'
# note: command had no output on stdout or stderr
# RUN: at line 2
diff --strip-trailing-cr C:\_work\llvm-project\llvm-project\build\tools\clang\test\Format\Output\docs_updated.test.tmp.style    C:\_work\llvm-project\llvm-project\clang\test\Format/../../docs/ClangFormatStyleOptions.rst
# executed command: diff --strip-trailing-cr 'C:\_work\llvm-project\llvm-project\build\tools\clang\test\Format\Output\docs_updated.test.tmp.style' 'C:\_work\llvm-project\llvm-project\clang\test\Format/../../docs/ClangFormatStyleOptions.rst'
# .---command stdout------------
# | *** C:\_work\llvm-project\llvm-project\build\tools\clang\test\Format\Output\docs_updated.test.tmp.style
# | --- C:\_work\llvm-project\llvm-project\clang\test\Format/../../docs/ClangFormatStyleOptions.rst
# | ***************
# | *** 6821,6836 ****
# |          # include "A.inc"              # include "A.h"
# |          # include "A-util.h"           # include "A.inc"
# |   
# | !   * ``bool Natural`` Whether or not includes are sorted by natural ordering i.e., whether
# | !     embedded runs of digits are compared as numbers rather than sequences of
# | !     characters.
# |   
# |       .. code-block:: c++
# |   
# |          true:                      false:
# |          #include "A2.h"     vs.    #include "A10.h"
# |          #include "A10.h"           #include "A2.h"
# | - 
# |   
# |   .. _SortJavaStaticImport:
# |   
# | --- 6821,6834 ----
# |          # include "A.inc"              # include "A.h"
# |          # include "A-util.h"           # include "A.inc"
# |   
# | !   * ``bool Natural`` Whether or not includes are sorted by natural ordering i.e., whether embedded
# | !     runs of digits are compared as numbers rather than sequences of characters.
# |   
# |       .. code-block:: c++
# |   
# |          true:                      false:
# |          #include "A2.h"     vs.    #include "A10.h"
# |          #include "A10.h"           #include "A2.h"
# |   
# |   .. _SortJavaStaticImport:
# |   
# `-----------------------------
# error: command failed with exit status: 1

--

```
</details>

If these failures are unrelated to your changes (for example tests are broken or flaky at HEAD), please open an issue at https://github.com/llvm/llvm-project/issues and add the `infrastructure` label.

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