Add alternative "same location" syntax.

Change-Id: I70c89275010fa8ba5f22d62dd15de72ee36d1e33
Signed-off-by: Piotr Sikora <[email protected]>

Author: PiotrSikora

README.md

@@ -23,8 +23,47 @@ releases:
 - 1.3.x (tested with 1.3.0 to 1.3.9).
 
 
-Configuration directives
-========================
+Configuration directives (same location syntax)
+===============================================
+fastcgi_cache_purge
+-------------------
+* **syntax**: `fastcgi_cache_purge on|off|<method> [from all|<ip> [.. <ip>]]`
+* **default**: `none`
+* **context**: `location`
+
+Allow purging of selected pages from `FastCGI`'s cache.
+
+
+proxy_cache_purge
+-----------------
+* **syntax**: `fastcgi_cache_purge on|off|<method> [from all|<ip> [.. <ip>]]`
+* **syntax**: `proxy_cache_purge zone_name key`
+* **default**: `none`
+* **context**: `location`
+
+Allow purging of selected pages from `proxy`'s cache.
+
+
+scgi_cache_purge
+----------------
+* **syntax**: `scgi_cache_purge on|off|<method> [from all|<ip> [.. <ip>]]`
+* **default**: `none`
+* **context**: `location`
+
+Allow purging of selected pages from `SCGI`'s cache.
+
+
+uwsgi_cache_purge
+-----------------
+* **syntax**: `uwsgi_cache_purge on|off|<method> [from all|<ip> [.. <ip>]]`
+* **default**: `none`
+* **context**: `location`
+
+Allow purging of selected pages from `uWSGI`'s cache.
+
+
+Configuration directives (separate location syntax)
+===================================================
 fastcgi_cache_purge
 -------------------
 * **syntax**: `fastcgi_cache_purge zone_name key`
@@ -61,8 +100,24 @@ uwsgi_cache_purge
 Sets area and key used for purging selected pages from `uWSGI`'s cache.
 
 
-Sample configuration
-====================
+Sample configuration (same location syntax)
+===========================================
+    http {
+        proxy_cache_path  /tmp/cache  keys_zone=tmpcache:10m;
+
+        server {
+            location / {
+                proxy_pass         http://127.0.0.1:8000;
+                proxy_cache        tmpcache;
+                proxy_cache_key    $uri$is_args$args;
+                proxy_cache_purge  PURGE from 127.0.0.1;
+            }
+        }
+    }
+
+
+Sample configuration (separate location syntax)
+===============================================
     http {
         proxy_cache_path  /tmp/cache  keys_zone=tmpcache:10m;
 

TODO.md

@@ -1,24 +1,3 @@
-Features that sooner or later will be added to `ngx_cache_purge`:
-
-* Add support for alternative in-location cache purges using specified
-  request method, with following configuration syntax:
-
-      location / {
-          proxy_pass         http://127.0.0.1:8000;
-          proxy_cache        tmpcache;
-          proxy_cache_key    $uri$is_args$args;
-          proxy_cache_purge  DELETE from 127.0.0.1;
-      }
-
-  This will allow for purges using:
-
-      curl -X DELETE http://example.com/logo.jpg
-
-  instead of:
-
-      curl http://example.com/purge/logo.jpg
-
-
 Features that __will not__ be added to `ngx_cache_purge`:
 
 * Support for prefixed purges (`/purge/images/*`).