Merge pull request #2 from edwarnicke/README.md

Adding README

README.md

@@ -0,0 +1,40 @@
+debug is a simple library for Go that allows you to optionally debug your executable based on env variables.
+
+# Usage
+
+Simply add debug.Self() to your main function as shown below:
+
+```
+import (
+    "github.com/edwarnicke/debug"
+)
+
+func main() {
+    if err := debug.Self(); err != nil {
+        log.Infof("%s", err)
+    }
+...
+}
+```
+
+will cause your application to log out:
+
+```
+Setting env variable DLV_LISTEN_{{executable name}} to a valid dlv '--listen' value will cause the dlv debugger to execute this binary and listen as directed.
+```
+
+thus informing you of what env variable to set to a valid dlv listener value to trigger debugging.
+
+So if your application where named 'forwarder', you'd see:
+
+```
+Setting env variable DLV_LISTEN_FORWARDER to a valid dlv '--listen' value will cause the dlv debugger to execute this binary and listen as directed.
+```
+
+and setting the env variable:
+
+```
+export DLV_LISTEN_FORWARDER=:50000
+```
+
+would cause your applicaton to exec itself over with dlv with arguments to run the application itself.