mirrors/llvm-project
0
0
Fork 0
mirror of https://github.com/llvm/llvm-project.git synced 2025-04-19 10:06:54 +00:00
Code Issues Projects Releases Wiki Activity
llvm-project/libcxx/.clang-format

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

84 lines
3.1 KiB
Plaintext
Raw Normal View History

Add .clang-format to libc++ Adding a Clang Format file to libc++ and which style it should use has been discussed a couple of times. This patch finally adds a .clang-format file which specifies LLVM styles. Personally I dislike how the LLVM style handles much of the meta-programming in libc++. However the general consensus was that libc++ should prefer the LLVM style and make adjustments where needed. Note that using clang-format on changes is not required, especially for changes within the headers. However formatting tests should be encouraged. llvm-svn: 287020
2016-11-15 20:21:30 +00:00
BasedOnStyle: LLVM
[libc++] Make sure our .clang-format is used for all languages In particular, this ensures that it is used for Objective-C and Objective-C++, since we have a few files that get detected as that. Differential Revision: https://reviews.llvm.org/D153289
2023-06-16 14:32:08 -04:00
# Note that we don't specify the language in this file because some files are
# detected as Cpp, but others are detected as ObjC and we want this formatting
# to apply to all types of files.
[libcxx] Fix max_size() across all containers Summary: The `max_size()` method of containers should respect both the allocator's reported `max_size` and the range of the `difference_type`. This patch makes all containers choose the smallest of those two values. Reviewers: mclow.lists, EricWF Subscribers: cfe-commits Differential Revision: https://reviews.llvm.org/D26885 llvm-svn: 287729
2016-11-23 01:18:56 +00:00
[libc++] Find a clang-format everybody is happy with We decided that we want to use clang-format for libc++ but we haven't decided yet how the code should be formatted. We should probably discuss things on discord. This PR is mostly to show how the clang-format would look like and to commit to one once we decided on it. I'll remove the `<string>` diff when I commit this PR. Reviewed By: ldionne Spies: EricWF, dschuff, krytarowski, fedor.sergeev, aheejin, mstorsjo, phosek, abrachet, libcxx-commits, arichardson Differential Revision: https://reviews.llvm.org/D124789
2022-06-14 20:09:03 +02:00
AlignAfterOpenBracket: Align
AlignConsecutiveAssignments: Consecutive
AlignConsecutiveBitFields: Consecutive
AlignEscapedNewlines: Right
AlignOperands: AlignAfterOperator
AlignTrailingComments: true
AllowAllArgumentsOnNextLine: true
AllowAllParametersOfDeclarationOnNextLine: true
AllowShortFunctionsOnASingleLine: true
AllowShortLambdasOnASingleLine: All
[libc++][NFC] Sort list of attribute macros in the .clang-format file
2023-07-04 11:25:15 -04:00
AttributeMacros: [
'_ALIGNAS_TYPE',
'_ALIGNAS',
'_LIBCPP_ALIGNOF',
'_LIBCPP_ALWAYS_INLINE',
[libc++][NFC] Rename the constexpr macros This was discussed on Discord with the consensus that we should rename the macros. Reviewed By: ldionne, Mordante, var-const, avogelsgesang, jloser, #libc Spies: libcxx-commits Differential Revision: https://reviews.llvm.org/D131498
2022-08-19 13:08:01 +02:00
'_LIBCPP_CONSTEXPR_SINCE_CXX14',
'_LIBCPP_CONSTEXPR_SINCE_CXX17',
'_LIBCPP_CONSTEXPR_SINCE_CXX20',
'_LIBCPP_CONSTEXPR_SINCE_CXX23',
[libc++][NFC] Sort list of attribute macros in the .clang-format file
2023-07-04 11:25:15 -04:00
'_LIBCPP_CONSTEXPR',
[libc++] Readd _LIBCPP_CONSTINIT This isn't used by libc++, but it's still used in libc++abi.
2023-11-13 13:06:06 +01:00
'_LIBCPP_CONSTINIT',
[libc++][NFC] Sort list of attribute macros in the .clang-format file
2023-07-04 11:25:15 -04:00
'_LIBCPP_DEPRECATED_IN_CXX11',
'_LIBCPP_DEPRECATED_IN_CXX14',
'_LIBCPP_DEPRECATED_IN_CXX17',
'_LIBCPP_DEPRECATED_IN_CXX20',
[libc++][memory] P2868R1: Removing deprecated typedef `std::allocator::is_always_equal` (#78562) Implements: - https://wg21.link/P2868R1 - https://wg21.link/LWG3170 --------- Co-authored-by: Zingam <zingam@outlook.com>
2024-01-20 06:07:19 +02:00
'_LIBCPP_DEPRECATED_IN_CXX23',
[libc++][NFC] Sort list of attribute macros in the .clang-format file
2023-07-04 11:25:15 -04:00
'_LIBCPP_DEPRECATED',
[libc++] Find a clang-format everybody is happy with We decided that we want to use clang-format for libc++ but we haven't decided yet how the code should be formatted. We should probably discuss things on discord. This PR is mostly to show how the clang-format would look like and to commit to one once we decided on it. I'll remove the `<string>` diff when I commit this PR. Reviewed By: ldionne Spies: EricWF, dschuff, krytarowski, fedor.sergeev, aheejin, mstorsjo, phosek, abrachet, libcxx-commits, arichardson Differential Revision: https://reviews.llvm.org/D124789
2022-06-14 20:09:03 +02:00
'_LIBCPP_DISABLE_EXTENTSION_WARNING',
'_LIBCPP_EXCLUDE_FROM_EXPLICIT_INSTANTIATION',
[libc++][NFC] Sort list of attribute macros in the .clang-format file
2023-07-04 11:25:15 -04:00
'_LIBCPP_EXPORTED_FROM_ABI',
'_LIBCPP_EXTERN_TEMPLATE_TYPE_VIS',
'_LIBCPP_FALLTHROUGH',
'_LIBCPP_HIDDEN',
[libc++] Find a clang-format everybody is happy with We decided that we want to use clang-format for libc++ but we haven't decided yet how the code should be formatted. We should probably discuss things on discord. This PR is mostly to show how the clang-format would look like and to commit to one once we decided on it. I'll remove the `<string>` diff when I commit this PR. Reviewed By: ldionne Spies: EricWF, dschuff, krytarowski, fedor.sergeev, aheejin, mstorsjo, phosek, abrachet, libcxx-commits, arichardson Differential Revision: https://reviews.llvm.org/D124789
2022-06-14 20:09:03 +02:00
'_LIBCPP_HIDE_FROM_ABI_AFTER_V1',
[libc++][NFC] Sort list of attribute macros in the .clang-format file
2023-07-04 11:25:15 -04:00
'_LIBCPP_HIDE_FROM_ABI',
'_LIBCPP_INTERNAL_LINKAGE',
'_LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS',
[libc++] Introduce __is_pointer_in_range This checks whether a pointer is within a range, even during constant evaluation. This allows running optimized code paths during constant evaluation, instead of falling back to the general-purpose implementation all the time. This is also a central place for comparing unrelated pointers, which is technically UB. Reviewed By: ldionne, #libc Spies: libcxx-commits Differential Revision: https://reviews.llvm.org/D143327
2023-06-07 13:33:02 -07:00
'_LIBCPP_NO_SANITIZE',
[libc++][NFC] Sort list of attribute macros in the .clang-format file
2023-07-04 11:25:15 -04:00
'_LIBCPP_NO_UNIQUE_ADDRESS',
'_LIBCPP_NOALIAS',
[libc++] Find a clang-format everybody is happy with We decided that we want to use clang-format for libc++ but we haven't decided yet how the code should be formatted. We should probably discuss things on discord. This PR is mostly to show how the clang-format would look like and to commit to one once we decided on it. I'll remove the `<string>` diff when I commit this PR. Reviewed By: ldionne Spies: EricWF, dschuff, krytarowski, fedor.sergeev, aheejin, mstorsjo, phosek, abrachet, libcxx-commits, arichardson Differential Revision: https://reviews.llvm.org/D124789
2022-06-14 20:09:03 +02:00
'_LIBCPP_NODISCARD_EXT',
[libc++][NFC] Sort list of attribute macros in the .clang-format file
2023-07-04 11:25:15 -04:00
'_LIBCPP_NODISCARD',
'_LIBCPP_NORETURN',
'_LIBCPP_OVERRIDABLE_FUNC_VIS',
[libc++] Find a clang-format everybody is happy with We decided that we want to use clang-format for libc++ but we haven't decided yet how the code should be formatted. We should probably discuss things on discord. This PR is mostly to show how the clang-format would look like and to commit to one once we decided on it. I'll remove the `<string>` diff when I commit this PR. Reviewed By: ldionne Spies: EricWF, dschuff, krytarowski, fedor.sergeev, aheejin, mstorsjo, phosek, abrachet, libcxx-commits, arichardson Differential Revision: https://reviews.llvm.org/D124789
2022-06-14 20:09:03 +02:00
'_LIBCPP_STANDALONE_DEBUG',
[libc++][NFC] Sort list of attribute macros in the .clang-format file
2023-07-04 11:25:15 -04:00
'_LIBCPP_TEMPLATE_DATA_VIS',
'_LIBCPP_TEMPLATE_VIS',
[libc++] Fix thread annotations on shared_mutex and shared_timed_mutex Based on the comment in https://reviews.llvm.org/D54290#4418958, these attributes need to be on the top-level functions in order to work properly. Also, add tests. Fixes http://llvm.org/PR57035. Differential Revision: https://reviews.llvm.org/D154354
2023-07-03 11:02:47 -04:00
'_LIBCPP_THREAD_SAFETY_ANNOTATION',
[libc++][NFC] Sort list of attribute macros in the .clang-format file
2023-07-04 11:25:15 -04:00
'_LIBCPP_USING_IF_EXISTS',
'_LIBCPP_WEAK',
[libc++] Find a clang-format everybody is happy with We decided that we want to use clang-format for libc++ but we haven't decided yet how the code should be formatted. We should probably discuss things on discord. This PR is mostly to show how the clang-format would look like and to commit to one once we decided on it. I'll remove the `<string>` diff when I commit this PR. Reviewed By: ldionne Spies: EricWF, dschuff, krytarowski, fedor.sergeev, aheejin, mstorsjo, phosek, abrachet, libcxx-commits, arichardson Differential Revision: https://reviews.llvm.org/D124789
2022-06-14 20:09:03 +02:00
]
BinPackArguments: false
BinPackParameters: false
BreakBeforeConceptDeclarations: true
BreakInheritanceList: BeforeColon
EmptyLineAfterAccessModifier: Never
EmptyLineBeforeAccessModifier: Always
IndentWrappedFunctionNames: false
IndentRequires: true
InsertTrailingCommas: Wrapped
KeepEmptyLinesAtTheStartOfBlocks: false
MaxEmptyLinesToKeep: 1
PackConstructorInitializers: NextLine
[libc++] Fix merge-conflict in .clang-format
2022-07-28 10:32:02 +02:00
PenaltyIndentedWhitespace: 2
[libc++] Find a clang-format everybody is happy with We decided that we want to use clang-format for libc++ but we haven't decided yet how the code should be formatted. We should probably discuss things on discord. This PR is mostly to show how the clang-format would look like and to commit to one once we decided on it. I'll remove the `<string>` diff when I commit this PR. Reviewed By: ldionne Spies: EricWF, dschuff, krytarowski, fedor.sergeev, aheejin, mstorsjo, phosek, abrachet, libcxx-commits, arichardson Differential Revision: https://reviews.llvm.org/D124789
2022-06-14 20:09:03 +02:00
[libc++] Update clang-format to C++20. We now use clang-format-13 which has the option SpacesInAngles. This allows us to switch the default language version to C++20, which should avoid breaking code when formatting due to the adding of whitespace. For example `u8"foo"` no longer is formatted as `u8 "foo"`. Reviewed By: #libc, ldionne Differential Revision: https://reviews.llvm.org/D112728
2021-10-28 17:48:27 +02:00
Standard: c++20
SpacesInAngles: Leave
[libcxx] Fix max_size() across all containers Summary: The `max_size()` method of containers should respect both the allocator's reported `max_size` and the range of the `difference_type`. This patch makes all containers choose the smallest of those two values. Reviewers: mclow.lists, EricWF Subscribers: cfe-commits Differential Revision: https://reviews.llvm.org/D26885 llvm-svn: 287729
2016-11-23 01:18:56 +00:00
AlwaysBreakTemplateDeclarations: true
clang-format: tweak configuration Update the configuration to reflect the style more accurately. Pointers are tied to the left. Braces are split on classes/structs and functions. llvm-svn: 290857
2017-01-03 04:23:52 +00:00
PointerAlignment: Left
Turn off header sorting and comment formatting llvm-svn: 289177
2016-12-09 03:17:25 +00:00
[libc++][NFC] clang-format <__config> It's not perfect, but it's a lot better than the status quo. Reviewed By: ldionne, #libc Spies: EricWF, aheejin, libcxx-commits, dschuff, krytarowski, fedor.sergeev, mstorsjo, phosek, abrachet Differential Revision: https://reviews.llvm.org/D127644
2022-06-13 17:25:23 +02:00
[NFC][libc++] Update clang-format style. Changes the style as requested by @ldionne in D103368. Reviewed By: ldionne, #libc, Quuxplusone Differential Revision: https://reviews.llvm.org/D109835
2021-09-15 18:29:22 +02:00
# libc++'s preferred indentions of preprocessor statements.
IndentPPDirectives: AfterHash
[libcxx][NFC] adjusts formatting rules This will reduce the amount of noisy feedback during reviews. Differential Revision: https://reviews.llvm.org/D99691
2021-03-31 22:46:28 +00:00
# libc++ has some long names so we need more than the 80 column limit imposed by LLVM style, for sensible formatting
ColumnLimit: 120
Reference in New Issue Copy Permalink