Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

Doc update.

  • Loading branch information...
1 parent 7146dd1 commit 0202fbac79837ee3ff17979a90ffeb5bc80e5e4f @hassy committed
Showing with 21 additions and 21 deletions.
  1. +21 −21
@@ -1,45 +1,45 @@
-# http-twiddle -- send & twiddle & resend HTTP requests
+# http-twiddle
-This is a program for testing hand-written HTTP requests. You write
-your request in an Emacs buffer (using http-twiddle-mode) and then
-press `C-c C-c' each time you want to try sending it to the server.
-This way you can interactively debug the requests. To change port or
-destination do `C-u C-c C-c'.
+This Emacs addon is useful for interactive testing and debugging hand-written HTTP requests:
-The mode is activated by `M-x http-twiddle-mode' or automatically
-when opening a filename ending with .http-twiddle.
+1. Activate `http-twiddle-mode` with `M-x`.
+2. Write your request.
+3. `C-c C-c` (re)sends the request.
+(`C-u C-c C-c` to change the destination or port.)
The request can either be written from scratch or you can paste it
from a snoop/tcpdump and then twiddle from there.
-See the documentation for the `http-twiddle-mode' and
-`http-twiddle-mode-send' functions below for more details and try
-`M-x http-twiddle-mode-demo' for a simple get-started example.
+The mode will also activate automatically when opening a filename ending with `.http-twiddle`.
## Examples
+Try `M-x http-twiddle-mode-demo` in Emacs for a simple get-started example.
If the Content-Length header is not written out (like in the examples below) it'll be added automatically on send.
### GET:
-GET /user/bob/ HTTP/1.1
-[blank line here]
+ GET /user/bob/ HTTP/1.1
+ Host:
+ [blank line here]
### POST:
-POST /user/create/ HTTP/1.1
-Content-Type: text/xml
-Connection: close
+ POST /user/create/ HTTP/1.1
+ Host:
+ Content-Type: text/xml
+ Connection: close
+ <user><name>Bob</name><email></email></user>
## About
Version 1.0 was written by Luke Gorrie <> in February 2006 and released to the public domain.
-Extended and maintained by Hasan Veldstra <> since September 2008.
+Extended and maintained by Hasan Veldstra <> since September 2008.
Homepage: <>

0 comments on commit 0202fba

Please sign in to comment.
Something went wrong with that request. Please try again.