Manual pages (#1346)

* Add manual pages

Generate manual pages from the README and extend README with Name and
Description sections.

The generation requires 'ronn' which may not be available. Just check in
all generated manual pages.

man/coredns-pprof.7

@@ -0,0 +1,70 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "COREDNS\-PPROF" "7" "January 2018" "CoreDNS" "CoreDNS plugins"
+.
+.SH "NAME"
+\fIpprof\fR \- publishes runtime profiling data at endpoints under \fB/debug/pprof\fR\.
+.
+.SH "DESCRIPTION"
+You can visit \fB/debug/pprof\fR on your site for an index of the available endpoints\. By default it will listen on localhost:6053\.
+.
+.P
+For more information, please see Go\'s pprof documentation \fIhttps://golang\.org/pkg/net/http/pprof/\fR and read Profiling Go Programs \fIhttps://blog\.golang\.org/profiling\-go\-programs\fR\.
+.
+.SH "SYNTAX"
+.
+.nf
+
+pprof [ADDRESS]
+.
+.fi
+.
+.P
+If not specified, ADDRESS defaults to localhost:6053\.
+.
+.SH "EXAMPLES"
+Enable pprof endpoints:
+.
+.IP "" 4
+.
+.nf
+
+\&\. {
+    pprof
+}
+.
+.fi
+.
+.IP "" 0
+.
+.P
+Listen on an alternate address:
+.
+.IP "" 4
+.
+.nf
+
+\&\. {
+    pprof 10\.9\.8\.7:6060
+}
+.
+.fi
+.
+.IP "" 0
+.
+.P
+Listen on an all addresses on port 6060:
+.
+.IP "" 4
+.
+.nf
+
+\&\. {
+    pprof :6060
+}
+.
+.fi
+.
+.IP "" 0
+See Go\'s pprof documentation \fIhttps://golang\.org/pkg/net/http/pprof/\fR and Profiling Go Programs \fIhttps://blog\.golang\.org/profiling\-go\-programs\fR\.