Update documentation for r2d2 to be more complete
//!
//! When used inside a pool, if an individual connection becomes
//! broken (as determined by the [R2D2Connection::is_broken] method)
-//! then `r2d2` will close and return the connection to the DB.
+//! then, when the connection goes out of scope, `r2d2` will close
+//! and return the connection to the DB.
//!
//! `diesel` determines broken connections by whether or not the current
//! thread is panicking or if individual `Connection` structs are
//! broken (determined by the `is_broken()` method). Generically, these
//! are left to individual backends to implement themselves.
//!
-//! For SQLite, PG, and MySQL backends, specifically, `is_broken()`
-//! is determined by whether or not the `TransactionManagerStatus` (as a part
-//! of the `AnsiTransactionManager` struct) is in an `InError` state.
+//! For SQLite, PG, and MySQL backends `is_broken()` is determined
+//! by whether or not the `TransactionManagerStatus` (as a part
+//! of the `AnsiTransactionManager` struct) is in an `InError` state
+//! or contains an open transaction when the connection goes out of scope.
//!
pub use r2d2::*;
