From f002341e2357abdc8bc2248006d26b141657a6a4 Mon Sep 17 00:00:00 2001 From: Dimitri Bouniol Date: Thu, 23 Jul 2026 01:37:04 -0700 Subject: [PATCH 1/2] Fixed broken Docc links for external symbols --- Sources/AsyncSequenceReader/AsyncReadSequence.swift | 4 ++-- .../AsyncSequenceReader.docc/AsyncSequenceReader.md | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/Sources/AsyncSequenceReader/AsyncReadSequence.swift b/Sources/AsyncSequenceReader/AsyncReadSequence.swift index 99ba115..d38375c 100644 --- a/Sources/AsyncSequenceReader/AsyncReadSequence.swift +++ b/Sources/AsyncSequenceReader/AsyncReadSequence.swift @@ -7,9 +7,9 @@ // async-sequence-reader-watermark: 7E20A9CAB0604E89B17C6747A34F00C0 // -/// An AsyncSequence subtype suitable for reading an existing iterator in place. +/// An ``/AsyncSequenceReader/_Concurrency/AsyncSequence`` subtype suitable for reading an existing iterator in place. /// -/// Note that to conform to this protocol, your type must be a reference type. After iterating, you'll also likely want to copy the base iterator back into your starting iterator, as shown in ``AsyncIteratorProtocol/transform(with:readSequenceFactory:)``. +/// Note that to conform to this protocol, your type must be a reference type. After iterating, you'll also likely want to copy the base iterator back into your starting iterator, as shown in ``/AsyncSequenceReader/_Concurrency/AsyncIteratorProtocol/transform(with:readSequenceFactory:)``. public protocol AsyncReadSequence: AsyncSequence, AnyObject { associatedtype BaseIterator: AsyncIteratorProtocol where BaseIterator.Element == Element diff --git a/Sources/AsyncSequenceReader/AsyncSequenceReader.docc/AsyncSequenceReader.md b/Sources/AsyncSequenceReader/AsyncSequenceReader.docc/AsyncSequenceReader.md index 42ea7b5..5550288 100644 --- a/Sources/AsyncSequenceReader/AsyncSequenceReader.docc/AsyncSequenceReader.md +++ b/Sources/AsyncSequenceReader/AsyncSequenceReader.docc/AsyncSequenceReader.md @@ -1,12 +1,12 @@ # ``AsyncSequenceReader`` -``AsyncSequenceReader`` provides building blocks to easily consume Swift's ``/Swift/AsyncSequence``. +``AsyncSequenceReader`` provides building blocks to easily consume Swift's ``/AsyncSequenceReader/_Concurrency/AsyncSequence``. ## What is ``AsyncSequenceReader``? ``AsyncSequenceReader`` is a collection of building blocks to make it easy to read information and transform `AsyncSequence` into data types your app understands. -Although an ``/Swift/AsyncSequence`` can be consumed via a `for await` loop, that isn't often the easiest way of consuming that data: +Although an ``/AsyncSequenceReader/_Concurrency/AsyncSequence`` can be consumed via a `for await` loop, that isn't often the easiest way of consuming that data: ```swift @@ -56,7 +56,7 @@ Reading values is as easy as calling `let value = try await iterator.next()`. Th Note: Resist the urge to catch errors within an iterator map, as once a value is read, it will no longer be available. -Returning an object will make it available to whoever is consuming the resulting sequence, preparing your closure to be called again for the next object. Do note that Your closure will not be called unless something consumes your `results` sequence, either via `for await`, or by using `.reduce` or other ``/Swift/AsyncSequence`` methods. +Returning an object will make it available to whoever is consuming the resulting sequence, preparing your closure to be called again for the next object. Do note that Your closure will not be called unless something consumes your `results` sequence, either via `for await`, or by using `.reduce` or other ``/AsyncSequenceReader/_Concurrency/AsyncSequence`` methods. Note: Do not copy the iterator to other methods without marking it as `inout`, since as a value type, a copy will be made, and further reads may become out of sync. From ca1a16e2b28fce95510b6e691a86d61c15fbf6e4 Mon Sep 17 00:00:00 2001 From: Dimitri Bouniol Date: Thu, 23 Jul 2026 01:39:56 -0700 Subject: [PATCH 2/2] Fixed an issue where the wrong parameters were referenced in function documentation --- .../AsyncReadUpToElementsSequence.swift | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/Sources/AsyncSequenceReader/AsyncReadUpToElementsSequence.swift b/Sources/AsyncSequenceReader/AsyncReadUpToElementsSequence.swift index 24cc90f..53331a1 100644 --- a/Sources/AsyncSequenceReader/AsyncReadUpToElementsSequence.swift +++ b/Sources/AsyncSequenceReader/AsyncReadUpToElementsSequence.swift @@ -31,7 +31,7 @@ extension AsyncIteratorProtocol where Element: Equatable { /// ``` /// /// - Parameter termination: The element marking the end of the sequence that will be collected. - /// - Parameter throwsIfOver: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. + /// - Parameter maximumBufferSize: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. /// - Returns: An array of the collected elements, or `nil` if the sequence was already finished. /// - Throws: ``AsyncSequenceReaderError/terminationNotFound(maximum:actual:)`` if a complete byte sequence could not be returned by the time the sequence ended. @inlinable @@ -65,7 +65,7 @@ extension AsyncIteratorProtocol where Element: Equatable { /// ``` /// /// - Parameter termination: The sequence of elements marking the end of the sequence that will be collected. - /// - Parameter throwsIfOver: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. + /// - Parameter maximumBufferSize: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. /// - Returns: An array of the collected elements, or `nil` if the sequence was already finished. /// - Throws: ``AsyncSequenceReaderError/terminationNotFound(maximum:actual:)`` if a complete byte sequence could not be returned by the time the sequence ended. @inlinable @@ -116,7 +116,7 @@ extension AsyncIteratorProtocol where Element: Equatable { /// ``` /// /// - Parameter termination: The element marking the end of the sequence that will be collected. - /// - Parameter throwsIfOver: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. + /// - Parameter maximumBufferSize: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. /// - Returns: An array of the collected elements, or `nil` if the sequence was already finished. /// - Throws: ``AsyncSequenceReaderError/terminationNotFound(maximum:actual:)`` if a complete byte sequence could not be returned by the time the sequence ended. @inlinable @@ -150,7 +150,7 @@ extension AsyncIteratorProtocol where Element: Equatable { /// ``` /// /// - Parameter termination: The sequence of elements marking the end of the sequence that will be collected. - /// - Parameter throwsIfOver: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. + /// - Parameter maximumBufferSize: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. /// - Returns: An array of the collected elements, or `nil` if the sequence was already finished. /// - Throws: ``AsyncSequenceReaderError/terminationNotFound(maximum:actual:)`` if a complete byte sequence could not be returned by the time the sequence ended. @inlinable @@ -187,7 +187,7 @@ extension AsyncIteratorProtocol where Element: Equatable, Failure == Never { /// ``` /// /// - Parameter termination: The element marking the end of the sequence that will be collected. - /// - Parameter throwsIfOver: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. + /// - Parameter maximumBufferSize: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. /// - Returns: An array of the collected elements, or `nil` if the sequence was already finished. /// - Throws: ``AsyncSequenceReaderError/terminationNotFound(maximum:actual:)`` if a complete byte sequence could not be returned by the time the sequence ended. @inlinable @@ -242,7 +242,7 @@ extension AsyncIteratorProtocol where Element: Equatable, Failure == Never { /// ``` /// /// - Parameter termination: The sequence of elements marking the end of the sequence that will be collected. - /// - Parameter throwsIfOver: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. + /// - Parameter maximumBufferSize: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. /// - Returns: An array of the collected elements, or `nil` if the sequence was already finished. /// - Throws: ``AsyncSequenceReaderError/terminationNotFound(maximum:actual:)`` if a complete byte sequence could not be returned by the time the sequence ended. @inlinable @@ -293,7 +293,7 @@ extension AsyncIteratorProtocol where Element: Equatable, Failure == Never { /// ``` /// /// - Parameter termination: The element marking the end of the sequence that will be collected. - /// - Parameter throwsIfOver: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. + /// - Parameter maximumBufferSize: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. /// - Returns: An array of the collected elements, or `nil` if the sequence was already finished. /// - Throws: ``AsyncSequenceReaderError/terminationNotFound(maximum:actual:)`` if a complete byte sequence could not be returned by the time the sequence ended. @inlinable @@ -348,7 +348,7 @@ extension AsyncIteratorProtocol where Element: Equatable, Failure == Never { /// ``` /// /// - Parameter termination: The sequence of elements marking the end of the sequence that will be collected. - /// - Parameter throwsIfOver: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. + /// - Parameter maximumBufferSize: The maximum amount of elements that will be read before an error is thrown if a termination is not detected. /// - Returns: An array of the collected elements, or `nil` if the sequence was already finished. /// - Throws: ``AsyncSequenceReaderError/terminationNotFound(maximum:actual:)`` if a complete byte sequence could not be returned by the time the sequence ended. @inlinable