Merge pull request #555 from Denton-L/single-line-functions

Added a Clause in Style Guide about Single Line Function Declarations

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