clang-format.rst (05909cd9a0c8811731b38697af13075e8954314f) clang-format.rst (e0a45cda66423e56d15b219e4da4f4d530cf9236)
1.. _clangformat:
2
3clang-format
4============
5
6``clang-format`` is a tool to format C/C++/... code according to
7a set of rules and heuristics. Like most tools, it is not perfect
8nor covers every single case, but it is good enough to be helpful.

--- 83 unchanged lines hidden (view full) ---

92for multi-line macros (and aligning their backslashes), etc.
93
94Remember that you can always tweak the changes afterwards in those cases
95where the tool did not do an optimal job. But as a first approximation,
96it can be very useful.
97
98There are integrations for many popular text editors. For some of them,
99like vim, emacs, BBEdit and Visual Studio you can find support built-in.
1.. _clangformat:
2
3clang-format
4============
5
6``clang-format`` is a tool to format C/C++/... code according to
7a set of rules and heuristics. Like most tools, it is not perfect
8nor covers every single case, but it is good enough to be helpful.

--- 83 unchanged lines hidden (view full) ---

92for multi-line macros (and aligning their backslashes), etc.
93
94Remember that you can always tweak the changes afterwards in those cases
95where the tool did not do an optimal job. But as a first approximation,
96it can be very useful.
97
98There are integrations for many popular text editors. For some of them,
99like vim, emacs, BBEdit and Visual Studio you can find support built-in.
100For instructions, read the appropiate section at:
100For instructions, read the appropriate section at:
101
102 https://clang.llvm.org/docs/ClangFormat.html
103
104For Atom, Eclipse, Sublime Text, Visual Studio Code, XCode and other
105editors and IDEs you should be able to find ready-to-use plugins.
106
107For this use case, consider using a secondary ``.clang-format``
108so that you can tweak a few options. See clangformatextra_.

--- 76 unchanged lines hidden ---
101
102 https://clang.llvm.org/docs/ClangFormat.html
103
104For Atom, Eclipse, Sublime Text, Visual Studio Code, XCode and other
105editors and IDEs you should be able to find ready-to-use plugins.
106
107For this use case, consider using a secondary ``.clang-format``
108so that you can tweak a few options. See clangformatextra_.

--- 76 unchanged lines hidden ---