Merge pull request prometheus#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