From 3be61bfb079b0f628ee8d629128a0a62ca2c0d65 Mon Sep 17 00:00:00 2001
From: PJ Dietz <pjdietz@gmail.com>
Date: Sun, 13 Jul 2014 09:22:13 -0400
Subject: [PATCH] Fix phpdoc in Handler

---
 phpdoc.dist.xml                    |  2 +-
 src/pjdietz/WellRESTed/Handler.php | 18 +++++++++++++-----
 2 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/phpdoc.dist.xml b/phpdoc.dist.xml
index 84a5403..3595b64 100644
--- a/phpdoc.dist.xml
+++ b/phpdoc.dist.xml
@@ -12,7 +12,7 @@
         <target>docs</target>
     </transformer>
     <transformations>
-        <template name="responsive" />
+        <template name="clean" />
     </transformations>
     <files>
         <directory>src</directory>
diff --git a/src/pjdietz/WellRESTed/Handler.php b/src/pjdietz/WellRESTed/Handler.php
index 070fb10..e994f97 100644
--- a/src/pjdietz/WellRESTed/Handler.php
+++ b/src/pjdietz/WellRESTed/Handler.php
@@ -19,11 +19,11 @@ use pjdietz\WellRESTed\Interfaces\RequestInterface;
  * Responds to a request based on the HTTP method.
  *
  * To use Handler, create a subclass and implement the methods for any HTTP
- * verbs you would like to support. (get() for GET, post() for POST, etc).
+ * verbs you would like to support. (`get()` for GET, `post()` for POST, etc).
  *
- * - Access the request via the protected member $this->request
- * - Access a map of arguments via $this->args (e.g., URI path variables)
- * - Modify $this->response to provide the response the instance will return
+ * - Access the request via the protected member `$this->request`
+ * - Access a map of arguments via `$this->args` (e.g., URI path variables)
+ * - Modify `$this->response` to provide the response the instance will return
  */
 abstract class Handler implements HandlerInterface
 {
@@ -35,6 +35,8 @@ abstract class Handler implements HandlerInterface
     protected $response;
 
     /**
+     * Return the handled response.
+     *
      * @param RequestInterface $request
      * @param array|null $args
      * @return ResponseInterface
@@ -179,7 +181,13 @@ abstract class Handler implements HandlerInterface
         $this->addAllowHeader();
     }
 
-    /** @return array of method names supported by the handler. */
+    /**
+     * Return an array of HTTP verbs this handler supports.
+     *
+     * For example, to support GET and POST, return array("GET","POST");
+     *
+     * @return array
+     */
     protected function getAllowedMethods()
     {
     }