Clean up PEAR Class Declaration sniff doc

Per advice from @jrfnl, clarified some language and combined some
invalid examples to tighten the docs for this sniff.

Author: braindawg

src/Standards/PEAR/Docs/Classes/ClassDeclarationStandard.xml

@@ -1,7 +1,7 @@
-<documentation title="Class Declarations">
+<documentation title="Class Declaration">
     <standard>
     <![CDATA[
-    The opening brace of a class must be on the line after the definition by itself.
+    The opening brace of an OO structure must be on the line directly after the OO signature. The opening brace must be on a line by itself.
     ]]>
     </standard>
     <code_comparison>
@@ -12,24 +12,12 @@ class Foo
 }
         ]]>
         </code>
-        <code title="Invalid: Opening brace on same line as declaration.">
+        <code title="Invalid: Opening brace on incorrect line.">
         <![CDATA[
-class Foo <em>{</em>
+class BraceOnSignatureLine <em>{</em>
 }
-        ]]>
-        </code>
-    </code_comparison>
-    <code_comparison>
-        <code title="Valid: Opening brace on the correct line.">
-        <![CDATA[
-class Foo
-<em>{</em>
-}
-        ]]>
-        </code>
-        <code title="Invalid: Newline between declaration and opening brace.">
-        <![CDATA[
-class Foo
+
+class BlankLineBetween
 <em></em>
 {
 }
@@ -44,7 +32,7 @@ class Foo
 }
         ]]>
         </code>
-        <code title="Invalid: Opening brace is not alone on its line.">
+        <code title="Invalid: Opening brace is not on a line by itself.">
         <![CDATA[
 class Foo
 {<em> public function __construct() {}</em>
@@ -54,40 +42,32 @@ class Foo
     </code_comparison>
     <standard>
     <![CDATA[
-    The opening brace must be indented to the same depth as the class declaration.
+    The opening brace must be indented to the same depth as the OO structure's declaration.
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: Opening brace indentation depth matches the class definition.">
+        <code title="Valid: Opening brace indentation depth matches the OO structure signature's depth.">
         <![CDATA[
-if (!class_exists('Foo')) {
-    abstract class Foo
+if (!class_exists('IndentedFourSpaces')) {
+    abstract class IndentedFourSpaces
     <em>{</em>
     }
 }
-        ]]>
-        </code>
-        <code title="Invalid: Expected 4 spaces before opening brace; 0 found.">
-        <![CDATA[
-if (!class_exists('Foo')) {
-    abstract class Foo
+        
+class NotIndented
 <em>{</em>
-}
 }
         ]]>
         </code>
-    </code_comparison>
-    <code_comparison>
-        <code title="Valid: Opening brace indentation depth matches the class definition.">
+        <code title="Invalid: Opening brace indentation depth does not match the OO structure signature's depth.">
         <![CDATA[
-class Foo
+if (!class_exists('IndentedFourSpaces')) {
+    abstract class IndentedFourSpaces
 <em>{</em>
 }
-        ]]>
-        </code>
-        <code title="Invalid: Expected 0 spaces before opening brace; 4 found.">
-        <![CDATA[
-class Foo
+}
+        
+class NotIndented
     <em>{</em>
     }
         ]]>