Update documentation

src/lib.rs

@@ -6,7 +6,7 @@
 //! - peer discovery
 //! - query/response message passing model for communications
 //! - multiplexing transfers over a connection
-//! - overlay networks: full mesh or random peer sampling using Basalt
+//! - overlay networks: full mesh, and soon other methods
 //!
 //! Of particular interest, read the documentation for the `netapp::NetApp` type,
 //! the `message::Message` trait, and `proto::RequestPriority` to learn more

src/netapp.rs

@@ -158,6 +158,8 @@ impl NetApp {
 
 	/// Add a handler for a certain message type. Note that only one handler
 	/// can be specified for each message type.
+	/// The handler is an asynchronous function, i.e. a function that returns
+	/// a future.
 	pub fn add_msg_handler<M, F, R>(&self, handler: F)
 	where
 		M: Message + 'static,