Encourage printing deactivation error instead of panic.

Author: wmedrano

docs/quickstart.md

@@ -91,7 +91,9 @@ fn main() {
     io::stdin().read_line(&mut user_input).ok();
 
     // 5. Not needed as the async client will cease processing on `drop`.
-    active_client.deactivate().unwrap();
+    if let Err(err) = active_client.deactivate() {
+        eprintln!("JACK exited with error: {err}");
+    }
 }
 ```
 

examples/playback_capture.rs

@@ -41,7 +41,9 @@ fn main() {
     let mut user_input = String::new();
     io::stdin().read_line(&mut user_input).ok();
 
-    active_client.deactivate().unwrap();
+    if let Err(err) = active_client.deactivate() {
+        eprintln!("JACK exited with error: {err}");
+    };
 }
 
 struct Notifications;

examples/show_midi.rs

@@ -105,5 +105,7 @@ fn main() {
     io::stdin().read_line(&mut user_input).ok();
 
     // Optional deactivation.
-    active_client.deactivate().unwrap();
+    if let Err(err) = active_client.deactivate() {
+        eprintln!("JACK exited with error: {err}");
+    };
 }

examples/sine.rs

@@ -66,7 +66,9 @@ fn main() {
     // 6. Optional deactivate. Not required since active_client will deactivate on
     // drop, though explicit deactivate may help you identify errors in
     // deactivate.
-    active_client.deactivate().unwrap();
+    if let Err(err) = active_client.deactivate() {
+        eprintln!("JACK exited with error: {err}");
+    };
 }
 
 /// Attempt to read a frequency from standard in. Will block until there is

src/client/async_client.rs

@@ -28,7 +28,9 @@ use crate::Error;
 /// // An active async client is created, `client` is consumed.
 /// let active_client = client.activate_async((), process_handler).unwrap();
 /// // When done, deactivate the client.
-/// active_client.deactivate().unwrap();
+/// if let Err(err) = active_client.deactivate() {
+///     eprintln!("Error deactivating client: {err}");
+/// };
 /// ```
 #[must_use = "The jack client is shut down when the AsyncClient is dropped. You most likely want to keep this alive and manually tear down with `AsyncClient::deactivate`."]
 pub struct AsyncClient<N, P> {