Ruleset: improve inline documentation

Author: jrfnl

PHPCSDev/ruleset.xml

@@ -88,8 +88,7 @@
     <!-- Ensure exactly one blank line before each property declaration. -->
     <rule ref="Squiz.WhiteSpace.MemberVarSpacing"/>
 
-    <!-- Ensure exactly one blank line before each function declaration, two blank lines
-         before the first function and 0 after the last. -->
+    <!-- Ensure exactly one blank line before each function declaration and 0 after the last. -->
     <rule ref="Squiz.WhiteSpace.FunctionSpacing">
         <properties>
             <property name="spacing" value="1"/>
@@ -98,6 +97,7 @@
         </properties>
     </rule>
 
+    <!-- No spacing on the inside of arbitrary parentheses. -->
     <rule ref="Generic.WhiteSpace.ArbitraryParenthesesSpacing"/>
 
     <!-- Align the equal operator in assignment blocks. -->
@@ -107,6 +107,7 @@
         </properties>
     </rule>
 
+    <!-- Prefer include_once/require_once over include/require. -->
     <rule ref="PEAR.Files.IncludingFile"/>
     <rule ref="PEAR.Files.IncludingFile.UseInclude">
         <severity>0</severity>