lib: expose Verifier as part of public API.

Additionally add a brief comment to the `tls_config()` doc pointing out
that constructing a `Verifier` by hand allows customizing the rustls
`ClientConfig` for advanced use cases.

Author: cpu

src/lib.rs

@@ -6,7 +6,7 @@ use rustls::ClientConfig;
 use std::sync::Arc;
 
 mod verification;
-use verification::Verifier;
+pub use verification::Verifier;
 
 // Build the Android module when generating docs so that
 // the Android-specific functions are included.
@@ -28,7 +28,8 @@ mod tests;
 pub use tests::ffi::*;
 
 /// Creates and returns a `rustls` configuration that verifies TLS
-/// certificates in the best way for the underlying OS platform.
+/// certificates in the best way for the underlying OS platform, using
+/// safe defaults for the `rustls` configuration.
 ///
 /// # Example
 ///
@@ -46,6 +47,10 @@ pub use tests::ffi::*;
 /// }
 /// ```
 ///
+/// If you require more control over the rustls `ClientConfig`, you can
+/// instantiate a [Verifier] with [Verifier::default] and then use it
+/// with [rustls::ConfigBuilder::with_custom_certificate_verifier].
+///
 /// Refer to the crate level documentation to see what platforms
 /// are currently supported.
 pub fn tls_config() -> ClientConfig {