Add warning about assigning the uninstaller to '_'

README.md

@@ -37,6 +37,9 @@ use opentelemetry::{exporter::trace::stdout, trace::Tracer};
 
 fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync + 'static>> {
     // Create a new instrumentation pipeline
+    // Note: uninstalling the tracer happens when the _uninstall
+    // variable is dropped. Assigning it to _ will immediately
+    // drop it and uninstall the tracer
     let (tracer, _uninstall) = stdout::new_pipeline().install();
 
     tracer.in_span("doing_work", |cx| {

opentelemetry-contrib/src/trace/exporter/datadog/mod.rs

@@ -290,5 +290,6 @@ impl trace::SpanExporter for DatadogExporter {
 }
 
 /// Uninstalls the Datadog pipeline on drop
+#[must_use]
 #[derive(Debug)]
 pub struct Uninstall(global::TracerProviderGuard);

opentelemetry-jaeger/src/lib.rs

@@ -225,6 +225,7 @@ pub fn new_pipeline() -> PipelineBuilder {
 }
 
 /// Guard that uninstalls the Jaeger trace pipeline when dropped
+#[must_use]
 #[derive(Debug)]
 pub struct Uninstall(global::TracerProviderGuard);
 

opentelemetry-otlp/src/lib.rs

@@ -233,5 +233,6 @@ impl OtlpPipelineBuilder {
 }
 
 /// Uninstalls the OTLP pipeline on drop
+#[must_use]
 #[derive(Debug)]
 pub struct Uninstall(global::TracerProviderGuard);

opentelemetry-zipkin/src/lib.rs

@@ -320,5 +320,6 @@ impl trace::SpanExporter for Exporter {
 }
 
 /// Uninstalls the Zipkin pipeline on drop.
+#[must_use]
 #[derive(Debug)]
 pub struct Uninstall(global::TracerProviderGuard);

opentelemetry/src/exporter/trace/stdout.rs

@@ -141,5 +141,6 @@ where
 }
 
 /// Uninstalls the stdout pipeline on drop.
+#[must_use]
 #[derive(Debug)]
 pub struct Uninstall(global::TracerProviderGuard);