<div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr">Hi all,<div><br></div><div>Yesterday I was (manually) going through all the clang format options and crafting a format file for our organisation. While doing that I wondered: wouldn't it be great if the documentation of clang-format was actually a .clang-format file!</div><div><br></div><div>I.e. the docs could be a simple as:</div><div><br></div></div></div></div><blockquote style="margin:0px 0px 0px 40px;border:none;padding:0px"><div><div><div><div><font face="monospace, monospace" size="1">AlignTrailingComments: false</font></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1"><br></font></div></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1"># If true, aligns trailing comments.</font></div></div></div></div></div><div><div><div><div><font face="monospace, monospace" size="1"># </font></div></div></div></div><div><div><div><div><font face="monospace, monospace" size="1"># true:                                   false:</font></div></div></div></div><div><div><div><div><font face="monospace, monospace" size="1"># int a;     // My comment a      vs.     int a; // My comment a</font></div></div></div></div><div><div><div><div><font face="monospace, monospace" size="1"># int b = 2; // comment  b                int b = 2; // comment about b</font></div></div></div></div><div><div><div><div><font face="monospace, monospace" size="1"><br></font></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1">AllowAllParametersOfDeclarationOnNextLine: true</font></div></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1"><br></font></div></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1"># If the function declaration doesn’t fit on a line, allow putting all parameters of a function </font></div></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1"># declaration onto the next line even if BinPackParameters is false.</font></div></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1">#</font></div></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1"># true:</font></div></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1"># void myFunction(</font></div></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1">#     int a, int b, int c, int d, int e);</font></div></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1"># </font></div></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1"># false:</font></div></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1"># void myFunction(int a,</font></div></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1">#                 int b,</font></div></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1">#                 int c,</font></div></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1">#                 int d,</font></div></div></div></div></div><div><div><div><div><div><font face="monospace, monospace" size="1">#                 int e);</font></div></div></div></div></div></blockquote><div dir="ltr"><div dir="ltr"><div dir="ltr"><div><br></div><div>I understand this isn't markdown, but this would tremendously improve the ease of making your "own" clang-format specs.</div><div><br></div><div>Right now are some websites which help you with this:</div><div><ul><li><a href="https://zed0.co.uk/clang-format-configurator/">https://zed0.co.uk/clang-format-configurator/</a><br></li><li><a href="https://clangformat.com/">https://clangformat.com/</a></li></ul></div><div>But neither supports v8, for example, nor do they contain the actual docs of the functions...</div><div><br></div><div>Greetings,</div><div><br></div><div>Bram</div><div dir="ltr" class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div style="color:rgb(0,0,0);font-size:12px;font-family:CourierNewPSMT"><div style="font-size:12.8px;margin:8px 0px 0px;padding:0px;color:rgb(34,34,34);font-family:Roboto,RobotoDraft,Helvetica,Arial,sans-serif"><div><div></div><div></div></div></div><div style="font-size:12.8px;color:rgb(34,34,34);font-family:Roboto,RobotoDraft,Helvetica,Arial,sans-serif"></div></div></div></div></div></div></div></div></div></div></div></div>