aboutsummaryrefslogtreecommitdiffstats
path: root/docs/style-guide.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/style-guide.rst')
-rw-r--r--docs/style-guide.rst11
1 files changed, 10 insertions, 1 deletions
diff --git a/docs/style-guide.rst b/docs/style-guide.rst
index b9f06012..99db8147 100644
--- a/docs/style-guide.rst
+++ b/docs/style-guide.rst
@@ -155,7 +155,7 @@ Whitespace in Expressions
Avoid extraneous whitespace in the following situations:
-Immediately inside parenthesis, brackets or braces.
+Immediately inside parenthesis, brackets or braces, with the exception of single-line function declarations.
Yes::
@@ -165,6 +165,10 @@ No::
spam( ham[ 1 ], Coin( { name: "ham" } ) );
+Exception::
+
+ function singleLine() { spam(); }
+
Immediately before a comma, semicolon:
Yes::
@@ -482,6 +486,11 @@ No::
}
}
+When declaring short functions with a single statement, it is permissible to do it on a single line.
+
+Permissible::
+
+ function shortFunction() { doSomething(); }
These guidelines for function declarations are intended to improve readability.
Authors should use their best judgement as this guide does not try to cover all