Formating tools

[psychocoderHPC]

Here you can add tools those help to format the source code.
The goal is that we find a formatting tool to automate the formation.

[psychocoderHPC]

tool: clang format

Online tool to configure the style: https://zed0.co.uk/clang-format-configurator/#
pull request: #32

[psychocoderHPC]

Let me bring up this discussion and push the usage of #32.
We also have a style file suggestion in

• alpaka Improve clang-format support alpaka-group/alpaka#781
• and a derived style in mallocMC clang-format alpaka-group/mallocMC#172

IMO the most important question is, "Should we stop relaying on the nice template rules to be able to use clang format?"
Our current style guide: https://github.com/ComputationalRadiationPhysics/contributing/blob/master/codingGuideLines/cpp.md

The goal should be that we come soon to a automated formation because we have more and more distributed developer and a hand full projects with different styles.

@sbastrakov @ax3l @jkelling @SimeonEhrig @bernhardmgruber @BenjaminW3 @bertwesarg @j-stephan @ComputationalRadiationPhysics/alpaka-developers @ComputationalRadiationPhysics/picongpu-developers

Please answer the question: Do we should get rid of all formatting rules we can not apply with clang-format to provide a style file for all our projects.

[psychocoderHPC]

Do we should get rid of all formatting rules we can not apply with clang-format to provide a style file for all our projects.

IMO yes we should.

Reasons are:

• it is not possible to maintain all projects with different style
• new developer will have it easier to contribute

[BenjaminW3]

Yes. I already proposed one for alpaka.

[pordyna]

I think that would make a lot of sense.

[jkelling]

Yes.

[bernhardmgruber]

Yes, we should use an automated formatting tool and clang-format seems to be the dominant choice here.

As for the guidelines that cannot be enforced using clang-format: you can still keep them and apply them once clang-format supports the corresponding options. In the interim, we could mark the rules as "currently not enforceable but we wish we could have it".

[SimeonEhrig]

By default my Emacs runs clang-format after each save, so: Yes

[BenjaminW3]

We have to keep in mind that we do not only agree on a specific set of clang-format rules but also on the specific clang-format version because each version produces slightly different results and newer versions support more features.

I would vote for clang-format 10 😉

[sbastrakov]

I also think we should be using clang-format.

[j-stephan]

I agree!

[bernhardmgruber]

As a sidenote: the template formatting proposed by the style guide seemed fairly easy to implement in clang-format. Here is a diff: llvm/llvm-project@master...bernhardmgruber:format

[psychocoderHPC]

As a sidenote: the template formatting proposed by the style guide seemed fairly easy to implement in clang-format. Here is a diff: llvm/llvm-project@master...bernhardmgruber:format

If you can add an option in clang format for that and push a PR to clang/llvm it would be wonderful. Until it goes mainline we can aggree on e.g. clang-format 10.