doc/style(9): describe local variables rules

1 files changed, 7 insertions, 0 deletions

diff --git a/doc/style.9.txt b/doc/style.9.txt
index 93683d8..8d87efb 100644
--- a/doc/style.9.txt
+++ b/doc/style.9.txt
@@ -492,6 +492,13 @@ error_subobj:
 }
 --------------------------------------------------------------------------------
 
+Local variables
+~~~~~~~~~~~~~~~
+
+Local variables must be declared at the beginning of their scope. An empty
+line separates them from the function body. A notable exception is iterators,
+which may be declared inside loop statements.
+
 Common functions and methods
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~