implement feedback from stjepan

Signed-off-by: Yoshua Wuyts <[email protected]>

Author: yoshuawuyts

src/future/future/mod.rs

@@ -137,7 +137,8 @@ extension_trait! {
         #[doc = r#"
             Waits for one of two similarly-typed futures to complete.
 
-            Awaits multiple futures simultaneously, returning all results once complete.
+            Awaits multiple futures simultaneously, returning the output of the
+            first future that completes.
 
             This function will return a new future which awaits for either one of both
             futures to complete. If multiple futures are completed at the same time,
@@ -184,7 +185,10 @@ extension_trait! {
 
             `try_select` is similar to [`select`], but keeps going if a future
             resolved to an error until all futures have been resolved. In which case
-            the error of the `other` future will be returned.
+            an error is returned.
+
+            The ordering of which value is yielded when two futures resolve
+            simultaneously is intentionally left unspecified.
 
             # Examples
 

src/future/future/select.rs

@@ -1,15 +1,19 @@
 use std::pin::Pin;
 
-use pin_project_lite::pin_project;
 use async_macros::MaybeDone;
+use pin_project_lite::pin_project;
 
-use std::future::Future;
 use crate::task::{Context, Poll};
+use std::future::Future;
 
 pin_project! {
     #[allow(missing_docs)]
     #[allow(missing_debug_implementations)]
-    pub struct Select<L, R> where L: Future, R: Future<Output = L::Output> {
+    pub struct Select<L, R>
+    where
+        L: Future,
+        R: Future<Output = L::Output>
+    {
         #[pin] left: MaybeDone<L>,
         #[pin] right: MaybeDone<R>,
     }

src/future/future/try_select.rs

@@ -9,7 +9,11 @@ use std::future::Future;
 pin_project! {
     #[allow(missing_docs)]
     #[allow(missing_debug_implementations)]
-    pub struct TrySelect<L, R> where L: Future, R: Future<Output = L::Output> {
+    pub struct TrySelect<L, R>
+    where
+        L: Future,
+        R: Future<Output = L::Output>
+    {
         #[pin] left: MaybeDone<L>,
         #[pin] right: MaybeDone<R>,
     }