From: Ben Darnell <ben@bendarnell.com>
Date: Sun, 10 May 2015 01:55:00 +0000 (-0400)
Subject: Document RequestHandler.patch.
X-Git-Tag: v4.2.0b1~4
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=01c78ebfcc993ff4f1d8336c2c45844fe9dab60e;p=thirdparty%2Ftornado.git

Document RequestHandler.patch.

Add an example for overriding SUPPORTED_METHODS.
---

diff --git a/docs/web.rst b/docs/web.rst
index 0e4987a9a..c96972478 100644
--- a/docs/web.rst
+++ b/docs/web.rst
@@ -25,11 +25,21 @@
    These methods can be made asynchronous with one of the following
    decorators: `.gen.coroutine`, `.return_future`, or `asynchronous`.
 
+   To support a method not on this list, override the class variable
+   ``SUPPORTED_METHODS``::
+
+     class WebDAVHandler(RequestHandler):
+         SUPPORTED_METHODS = RequestHandler.SUPPORTED_METHODS + ('PROPFIND',)
+
+         def propfind(self):
+             pass
+
    .. automethod:: RequestHandler.get
+   .. automethod:: RequestHandler.head
    .. automethod:: RequestHandler.post
-   .. automethod:: RequestHandler.put
    .. automethod:: RequestHandler.delete
-   .. automethod:: RequestHandler.head
+   .. automethod:: RequestHandler.patch
+   .. automethod:: RequestHandler.put
    .. automethod:: RequestHandler.options
 
    Input
diff --git a/tornado/web.py b/tornado/web.py
index 9bc12933f..0a50f7935 100644
--- a/tornado/web.py
+++ b/tornado/web.py
@@ -144,12 +144,12 @@ May be overridden by passing a ``min_version`` keyword argument.
 .. versionadded:: 3.2.1
 """
 
+
 class RequestHandler(object):
-    """Subclass this class and define `get()` or `post()` to make a handler.
+    """Base class for HTTP request handlers.
 
-    If you want to support more methods than the standard GET/HEAD/POST, you
-    should override the class variable ``SUPPORTED_METHODS`` in your
-    `RequestHandler` subclass.
+    Subclasses must define at least one of the methods defined in the
+    "Entry points" section below.
     """
     SUPPORTED_METHODS = ("GET", "HEAD", "POST", "DELETE", "PATCH", "PUT",
                          "OPTIONS")