Add build instructions; convert to Markdown.

README.md

@@ -1,19 +1,49 @@
+pg_amqp 0.2.0
+=============
+
 The pg_amqp package provides the ability for postgres statements to directly
-publish messages to an AMQP broker.
+publish messages to an [AMQP](http://www.amqp.org/) broker.
+
+To build pg_amqp, just do this:
+
+ make
+ make install
+
+If you encounter an error such as:
+
+ "Makefile", line 8: Need an operator
+
+You need to use GNU make, which may well be installed on your system as
+`gmake`:
+
+ gmake
+ gmake install
+
+If you encounter an error such as:
+
+ make: pg_config: Command not found
+
+Be sure that you have `pg_config` installed and in your path. If you used a
+package management system such as RPM to install PostgreSQL, be sure that the
+`-devel` package is also installed. If necessary tell the build process where
+to find it:
+
+ env PG_CONFIG=/path/to/pg_config make && make install
 
-Usage:
+Usage
+-----
 
 Insert AMQP broker information (host/port/user/pass) into the
-amqp.broker table.
+`amqp.broker` table.
 
 A process starts and connects to PostgreSQL and runs:
 
-select amqp.publish(broker_id, "amqp.direct", "foo", "message");
+ SELECT amqp.publish(broker_id, 'amqp.direct', 'foo', 'message');
 
 Upon process termination, all broker connections will be torn down.
 If there is a need to disconnect from a specific broker, one can call:
 
-select amqp.disconnect(broker_id);
+ select amqp.disconnect(broker_id);
 
 which will disconnect from the broker if it is connected and do nothing
 if it is already disconnected.