diff --git a/stdlib/public/core/Filter.swift b/stdlib/public/core/Filter.swift index 67a24c84f4fc9..333bc387b7ca6 100644 --- a/stdlib/public/core/Filter.swift +++ b/stdlib/public/core/Filter.swift @@ -148,12 +148,12 @@ public func == ( /// A lazy `CollectionType` wrapper that includes the elements of an /// underlying collection that satisfy a predicate. /// -/// - Note: The performance of advancing a `LazyFilterIndex` -/// depends on how sparsely the filtering predicate is satisfied, -/// and may not offer the usual performance given by models of -/// `ForwardIndexType`. Be aware, therefore, that general operations -/// on `LazyFilterCollection` instances may not have the -/// documented complexity. +/// - Note: The performance of accessing `startIndex`, `first`, any methods +/// that depend on `startIndex`, or of advancing a `LazyFilterIndex` depends +/// on how sparsely the filtering predicate is satisfied, and may not offer +/// the usual performance given by `CollectionType` or `ForwardIndexType`. Be +/// aware, therefore, that general operations on `LazyFilterCollection` +/// instances may not have the documented complexity. public struct LazyFilterCollection< Base : CollectionType > : LazyCollectionType { diff --git a/stdlib/public/core/Flatten.swift.gyb b/stdlib/public/core/Flatten.swift.gyb index 438f9e1548388..200baea526ba2 100644 --- a/stdlib/public/core/Flatten.swift.gyb +++ b/stdlib/public/core/Flatten.swift.gyb @@ -225,6 +225,14 @@ public func == ( /// * `c.flatten().map(f)` maps eagerly and returns a new array /// * `c.lazy.flatten().map(f)` maps lazily and returns a `LazyMapCollection` /// +/// - Note: The performance of accessing `startIndex`, `first`, any methods +/// that depend on `startIndex`, or of advancing a `${Collection}Index` +/// depends on how many empty subcollections are found in the base +/// collection, and may not offer the usual performance given by +/// `CollectionType` or `${traversal}IndexType`. Be aware, therefore, that +/// general operations on `${Collection}` instances may not have the +/// documented complexity. +/// /// - See also: `FlattenSequence` public struct ${Collection}< Base: CollectionType where ${constraints % {'Base': 'Base.'}}