Simplify example instructions and fix broken examples

Also convert to AsciiDoc while we're at it.

1 files changed, 28 insertions, 0 deletions

diff --git a/examples/echo_post/README.asciidoc b/examples/echo_post/README.asciidoc
new file mode 100644
index 0000000..144e216
--- /dev/null
+++ b/examples/echo_post/README.asciidoc
@@ -0,0 +1,28 @@
+= POST parameter echo example
+
+To try this example, you need GNU `make` and `git` in your PATH.
+
+To build and run the example, use the following command:
+
+[source,bash]
+$ make run
+
+As this example echoes a POST parameter, it is a little more
+complex to test. Some browsers feature tools that allow you
+to perform one such request, or you can use the command line
+tool `curl` as we will demonstrate.
+
+== Example output
+
+[source,bash]
+----
+$ curl -i -d echo=echomeplz http://localhost:8080
+HTTP/1.1 200 OK
+connection: keep-alive
+server: Cowboy
+date: Fri, 28 Sep 2012 04:12:36 GMT
+content-length: 9
+content-type: text/plain; charset=utf-8
+
+echomeplz
+----