Merge pull request #4 from prometheus/usability/sundry

Run gofmt on corpus and include deprecation.

contributor/documentation.go

@@ -6,4 +6,4 @@
 
 // A repository of various contributed Prometheus client components that may
 // assist in your use of the library.
-package contributor
+package contributor

documentation/documentation.go

@@ -5,4 +5,4 @@
 // in the LICENSE file.
 
 // A repository of various Prometheus client documentation and advice.
-package documentation
+package documentation

documentation/styleguide.go

@@ -45,4 +45,4 @@
 // post-processing job.  The same goes for archiving.  I will need to evaluate
 // hooks into something like OpenTSBD.
 
-package documentation
+package documentation

registry.go

@@ -50,7 +50,6 @@ type container struct {
 	name       string
 }
 
-
 type registry struct {
 	mutex               sync.RWMutex
 	signatureContainers map[string]container
@@ -63,9 +62,12 @@ type registry struct {
 type Registry interface {
 	// Register a metric with a given name.  Name should be globally unique.
 	Register(name, docstring string, baseLabels map[string]string, metric metrics.Metric) error
-// Create a http.HandlerFunc that is tied to a Registry such that requests
-// against it generate a representation of the housed metrics.
+	// Create a http.HandlerFunc that is tied to a Registry such that requests
+	// against it generate a representation of the housed metrics.
 	Handler() http.HandlerFunc
+	// This is a legacy version of Handler and is deprecated.  Please stop
+	// using.
+	YieldExporter() http.HandlerFunc
 }
 
 // This builds a new metric registry.  It is not needed in the majority of