Front the load_native_certs function in lib.rs

This saves some duplication in rustdoc.

Author: est31

src/lib.rs

@@ -23,4 +23,19 @@ mod macos;
 #[cfg(target_os = "macos")]
 use macos as platform;
 
-pub use platform::load_native_certs;
+use rustls::RootCertStore;
+use std::io::Error;
+
+/// Loads root certificates found in the platform's native certificate
+/// store.
+///
+/// On success, this returns a `rustls::RootCertStore` loaded with a
+/// snapshop of the root certificates found on this platform.  This
+/// function fails in a platform-specific way, expressed in a `std::io::Error`.
+///
+/// This function can be expensive: on some platforms it involves loading
+/// and parsing a ~300KB disk file.  It's therefore prudent to call
+/// this sparingly.
+pub fn load_native_certs() -> PartialResult<RootCertStore, Error> {
+    platform::load_native_certs()
+}

src/macos.rs

@@ -9,16 +9,6 @@ use std::collections::HashMap;
 
 use crate::PartialResult;
 
-/// Loads root certificates found in the platform's native certificate
-/// store.
-///
-/// On success, this returns a `rustls::RootCertStore` loaded with a
-/// snapshop of the root certificates found on this platform.  This
-/// function fails in a platform-specific way, expressed in a `std::io::Error`.
-///
-/// This function can be expensive: on some platforms it involves loading
-/// and parsing a ~300KB disk file.  It's therefore prudent to call
-/// this sparingly.
 pub fn load_native_certs() -> PartialResult<RootCertStore, Error> {
     let mut store = RootCertStore::empty();
 

src/unix.rs

@@ -18,17 +18,6 @@ fn load_file(store: &mut RootCertStore, path: &Path) -> Result<(), Error> {
     }
 }
 
-/// Loads root certificates found in the platform's native certificate
-/// store.
-///
-/// On success, this returns a `rustls::RootCertStore` loaded with a
-/// snapshop of the root certificates found on this platform.  This
-/// function fails in a platform-specific way, expressed in a `std::io::Error`.
-/// It may produce partial output.
-///
-/// This function can be expensive: on some platforms it involves loading
-/// and parsing a ~300KB disk file.  It's therefore prudent to call
-/// this sparingly.
 pub fn load_native_certs() -> PartialResult<RootCertStore, Error> {
     let likely_locations = openssl_probe::probe();
     let mut store = RootCertStore::empty();

src/windows.rs

@@ -15,16 +15,6 @@ fn usable_for_rustls(uses: schannel::cert_context::ValidUses) -> bool {
     }
 }
 
-/// Loads root certificates found in the platform's native certificate
-/// store.
-///
-/// On success, this returns a `rustls::RootCertStore` loaded with a
-/// snapshop of the root certificates found on this platform.  This
-/// function fails in a platform-specific way, expressed in a `std::io::Error`.
-///
-/// This function can be expensive: on some platforms it involves loading
-/// and parsing a ~300KB disk file.  It's therefore prudent to call
-/// this sparingly.
 pub fn load_native_certs() -> PartialResult<RootCertStore, Error> {
     let mut store = RootCertStore::empty();
     let mut first_error = None;