7 files changed, 40 insertions, 0 deletions

diff --git a/doc-src/index.html b/doc-src/index.html
index 04113609..dbbee537 100644
--- a/doc-src/index.html
+++ b/doc-src/index.html
@@ -1,6 +1,7 @@
 
 
 * [Introduction](@!urlTo("intro.html")!@)
+* [Interception](@!urlTo("interception.html")!@)
 * [Client-side replay](@!urlTo("clientreplay.html")!@)
 * [Server-side replay](@!urlTo("serverreplay.html")!@)
 * [Sticky cookies](@!urlTo("stickycookies.html")!@)
diff --git a/doc-src/index.py b/doc-src/index.py
index c2d995a5..b6a0caca 100644
--- a/doc-src/index.py
+++ b/doc-src/index.py
@@ -56,6 +56,7 @@ ns.filt_help = filt_help
 pages = [
     Page("index.html", "Index"),
     Page("intro.html", "Introduction"),
+    Page("interception.html", "Interception"),
     Page("clientreplay.html", "Client-side replay"),
     Page("serverreplay.html", "Server-side replay"),
     Page("stickycookies.html", "Sticky cookies"),
diff --git a/doc-src/interception.html b/doc-src/interception.html
new file mode 100644
index 00000000..cf5b7439
--- /dev/null
+++ b/doc-src/interception.html
@@ -0,0 +1,38 @@
+
+__mitmproxy__'s interception functionality lets you pause an HTTP request or
+response, inspect and modify it, and then accept it to send it on to the server
+or client. Because this is an interactive function, it's only present in
+__mitmproxy__, not in __mitmdump__. 
+
+
+### 1: Set an interception pattern
+
+<img src="@!urlTo('intercept-filt.png')!@"/>
+
+We press __i__ to set an interception pattern. In this case, the __~q__ filter
+pattern tells __mitmproxy__ to intercept all requests. For complete filter
+syntax, see the [Filter expressions](@!urlTo("filters.html")!@) section of this
+document, or the built-in help function in __mitmproxy__.
+
+### 2: Intercepted conenctions are indicated with a red exclamation mark:
+
+<img src="@!urlTo('intercept-mid.png')!@"/>
+
+### 3: You can now view and modify the request:
+
+<img src="@!urlTo('intercept-options.png')!@"/>
+
+In this case, we viewd the request by selecting it, pressed __e__ for "edit"
+and __m__ for "method" to change the HTTP request method.
+
+### 4: Accept the intercept to continue
+
+<img src="@!urlTo('intercept-result.png')!@"/>
+
+Finally, we press __a__ to accept the modified request, which is then sent on
+to the server. In this case, we changed the request from an HTTP GET to to
+OPTIONS, and Google's server has responded with a 405 "Method not allowed". 
+
+
+
+
diff --git a/doc-src/screenshots/intercept-filt.png b/doc-src/screenshots/intercept-filt.png
new file mode 100644
index 00000000..26884511
--- /dev/null
+++ b/doc-src/screenshots/intercept-filt.png
diff --git a/doc-src/screenshots/intercept-mid.png b/doc-src/screenshots/intercept-mid.png
new file mode 100644
index 00000000..7c8049b0
--- /dev/null
+++ b/doc-src/screenshots/intercept-mid.png
diff --git a/doc-src/screenshots/intercept-options.png b/doc-src/screenshots/intercept-options.png
new file mode 100644
index 00000000..2d9d6ece
--- /dev/null
+++ b/doc-src/screenshots/intercept-options.png
diff --git a/doc-src/screenshots/intercept-result.png b/doc-src/screenshots/intercept-result.png
new file mode 100644
index 00000000..f02aea7e
--- /dev/null
+++ b/doc-src/screenshots/intercept-result.png