Improve Source.queue scala doc based on user feedback (#24734)

This commit is contained in:
Christopher Batey 2018-03-15 18:01:24 -07:00 committed by Konrad `ktoso` Malawski
parent d8b9bb1b3a
commit 2bd21c1691
2 changed files with 10 additions and 4 deletions

View file

@ -23,8 +23,11 @@ trait SourceQueue[T] {
* - completes with `Dropped` when stream dropped offered element
* - completes with `QueueClosed` when stream is completed during future is active
* - completes with `Failure(f)` when failure to enqueue element from upstream
* - fails when stream is completed or you cannot call offer in this moment because of implementation rules
* (like for backpressure mode and full buffer you need to wait for last offer call Future completion)
* - fails when stream is completed
*
* Additionally when using the backpressure overflowStrategy:
* - If the buffer is full the Future won't be completed until there is space in the buffer
* - Calling offer before the Future is completed in this case will return a failed Future
*
* @param elem element to send to a stream
*/

View file

@ -23,8 +23,11 @@ trait SourceQueue[T] {
* - completes with `Dropped` when stream dropped offered element
* - completes with `QueueClosed` when stream is completed during future is active
* - completes with `Failure(f)` when failure to enqueue element from upstream
* - fails when stream is completed or you cannot call offer in this moment because of implementation rules
* (like for backpressure mode and full buffer you need to wait for last offer call Future completion)
* - fails when stream is completed
*
* Additionally when using the backpressure overflowStrategy:
* - If the buffer is full the Future won't be completed until there is space in the buffer
* - Calling offer before the Future is completed in this case will return a failed Future
*
* @param elem element to send to a stream
*/