pjfanning commented on PR #3095:
URL: https://github.com/apache/pekko/pull/3095#issuecomment-4754108866
doc build broken
```
[06-19 18:58:19.145] [error] Class not found for
@apidoc[Source.actorRefWithBackpressure] (pattern
Source\$actorRefWithBackpressure$) at
/home/runner/work/pekko/pekko/docs/src/main/paradox/stream/actor-interop.md:133
[06-19 18:58:19.145] [error] The `Source.queue(Int, OverflowStrategy)`
overloads that this section describes — including
`OverflowStrategy.backpressure` — are **deprecated** because their asynchronous
`offer` @scala[`Future`]@java[`CompletionStage`] can hang indefinitely when
downstream stalls. Use `Source.queue[T](bufferSize)` (materializes a
@apidoc[BoundedSourceQueue] with synchronous feedback), or for backpressure
towards the producer use @apidoc[Source.actorRefWithBackpressure] or
@apidoc[MergeHub.source$]. See @ref:[the Source.queue operator
page](operators/Source/queue.md) for a per-strategy migration table.
[06-19 18:58:19.146] [error]
^
[06-19 18:58:19.146] [error] Class not found for @apidoc[MergeHub.source$]
(pattern MergeHub\$source$) at
/home/runner/work/pekko/pekko/docs/src/main/paradox/stream/actor-interop.md:133
[06-19 18:58:19.146] [error] The `Source.queue(Int, OverflowStrategy)`
overloads that this section describes — including
`OverflowStrategy.backpressure` — are **deprecated** because their asynchronous
`offer` @scala[`Future`]@java[`CompletionStage`] can hang indefinitely when
downstream stalls. Use `Source.queue[T](bufferSize)` (materializes a
@apidoc[BoundedSourceQueue] with synchronous feedback), or for backpressure
towards the producer use @apidoc[Source.actorRefWithBackpressure] or
@apidoc[MergeHub.source$]. See @ref:[the Source.queue operator
page](operators/Source/queue.md) for a per-strategy migration table.
[06-19 18:58:19.146] [error]
^
[06-19 18:58:19.146] [error] No matches found for apidoc query [and
materialize a @apidoc[SourceQueueWithComplete]] at
/home/runner/work/pekko/pekko/docs/src/main/paradox/stream/operators/Source/queue.md:9
[06-19 18:58:19.147] [error] The `Source.queue` overloads that accept an
@apidoc[OverflowStrategy] (and materialize a @apidoc[SourceQueueWithComplete])
are **deprecated**. Their asynchronous `offer`
@scala[`Future`]@java[`CompletionStage`] can hang indefinitely under
`OverflowStrategy.backpressure` when downstream stalls, which has caused
real-world deadlocks.
[06-19 18:58:19.147] [error] ^
[06-19 18:58:19.147] [error] No matches found for apidoc query [single
imperative producer] at
/home/runner/work/pekko/pekko/docs/src/main/paradox/stream/operators/Source/queue.md:11
[06-19 18:58:19.147] [error] Prefer `Source.queue[T](bufferSize)` (this
page), which materializes a @apidoc[BoundedSourceQueue] with synchronous
feedback and drop-newest overflow. For backpressure towards the producer, use
@apidoc[Source.actorRefWithBackpressure] (single imperative producer) or
@apidoc[MergeHub.source$] (multiple producers). See the [migration
table](#migrating-from-the-deprecated-sourcequeueint-overflowstrategy-overloads)
below for a per-strategy replacement.
[06-19 18:58:19.147] [error]
^
[06-19 18:58:19.147] [error] No matches found for apidoc query [multiple
producers] at
/home/runner/work/pekko/pekko/docs/src/main/paradox/stream/operators/Source/queue.md:11
[06-19 18:58:19.147] [error] Prefer `Source.queue[T](bufferSize)` (this
page), which materializes a @apidoc[BoundedSourceQueue] with synchronous
feedback and drop-newest overflow. For backpressure towards the producer, use
@apidoc[Source.actorRefWithBackpressure] (single imperative producer) or
@apidoc[MergeHub.source$] (multiple producers). See the [migration
table](#migrating-from-the-deprecated-sourcequeueint-overflowstrategy-overloads)
below for a per-strategy replacement.
[06-19 18:58:19.147] [error]
^
[06-19 18:58:19.147] [error] Class not found for
@apidoc[BoundedSourceQueue.fail] (pattern BoundedSourceQueue\$fail$) at
/home/runner/work/pekko/pekko/docs/src/main/paradox/stream/operators/Source/queue.md:94
[06-19 18:58:19.147] [error] | `Source.queue(n, OverflowStrategy.fail)` |
`Source.queue[T](n)` and, on `QueueOfferResult.Dropped`, call
@apidoc[BoundedSourceQueue.fail] with a `BufferOverflowException`. |
[06-19 18:58:19.147] [error]
^
[06-19 18:58:19.147] [error] No matches found for apidoc query [single
imperative producer] at
/home/runner/work/pekko/pekko/docs/src/main/paradox/stream/operators/Source/queue.md:95
[06-19 18:58:19.147] [error] | `Source.queue(n,
OverflowStrategy.backpressure)` | @apidoc[Source.actorRefWithBackpressure]
(single imperative producer) or @apidoc[MergeHub.source$] (multiple producers).
|
[06-19 18:58:19.147] [error]
^
[06-19 18:58:19.147] [error] No matches found for apidoc query [multiple
producers] at
/home/runner/work/pekko/pekko/docs/src/main/paradox/stream/operators/Source/queue.md:95
[06-19 18:58:19.147] [error] | `Source.queue(n,
OverflowStrategy.backpressure)` | @apidoc[Source.actorRefWithBackpressure]
(single imperative producer) or @apidoc[MergeHub.source$] (multiple producers).
|
[06-19 18:58:19.147] [error]
^
[06-19 18:58:19.147] [error] Paradox failed with 8 errors
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
