coding style: document how to break a function declaration

diff --git a/docs/CODING_STYLE.md b/docs/CODING_STYLE.md
index 119b9a26407d6a282f6b97cac70ec579e7f7032c..11cc6222e358046efaf5c3cbae371d6167973c62 100644 (file)
--- a/docs/CODING_STYLE.md
+++ b/docs/CODING_STYLE.md
@@ -25,6 +25,17 @@ layout: default
   note that emacs loads `.dir-locals.el` automatically, but vim needs to be
   configured to load `.vimrc`, see that file for instructions.
 
+- If you break a function declaration over multiple lines, do it like this:
+
+  ```c
+  void some_function(
+                  int foo,
+                  bool bar,
+                  char baz) {
+
+          int a, b, c;
+  ```
+
 - Try to write this:
 
   ```c