Reviewed the docs changes

Author: Andrew J Westlake

src/lib.rs

@@ -193,9 +193,9 @@ where
 
 /// Attempt to initialize the Python and Rust event loops
 ///
-/// - Must be called before any other pyo3-asyncio functions
-/// - Calling `try_init` twice returns `Ok(())` and does nothing
-///   > In future versions this may return an `Err`
+/// - Must be called before any other pyo3-asyncio functions.
+/// - Calling `try_init` a second time returns `Ok(())` and does nothing.
+///   > In future versions this may return an `Err`.
 pub fn try_init(py: Python) -> PyResult<()> {
     EVENT_LOOP.get_or_try_init(|| -> PyResult<PyObject> {
         let asyncio = py.import("asyncio")?;

src/tokio.rs

@@ -77,6 +77,10 @@ fn start_current_thread() {
 }
 
 /// Initialize the Tokio Runtime with current-thread scheduler
+///
+/// # Panics
+/// This function will panic if called a second time. See [`init_current_thread_once`] if you want
+/// to avoid this panic.
 pub fn init_current_thread() {
     init(current_thread());
     start_current_thread();
@@ -95,22 +99,26 @@ fn multi_thread() -> Runtime {
 }
 
 /// Initialize the Tokio Runtime with the multi-thread scheduler
+///
+/// # Panics
+/// This function will panic if called a second time. See [`init_multi_thread_once`] if you want to
+/// avoid this panic.
 pub fn init_multi_thread() {
     init(multi_thread());
 }
 
 /// Ensure that the Tokio Runtime is initialized
 ///
 /// If the runtime has not been initialized already, the multi-thread scheduler
-/// is used. Otherwise this function is a no-op.
+/// is used. Calling this function a second time is a no-op.
 pub fn init_multi_thread_once() {
     TOKIO_RUNTIME.get_or_init(|| multi_thread());
 }
 
 /// Ensure that the Tokio Runtime is initialized
 ///
 /// If the runtime has not been initialized already, the current-thread
-/// scheduler is used. Otherwise this function is a no-op
+/// scheduler is used. Calling this function a second time is a no-op.
 pub fn init_current_thread_once() {
     let mut initialized = false;
     TOKIO_RUNTIME.get_or_init(|| {