Issue#1511: Added docs for new rule to enforce position of assignment operator in variable declarations.

Author: JHertz5

docs/rule_groups/structure_rule_group.rst

@@ -188,6 +188,7 @@ Rules Enforcing Structure Rule Group
 * `variable_007 <../variable_rules.html#variable-007>`_
 * `variable_015 <../variable_rules.html#variable-015>`_
 * `variable_017 <../variable_rules.html#variable-017>`_
+* `variable_018 <../variable_rules.html#variable-018>`_
 * `variable_assignment_006 <../variable_assignment_rules.html#variable-assignment-006>`_
 * `variable_assignment_007 <../variable_assignment_rules.html#variable-assignment-007>`_
 * `variable_assignment_008 <../variable_assignment_rules.html#variable-assignment-008>`_

docs/variable_rules.rst

@@ -301,6 +301,31 @@ This rule checks the structure of variable constraints.
        element2(3 downto 0)
      );
 
+variable_018
+############
+
+|phase_1| |error| |structure|
+
+This rule checks the **:=** is on the same line as the **variable** keyword.
+
+**Violation**
+
+.. code-block:: vhdl
+
+   variable size : integer
+      := 1;
+   variable width : integer
+      := 32;
+
+**Fix**
+
+.. code-block:: vhdl
+
+   variable size    : integer :=
+     1;
+   variable width   : integer :=
+     32
+
 variable_100
 ############
 

vsg/rules/variable/rule_018.py

@@ -9,7 +9,7 @@
 
 class rule_018(Rule):
     """
-    This rule checks the **:=** is on the same line at the **variable** keyword.
+    This rule checks the **:=** is on the same line as the **variable** keyword.
 
     **Violation**