PEAR/Documentation: minor consistency fixes

* Verified that the contents of `<standard>` elements is consistently indented (with four spaces).
* Verified that all `<code>` `title` attributes use proper capitalization and punctuation and are prefixed with "Valid" or "Invalid".

Author: jrfnl

src/Standards/PEAR/Docs/Commenting/FileCommentStandard.xml

@@ -1,7 +1,7 @@
 <documentation title="File Comments">
     <standard>
     <![CDATA[
-    Files must have a non-empty doc comment.  The short description must be on the second line of the comment.  Each description must have one blank comment line before and after.  There must be one blank line before the tags in the comments.  There must be a category, package, author, license, and link tag.  There may only be one category, package, subpackage, license, version, since and deprecated tag.  The tags must be in the order category, package, subpackage, author, copyright, license, version, link, see, since, and deprecated.  The php version must be specified.
+    Files must have a non-empty doc comment.  The short description must be on the second line of the comment.  Each description must have one blank comment line before and after.  There must be one blank line before the tags in the comments.  There must be a category, package, author, license, and link tag.  There may only be one category, package, subpackage, license, version, since and deprecated tag.  The tags must be in the order category, package, subpackage, author, copyright, license, version, link, see, since, and deprecated.  The PHP version must be specified.
     ]]>
     </standard>
     <code_comparison>
@@ -267,7 +267,7 @@
  */
         ]]>
         </code>
-        <code title="Invalid: No php version specified.">
+        <code title="Invalid: No PHP version specified.">
         <![CDATA[
 <?php
 /**

src/Standards/PEAR/Docs/Files/IncludingFileStandard.xml

@@ -10,12 +10,12 @@
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: used as statement">
+        <code title="Valid: Used as statement.">
         <![CDATA[
 require_once 'PHP/CodeSniffer.php';
         ]]>
         </code>
-        <code title="Invalid: used as function">
+        <code title="Invalid: Used as function.">
         <![CDATA[
 require_once<em>(</em>'PHP/CodeSniffer.php'<em>)</em>;
         ]]>

src/Standards/PEAR/Docs/Functions/FunctionCallSignatureStandard.xml

@@ -1,16 +1,16 @@
 <documentation title="Function Calls">
     <standard>
     <![CDATA[
-      Functions should be called with no spaces between the function name, the opening parenthesis, and the first parameter; and no space between the last parameter, the closing parenthesis, and the semicolon.
+    Functions should be called with no spaces between the function name, the opening parenthesis, and the first parameter; and no space between the last parameter, the closing parenthesis, and the semicolon.
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: spaces between parameters">
+        <code title="Valid: Spaces between parameters.">
         <![CDATA[
 $var = foo($bar, $baz, $quux);
         ]]>
         </code>
-        <code title="Invalid: additional spaces used">
+        <code title="Invalid: Additional spaces used.">
         <![CDATA[
 $var = foo<em> </em>(<em> </em>$bar, $baz, $quux<em> </em>)<em> </em>;
         ]]>

src/Standards/PEAR/Docs/Functions/ValidDefaultValueStandard.xml

@@ -5,15 +5,15 @@
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: argument with default value at end of declaration">
+        <code title="Valid: Argument with default value at end of declaration.">
         <![CDATA[
 function connect($dsn, <em>$persistent = false</em>)
 {
     ...
 }
         ]]>
         </code>
-        <code title="Invalid: argument with default value at start of declaration">
+        <code title="Invalid: Argument with default value at start of declaration.">
         <![CDATA[
 function connect(<em>$persistent = false</em>, $dsn)
 {

src/Standards/PEAR/Docs/NamingConventions/ValidClassNameStandard.xml

@@ -5,14 +5,14 @@
     ]]>
     </standard>
     <code_comparison>
-        <code title="Examples of valid class names">
+        <code title="Valid: Examples of valid class names.">
         <![CDATA[
 Log
 Net_Finger
 HTML_Upload_Error
         ]]>
         </code>
-        <code title="Examples of invalid class names">
+        <code title="Invalid: Examples of invalid class names.">
         <![CDATA[
 log
 NetFinger

src/Standards/PEAR/Docs/NamingConventions/ValidFunctionNameStandard.xml

@@ -5,15 +5,15 @@
     ]]>
     </standard>
     <code_comparison>
-        <code title="Examples of valid function names">
+        <code title="Valid: Examples of valid function names.">
         <![CDATA[
 connect()
 getData()
 buildSomeWidget()
 XML_RPC_serializeData()
         ]]>
         </code>
-        <code title="Examples of invalid function names">
+        <code title="Invalid: Examples of invalid function names.">
         <![CDATA[
 Connect()
 get_data()

src/Standards/PEAR/Docs/NamingConventions/ValidVariableNameStandard.xml

@@ -15,7 +15,7 @@ class Foo
 }
         ]]>
         </code>
-        <code title="Invalid: underscores used on public/protected variables and not used on private variables.">
+        <code title="Invalid: Underscores used on public/protected variables and not used on private variables.">
         <![CDATA[
 class Foo
 {