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

[via cfe-commits]

github-actions[bot] wrote:

<!--PREMERGE ADVISOR COMMENT: Linux-->
# :penguin: Linux x64 Test Results

* 90504 tests passed
* 1710 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
"/usr/bin/python3" /home/gha/actions-runner/_work/llvm-project/llvm-project/clang/test/Format/../../docs/tools/dump_format_style.py -o /home/gha/actions-runner/_work/llvm-project/llvm-project/build/tools/clang/test/Format/Output/docs_updated.test.tmp.style
# executed command: /usr/bin/python3 /home/gha/actions-runner/_work/llvm-project/llvm-project/clang/test/Format/../../docs/tools/dump_format_style.py -o /home/gha/actions-runner/_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 /home/gha/actions-runner/_work/llvm-project/llvm-project/build/tools/clang/test/Format/Output/docs_updated.test.tmp.style    /home/gha/actions-runner/_work/llvm-project/llvm-project/clang/test/Format/../../docs/ClangFormatStyleOptions.rst
# executed command: diff --strip-trailing-cr /home/gha/actions-runner/_work/llvm-project/llvm-project/build/tools/clang/test/Format/Output/docs_updated.test.tmp.style /home/gha/actions-runner/_work/llvm-project/llvm-project/clang/test/Format/../../docs/ClangFormatStyleOptions.rst
# .---command stdout------------
# | *** /home/gha/actions-runner/_work/llvm-project/llvm-project/build/tools/clang/test/Format/Output/docs_updated.test.tmp.style
# | --- /home/gha/actions-runner/_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