message: Better document that multiple servers may be reached by separating them with commas in the connect method
diff: @@ -503,7 +503,11 @@ impl<TypeState> ConnectionOptions<TypeState> {
  /// Establish a `Connection` with a NATS server.
  ///
  + /// Multiple servers may be specified by separating
  + /// them with commas.
  + ///
  /// # Example
  + ///
  /// ```
  /// # fn main() -> std::io::Result<()> {
  /// let options = nats::ConnectionOptions::new();
  @@ -511,6 +515,21 @@ impl<TypeState> ConnectionOptions<TypeState> {
  /// # Ok(())
  /// # }
  /// ```
  + ///
  + /// In the below case, the second server is configured
  + /// to use TLS but the first one is not. Using the
  + /// `tls_required` method can ensure that all
  + /// servers are connected to with TLS, if that is
  + /// your intention.
  + ///
  + ///
  + /// ```
  + /// # fn main() -> std::io::Result<()> {
  + /// let options = nats::ConnectionOptions::new();
  + /// let nc = options.connect("nats://demo.nats.io:4222,tls://demo.nats.io:4443")?;
  + /// # Ok(())
  + /// # }
  + /// ```
  pub fn connect(self, nats_url: &str) -> io::Result<Connection> {
  let options = ConnectionOptions {
  auth: self.auth,
  