> On Apr 4, 2016, at 7:18 PM, Omeed Safaee-Rad via swift-dev > <swift-dev@swift.org> wrote: > > Hello Swift! :)
Hi Omeed, > > First off, thank you for the wonderful project! > > I noticed that a number of C++ files in the Swift compiler could use a pass > of clang-format. What is the general policy on this? The general policy is no bulk reformatting. > Given that clang-format can be invasive (affecting commit history - `git > blame` that is), my understanding is that it’s use is on a case by case basis > (if a file has a short history for example). Noticed this reasoning in a > recent commit message (d03539c1277f4379d17afb6712bebc2c7ddf789a). It’s fine to reformat lines that you otherwise change, but as you mention going beyond that can make it more difficult to understand the history in a file. There’s a tool called git-clang-format which makes it easy to run clang-format but only touch the lines you’ve already modified. It lives in $SWIFT_SOURCE_ROOT/clang/tools/clang-format. By adding that to your PATH, along with having clang-format itself in your path, you are able to reformat the lines you have already changed by doing: git add files-i-have-changed.cpp git clang-format The result will be unstaged lines with the formatting changes, which you can review with ‘git diff’ before staging those updated lines with ‘git add’. Mark > If there is interest for such pull request(s), how should they be split up? > Per file? > > Sincerely, > > Omeed > _______________________________________________ > swift-dev mailing list > swift-dev@swift.org > https://lists.swift.org/mailman/listinfo/swift-dev _______________________________________________ swift-dev mailing list swift-dev@swift.org https://lists.swift.org/mailman/listinfo/swift-dev