Added usage section to class level docblock.

- Also aligned constant definitions.

Author: weierophinney

src/RequestMethodInterface.php

@@ -1,18 +1,34 @@
 <?php
+
 namespace Psr\Http\Message;
 
 /**
- * The interface defines constants request method
+ * Defines constants for common HTTP request methods.
+ *
+ * Usage:
+ *
+ * <code>
+ * class RequestFactory implements RequestMethodInterface
+ * {
+ *     public static function factory(
+ *         $uri = '/',
+ *         $method = self::METHOD_GET,
+ *         $data = []
+ *     ) {
+ *     }
+ * }
+ * </code>
  */
-interface RequestMethodInterface {
-    const METHOD_HEAD = 'HEAD';
-    const METHOD_GET = 'GET';
-    const METHOD_POST = 'POST';
-    const METHOD_PUT = 'PUT';
-    const METHOD_PATCH = 'PATCH';
-    const METHOD_DELETE = 'DELETE';
-    const METHOD_PURGE = 'PURGE';
+interface RequestMethodInterface
+{
+    const METHOD_HEAD    = 'HEAD';
+    const METHOD_GET     = 'GET';
+    const METHOD_POST    = 'POST';
+    const METHOD_PUT     = 'PUT';
+    const METHOD_PATCH   = 'PATCH';
+    const METHOD_DELETE  = 'DELETE';
+    const METHOD_PURGE   = 'PURGE';
     const METHOD_OPTIONS = 'OPTIONS';
-    const METHOD_TRACE = 'TRACE';
+    const METHOD_TRACE   = 'TRACE';
     const METHOD_CONNECT = 'CONNECT';
 }