Add ordering note

lygz5016 · Jan 18, 2019 · 0ca084d · 0ca084d
1 parent b3fdf16
commit 0ca084d
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/tokio-postgres/src/lib.rs b/tokio-postgres/src/lib.rs
@@ -49,6 +49,12 @@
 //! tokio::run(fut);
 //! ```
 //!
+//! # Behavior
+//!
+//! Calling a method like `Client::query` on its own does nothing. The associated request is not sent to the database
+//! until the future returned by the method is first polled. Requests are executed in the order that they are first
+//! polled, not in the order that their futures are created.
+//!
 //! # Pipelining
 //!
 //! The client supports *pipelined* requests. Pipelining can improve performance in use cases in which multiple,