Swift Package IndexBuild Information
Successful build of libpcache_Swift, reference main (d8d1eb), with Swift 6.3 for macOS (SPM) on 13 Aug 2026 13:26:36 UTC.
Swift 6 data race errors: 0
Build Command
env DEVELOPER_DIR=/Applications/Xcode-26.4.0.app xcrun swift build --arch arm64Build Log
========================================
RunAll
========================================
Builder version: undefined version: run 'make version' to update
Interrupt handler set up.
========================================
Checkout
========================================
Clone URL: https://github.com/RuiNelson/libpcache_Swift.git
Reference: main
Initialized empty Git repository in /Users/admin/builder/spi-builder-workspace/.git/
From https://github.com/RuiNelson/libpcache_Swift
* branch main -> FETCH_HEAD
* [new branch] main -> origin/main
HEAD is now at d8d1eb8 Update xxhash
Submodule path 'Sources/CLibPCache/libpcache': checked out '7d52f8f841ed45283fd5842ab7530854ca2134f2'
Submodule path 'Sources/CLibPCache/xxhash': checked out 'c0b5ea995d66691734b1a79ad89e73a0d2fd5a53'
Submodule 'Sources/CLibPCache/libpcache' (https://github.com/RuiNelson/libpcache.git) registered for path 'Sources/CLibPCache/libpcache'
Submodule 'Sources/CLibPCache/xxhash' (https://github.com/Cyan4973/xxHash.git) registered for path 'Sources/CLibPCache/xxhash'
Cloning into '/Users/admin/builder/spi-builder-workspace/Sources/CLibPCache/libpcache'...
Cloning into '/Users/admin/builder/spi-builder-workspace/Sources/CLibPCache/xxhash'...
Cloned https://github.com/RuiNelson/libpcache_Swift.git
Revision (git rev-parse @):
d8d1eb8473b8b612267f4ce65aa286d0ef1326a4
SPI manifest file found: $PWD/.spi.yml
SUCCESS checkout https://github.com/RuiNelson/libpcache_Swift.git at main
========================================
ResolveProductDependencies
========================================
Resolving dependencies ...
{
"identity": ".resolve-product-dependencies",
"name": "resolve-dependencies",
"url": "/Users/admin/builder/spi-builder-workspace/.resolve-product-dependencies",
"version": "unspecified",
"path": "/Users/admin/builder/spi-builder-workspace/.resolve-product-dependencies",
"traits": [
"default"
],
"dependencies": [
{
"identity": "libpcache_swift",
"name": "libpcache_Swift",
"url": "https://github.com/RuiNelson/libpcache_Swift.git",
"version": "unspecified",
"path": "/Users/admin/builder/spi-builder-workspace/.resolve-product-dependencies/.build/checkouts/libpcache_Swift",
"traits": [
"default"
],
"dependencies": [
]
}
]
}
Fetching https://github.com/RuiNelson/libpcache_Swift.git
[1/373] Fetching libpcache_swift
Fetched https://github.com/RuiNelson/libpcache_Swift.git from cache (1.00s)
Creating working copy for https://github.com/RuiNelson/libpcache_Swift.git
Working copy of https://github.com/RuiNelson/libpcache_Swift.git resolved at main (d8d1eb8)
warning: '.resolve-product-dependencies': dependency 'libpcache_swift' is not used by any target
Found 0 product dependencies
========================================
Build
========================================
Selected platform: macosSpm
Swift version: 6.3
Building package at path: $PWD
https://github.com/RuiNelson/libpcache_Swift.git
Running build ...
env DEVELOPER_DIR=/Applications/Xcode-26.4.0.app xcrun swift build --arch arm64
Building for debugging...
[0/9] Write sources
[1/9] Write swift-version--6988338F2F200930.txt
[2/9] Compiling handle.c
[3/9] Compiling db.c
[4/9] Compiling pages.c
[5/9] Compiling xxhash.c
[6/9] Compiling maintenance.c
[7/9] Compiling pages_util.c
[8/9] Compiling volume.c
[10/24] Compiling libpcache_Swift PC-Maintenance.swift
[11/24] Compiling libpcache_Swift PC-Check.swift
[12/24] Compiling libpcache_Swift PC-Delete.swift
[13/24] Compiling libpcache_Swift BridgeStructures.swift
[14/24] Compiling libpcache_Swift ValidationHelpers.swift
[15/24] Compiling libpcache_Swift PC-Write.swift
[16/24] Compiling libpcache_Swift PC-Read.swift
[17/24] Compiling libpcache_Swift BridgeErrors.swift
[18/24] Compiling libpcache_Swift BridgeMethods.swift
[19/24] Compiling libpcache_Swift PC-Introspection.swift
[20/24] Compiling libpcache_Swift PC-Lifecycle.swift
[21/24] Emitting module libpcache_Swift
[22/24] Compiling libpcache_Swift BridgeBuffers.swift
[23/24] Compiling libpcache_Swift BridgeEnums.swift
[24/24] Compiling libpcache_Swift Errors.swift
[25/25] Compiling libpcache_Swift StructsAndEnums.swift
Build complete! (6.58s)
Build complete.
{
"dependencies" : [
],
"manifest_display_name" : "libpcache_Swift",
"name" : "libpcache_Swift",
"path" : "/Users/admin/builder/spi-builder-workspace",
"platforms" : [
{
"name" : "macos",
"version" : "10.15"
},
{
"name" : "ios",
"version" : "13.0"
},
{
"name" : "maccatalyst",
"version" : "13.0"
},
{
"name" : "tvos",
"version" : "12.0"
},
{
"name" : "visionos",
"version" : "1.0"
},
{
"name" : "watchos",
"version" : "4.0"
}
],
"products" : [
{
"name" : "libpcache_Swift",
"targets" : [
"libpcache_Swift"
],
"type" : {
"library" : [
"automatic"
]
}
}
],
"targets" : [
{
"c99name" : "libpcache_SwiftTests",
"module_type" : "SwiftTarget",
"name" : "libpcache_SwiftTests",
"path" : "Tests/libpcache_SwiftTests",
"sources" : [
"ReadmeExampleTests.swift",
"libpcache_SwiftTests.swift"
],
"target_dependencies" : [
"libpcache_Swift"
],
"type" : "test"
},
{
"c99name" : "libpcache_Swift",
"module_type" : "SwiftTarget",
"name" : "libpcache_Swift",
"path" : "Sources/libpcache_Swift",
"product_memberships" : [
"libpcache_Swift"
],
"sources" : [
"Internal/BridgeBuffers.swift",
"Internal/BridgeEnums.swift",
"Internal/BridgeErrors.swift",
"Internal/BridgeMethods.swift",
"Internal/BridgeStructures.swift",
"Internal/ValidationHelpers.swift",
"Public/PC-Check.swift",
"Public/PC-Delete.swift",
"Public/PC-Introspection.swift",
"Public/PC-Lifecycle.swift",
"Public/PC-Maintenance.swift",
"Public/PC-Read.swift",
"Public/PC-Write.swift",
"Public/Types/Errors.swift",
"Public/Types/StructsAndEnums.swift"
],
"target_dependencies" : [
"CLibPCache"
],
"type" : "library"
},
{
"c99name" : "CLibPCache",
"module_type" : "ClangTarget",
"name" : "CLibPCache",
"path" : "Sources/CLibPCache",
"product_memberships" : [
"libpcache_Swift"
],
"sources" : [
"libpcache/src/db.c",
"libpcache/src/handle.c",
"libpcache/src/maintenance.c",
"libpcache/src/pages.c",
"libpcache/src/pages_util.c",
"libpcache/src/volume.c",
"xxhash/xxhash.c"
],
"type" : "library"
}
],
"tools_version" : "6.2"
}
✅ Doc result (pending) reported
========================================
GenerateDocs
========================================
Generating docs at path: $PWD/.docs/ruinelson/libpcache_swift/main
Repository: RuiNelson/libpcache_Swift
Swift version used: 6.3
Target: libpcache_Swift
Extracting symbol information for 'libpcache_Swift'...
Finished extracting symbol information for 'libpcache_Swift'. (27.33s)
Building documentation for 'libpcache_Swift'...
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPage(id:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:19:21-19:32
17 | ///
18 | /// - Returns: `true` if the page exists, `false` otherwise.
19 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `id` has the wrong length; ``CheckPagesError`` on
20 | /// check failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid; ``CommonErrors/outOfMemory`` on
21 | /// allocation failure; ``SQLiteError`` on database failure; ``UnknownLibPCacheError`` for unrecognized C error
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(ids:results:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:35:21-35:32
33 | /// otherwise.
34 | ///
35 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `ids` is not a multiple of `idWidth`;
36 | /// ``CheckPagesError`` on check failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
37 | /// ``CommonErrors/outOfMemory`` on allocation failure; ``SQLiteError`` on database failure;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(counter:count:results:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:52:21-52:32
50 | /// - results: Caller-supplied array of at least `count` booleans.
51 | ///
52 + /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative; ``InvalidCall/idBufferIsNotTheExpectedSize``
53 | /// if the counter template width is wrong; ``CheckPagesError/invalidArgument`` if `position` is out of bounds, the
54 | /// counter overflows, or `endianness` is invalid; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(counter:count:results:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:52:78-52:89
50 | /// - results: Caller-supplied array of at least `count` booleans.
51 | ///
52 + /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative; ``InvalidCall/idBufferIsNotTheExpectedSize``
53 | /// if the counter template width is wrong; ``CheckPagesError/invalidArgument`` if `position` is out of bounds, the
54 | /// counter overflows, or `endianness` is invalid; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPagesRange(first:last:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:84:21-84:32
82 | /// - Returns: The number of pages in the range.
83 | ///
84 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if either buffer has the wrong length;
85 | /// ``CheckPagesError/rangeInvalidRange`` if `first > last`; ``CommonErrors/invalidHandle`` if the volume handle is
86 | /// invalid; ``CommonErrors/outOfMemory`` on allocation failure; ``SQLiteError`` on database failure;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPage(id:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:103:21-103:32
101 | ///
102 | /// - Returns: `true` if the page exists, `false` otherwise.
103 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``CheckPagesError`` on check failure; ``CommonErrors``,
104 | /// ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
105 | func checkPage(id: RawSpan) throws -> Bool {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(ids:into:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:117:21-117:32
115 | /// - results: Destination buffer; must hold at least `count` elements, where `count = ids.byteCount / idWidth`.
116 | ///
117 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `ids.byteCount` is not a multiple of `idWidth`;
118 | /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `results` has fewer elements than required;
119 | /// ``CheckPagesError`` on check failure; ``CommonErrors``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(ids:into:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:118:13-118:24
116 | ///
117 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `ids.byteCount` is not a multiple of `idWidth`;
118 + /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `results` has fewer elements than required;
119 | /// ``CheckPagesError`` on check failure; ``CommonErrors``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the
120 | /// underlying operation.
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(counter:count:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:146:21-146:32
144 | ///
145 | /// - Returns: Array of booleans, `true` for each page that exists.
146 + /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative; ``InvalidCall`` on invalid buffer size;
147 | /// ``CheckPagesError`` on check failure; ``CommonErrors``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the
148 | /// underlying operation.
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(counter:count:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:146:78-146:89
144 | ///
145 | /// - Returns: Array of booleans, `true` for each page that exists.
146 + /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative; ``InvalidCall`` on invalid buffer size;
147 | /// ``CheckPagesError`` on check failure; ``CommonErrors``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the
148 | /// underlying operation.
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPagesRange(first:last:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:164:21-164:32
162 | ///
163 | /// - Returns: The number of pages in the range.
164 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``CheckPagesError`` on check failure; ``CommonErrors``,
165 | /// ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
166 | func checkPagesRange(first: RawSpan, last: RawSpan) throws -> Int {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPage(id:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:183:21-183:32
181 | ///
182 | /// - Returns: `true` if the page exists, `false` otherwise.
183 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``CheckPagesError`` on check failure; ``CommonErrors``,
184 | /// ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
185 | func checkPage(id: some ContiguousBytes) throws -> Bool {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:196:21-196:32
194 | ///
195 | /// - Returns: Array of booleans, `true` for each page that exists.
196 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``CheckPagesError`` on check failure; ``CommonErrors``,
197 | /// ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
198 | func checkPages(ids: some ContiguousBytes) throws -> [Bool] {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPagesRange(first:last:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:219:21-219:32
217 | ///
218 | /// - Returns: The number of pages in the range.
219 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``CheckPagesError`` on check failure; ``CommonErrors``,
220 | /// ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
221 | func checkPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> Int {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/checkPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Check.swift:238:21-238:32
236 | ///
237 | /// - Returns: Array of booleans, `true` for each page that exists.
238 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``CheckPagesError`` on check failure; ``CommonErrors``,
239 | /// ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
240 | func checkPages(ids: [Data]) throws -> [Bool] {
warning: 'deletePages(ids:wipe:durable:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:18:26-18:56
16 | /// On ``CapacityPolicy/fifo`` volumes, deletion triggers a compaction pass that relocates live pages to preserve
17 | /// the eviction order, making this a potentially costly operation — up to O(live pages) of page copies. Batch
18 + /// deletions with ``deletePages(ids:wipe:durable:)`` or ``deletePagesRange(first:last:wipe:durable:)`` to amortize
| ├─suggestion: Insert '-(CBuffer,_,_)' for 'func deletePages(ids: CBuffer, wipe: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-(Data,_,_)' for 'func deletePages(ids: Data, wipe: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-(RawSpan,_,_)' for 'func deletePages(ids: RawSpan, wipe: Bool = false, durable: Bool = true) throws'
| ╰─suggestion: Insert '-([Data],_,_)' for 'func deletePages(ids: [Data], wipe: Bool = false, durable: Bool = true) throws'
19 | /// that cost.
20 | ///
warning: 'deletePagesRange(first:last:wipe:durable:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:18:64-18:106
16 | /// On ``CapacityPolicy/fifo`` volumes, deletion triggers a compaction pass that relocates live pages to preserve
17 | /// the eviction order, making this a potentially costly operation — up to O(live pages) of page copies. Batch
18 + /// deletions with ``deletePages(ids:wipe:durable:)`` or ``deletePagesRange(first:last:wipe:durable:)`` to amortize
| ├─suggestion: Insert '-(CBuffer,_,_,_)' for 'func deletePagesRange(first: CBuffer, last: CBuffer, wipe: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-(Data,_,_,_)' for 'func deletePagesRange(first: Data, last: Data, wipe: Bool = false, durable: Bool = true) throws'
| ╰─suggestion: Insert '-(RawSpan,_,_,_)' for 'func deletePagesRange(first: RawSpan, last: RawSpan, wipe: Bool = false, durable: Bool = true) throws'
19 | /// that cost.
20 | ///
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePage(id:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:26:21-26:32
24 | /// - durable: If `true`, block until data is durable on disk.
25 | ///
26 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `id` has the wrong length; ``DeletePagesError`` on
27 | /// delete failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid; ``CommonErrors/outOfMemory`` on
28 | /// allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePage(id:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:28:33-28:43
26 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `id` has the wrong length; ``DeletePagesError`` on
27 | /// delete failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid; ``CommonErrors/outOfMemory`` on
28 + /// allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
29 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
30 | func deletePage(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:57:21-57:32
55 | /// - durable: If `true`, block until data is durable on disk.
56 | ///
57 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `ids` is not a multiple of `idWidth`;
58 | /// ``DeletePagesError`` on delete failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
59 | /// ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:59:65-59:75
57 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `ids` is not a multiple of `idWidth`;
58 | /// ``DeletePagesError`` on delete failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
59 + /// ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database
60 | /// failure; ``UnknownLibPCacheError`` for unrecognized C error codes.
61 | func deletePages(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(counter:count:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:88:21-88:32
86 | /// - durable: If `true`, block until data is durable on disk.
87 | ///
88 + /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative; ``InvalidCall/idBufferIsNotTheExpectedSize``
89 | /// if the counter template width is wrong; ``DeletePagesError/invalidArgument`` if `position` is out of bounds, the
90 | /// counter overflows, or `endianness` is invalid; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(counter:count:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:88:78-88:89
86 | /// - durable: If `true`, block until data is durable on disk.
87 | ///
88 + /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative; ``InvalidCall/idBufferIsNotTheExpectedSize``
89 | /// if the counter template width is wrong; ``DeletePagesError/invalidArgument`` if `position` is out of bounds, the
90 | /// counter overflows, or `endianness` is invalid; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(counter:count:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:91:65-91:75
89 | /// if the counter template width is wrong; ``DeletePagesError/invalidArgument`` if `position` is out of bounds, the
90 | /// counter overflows, or `endianness` is invalid; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
91 + /// ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database
92 | /// failure; ``UnknownLibPCacheError`` for unrecognized C error codes.
93 | func deletePages(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePagesRange(first:last:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:129:21-129:32
127 | /// - durable: If `true`, block until data is durable on disk.
128 | ///
129 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if either buffer has the wrong length;
130 | /// ``DeletePagesError/invalidRange`` if `first > last`; ``CommonErrors/invalidHandle`` if the volume handle is
131 | /// invalid; ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePagesRange(first:last:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:131:74-131:84
129 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if either buffer has the wrong length;
130 | /// ``DeletePagesError/invalidRange`` if `first > last`; ``CommonErrors/invalidHandle`` if the volume handle is
131 + /// invalid; ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on
132 | /// database failure; ``UnknownLibPCacheError`` for unrecognized C error codes.
133 | func deletePagesRange(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePage(id:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:161:21-161:32
159 | /// - durable: If `true`, block until data is durable on disk.
160 | ///
161 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure; ``CommonErrors``,
162 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
163 | func deletePage(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePage(id:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:162:13-162:23
160 | ///
161 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure; ``CommonErrors``,
162 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
163 | func deletePage(
164 | id: RawSpan,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:180:21-180:32
178 | /// - durable: If `true`, block until data is durable on disk.
179 | ///
180 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure; ``CommonErrors``,
181 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
182 | func deletePages(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:181:13-181:23
179 | ///
180 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure; ``CommonErrors``,
181 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
182 | func deletePages(
183 | ids: RawSpan,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePagesRange(first:last:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:200:21-200:32
198 | /// - durable: If `true`, block until data is durable on disk.
199 | ///
200 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure; ``CommonErrors``,
201 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
202 | func deletePagesRange(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePagesRange(first:last:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:201:13-201:23
199 | ///
200 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure; ``CommonErrors``,
201 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
202 | func deletePagesRange(
203 | first: RawSpan,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePage(id:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:231:21-231:32
229 | /// - durable: If `true`, block until data is durable on disk.
230 | ///
231 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure; ``CommonErrors``,
232 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
233 | func deletePage(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePage(id:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:232:13-232:23
230 | ///
231 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure; ``CommonErrors``,
232 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
233 | func deletePage(
234 | id: Data,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:250:21-250:32
248 | /// - durable: If `true`, block until data is durable on disk.
249 | ///
250 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure; ``CommonErrors``,
251 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
252 | func deletePages(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:251:13-251:23
249 | ///
250 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure; ``CommonErrors``,
251 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
252 | func deletePages(
253 | ids: Data,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePagesRange(first:last:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:270:21-270:32
268 | /// - durable: If `true`, block until data is durable on disk.
269 | ///
270 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure; ``CommonErrors``,
271 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
272 | func deletePagesRange(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePagesRange(first:last:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:271:13-271:23
269 | ///
270 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure; ``CommonErrors``,
271 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
272 | func deletePagesRange(
273 | first: Data,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:301:21-301:32
299 | /// - durable: If `true`, block until data is durable on disk.
300 | ///
301 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure; ``CommonErrors``,
302 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
303 | func deletePages(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/deletePages(ids:wipe:durable:)'
--> Sources/libpcache_Swift/Public/PC-Delete.swift:302:13-302:23
300 | ///
301 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``DeletePagesError`` on delete failure; ``CommonErrors``,
302 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
303 | func deletePages(
304 | ids: [Data],
warning: Parameter 'options.preallocateDatabase' not found in type method declaration
--> Sources/libpcache_Swift/Public/PC-Lifecycle.swift:68:11-69:47
66 | /// - files: Paths to the database and data files.
67 | /// - configuration: Volume parameters (page size, capacity, id width, eviction policy).
68 + /// - options.preallocateDatabase: If `true`, pre-allocate slots in the index for all `maxPages` pages, enabling
| ╰─suggestion: Remove 'options.preallocateDatabase' parameter documentation
69 + /// O(1) allocation on subsequent inserts.
70 | /// - options.preallocateDatafile: If `true`, extend the data file to its maximum size immediately.
71 | ///
warning: Parameter 'options.preallocateDatafile' not found in type method declaration
--> Sources/libpcache_Swift/Public/PC-Lifecycle.swift:70:11-71:9
68 | /// - options.preallocateDatabase: If `true`, pre-allocate slots in the index for all `maxPages` pages, enabling
69 | /// O(1) allocation on subsequent inserts.
70 + /// - options.preallocateDatafile: If `true`, extend the data file to its maximum size immediately.
| ╰─suggestion: Remove 'options.preallocateDatafile' parameter documentation
71 + ///
72 | /// - Throws: ``CreateVolumeError`` if the volume cannot be created; ``POSIXError`` on I/O failure; ``SQLiteError``
73 | /// on database failure; ``UnknownLibPCacheError`` for unrecognized C error codes.
warning: Parameter 'options' is missing documentation
--> Sources/libpcache_Swift/Public/PC-Lifecycle.swift:71:9-71:9
69 | /// O(1) allocation on subsequent inserts.
70 | /// - options.preallocateDatafile: If `true`, extend the data file to its maximum size immediately.
71 + ///
| ╰─suggestion: Document 'options' parameter
72 | /// - Throws: ``CreateVolumeError`` if the volume cannot be created; ``POSIXError`` on I/O failure; ``SQLiteError``
73 | /// on database failure; ``UnknownLibPCacheError`` for unrecognized C error codes.
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/create(files:configuration:options:)'
--> Sources/libpcache_Swift/Public/PC-Lifecycle.swift:72:76-72:86
70 | /// - options.preallocateDatafile: If `true`, extend the data file to its maximum size immediately.
71 | ///
72 + /// - Throws: ``CreateVolumeError`` if the volume cannot be created; ``POSIXError`` on I/O failure; ``SQLiteError``
73 | /// on database failure; ``UnknownLibPCacheError`` for unrecognized C error codes.
74 | static func create(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/init(files:)'
--> Sources/libpcache_Swift/Public/PC-Lifecycle.swift:94:22-94:32
92 | ///
93 | /// - Throws: ``OpenVolumeError`` if the volume cannot be opened; ``CommonErrors/outOfMemory`` on allocation
94 + /// failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure; ``UnknownLibPCacheError`` for
95 | /// unrecognized C error codes.
96 | convenience init(files: FilePair) throws {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/close()'
--> Sources/libpcache_Swift/Public/PC-Lifecycle.swift:106:85-106:95
104 | /// errors are silenced in that path.
105 | ///
106 + /// - Throws: ``CommonErrors/invalidHandle`` if the volume handle is invalid; ``POSIXError`` on I/O failure;
107 | /// ``SQLiteError`` on WAL checkpoint failure; ``UnknownLibPCacheError`` for unrecognized C error codes.
108 | func close() throws {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/defragment(shrinkFile:durable:progress:)'
--> Sources/libpcache_Swift/Public/PC-Maintenance.swift:30:22-30:32
28 | /// - Throws: ``DefragmentVolumeError`` if the progress callback cancels the operation;
29 | /// ``CommonErrors/invalidHandle`` if the volume handle is invalid; ``CommonErrors/outOfMemory`` on allocation
30 + /// failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure; ``UnknownLibPCacheError`` for
31 | /// unrecognized C error codes.
32 | func defragment(shrinkFile: Bool, durable: Bool = true, progress: @escaping @Sendable (Double) -> Bool) throws {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/setNewMaxPages(_:durable:)'
--> Sources/libpcache_Swift/Public/PC-Maintenance.swift:49:21-49:32
47 | /// - durable: If `true`, block until data is durable on disk.
48 | ///
49 + /// - Throws: ``InvalidCall/invalidArguments`` if `maxPages` is ≤ 0; ``VolumeSetMaxPagesError`` if the reduction
50 | /// would discard pages on a FIXED volume; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
51 | /// ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/setNewMaxPages(_:durable:)'
--> Sources/libpcache_Swift/Public/PC-Maintenance.swift:51:65-51:75
49 | /// - Throws: ``InvalidCall/invalidArguments`` if `maxPages` is ≤ 0; ``VolumeSetMaxPagesError`` if the reduction
50 | /// would discard pages on a FIXED volume; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
51 + /// ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database
52 | /// failure; ``UnknownLibPCacheError`` for unrecognized C error codes.
53 | func setNewMaxPages(_ maxPages: Int, durable: Bool = true) throws {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/preallocate(database:datafile:durable:)'
--> Sources/libpcache_Swift/Public/PC-Maintenance.swift:68:21-68:32
66 | /// - durable: If `true`, block until data is durable on disk.
67 | ///
68 + /// - Throws: ``InvalidCall/invalidArguments`` if both flags are `false`; ``CommonErrors/invalidHandle`` if the
69 | /// volume handle is invalid; ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
70 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/preallocate(database:datafile:durable:)'
--> Sources/libpcache_Swift/Public/PC-Maintenance.swift:69:39-69:49
67 | ///
68 | /// - Throws: ``InvalidCall/invalidArguments`` if both flags are `false`; ``CommonErrors/invalidHandle`` if the
69 + /// volume handle is invalid; ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
70 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
71 | func preallocate(database: Bool, datafile: Bool, durable: Bool = true) throws {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:18:21-18:32
16 | /// - data: Destination buffer; must be exactly ``Configuration/pageSizeInt`` bytes.
17 | ///
18 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or ``InvalidCall/dataBufferIsNotTheExpectedSize`` if
19 | /// either buffer has the wrong length; ``GetPagesError`` on read failure; ``CommonErrors/invalidHandle`` if the
20 | /// volume handle is invalid; ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:18:69-18:80
16 | /// - data: Destination buffer; must be exactly ``Configuration/pageSizeInt`` bytes.
17 | ///
18 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or ``InvalidCall/dataBufferIsNotTheExpectedSize`` if
19 | /// either buffer has the wrong length; ``GetPagesError`` on read failure; ``CommonErrors/invalidHandle`` if the
20 | /// volume handle is invalid; ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:20:91-20:101
18 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or ``InvalidCall/dataBufferIsNotTheExpectedSize`` if
19 | /// either buffer has the wrong length; ``GetPagesError`` on read failure; ``CommonErrors/invalidHandle`` if the
20 + /// volume handle is invalid; ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure;
21 | /// ``SQLiteError`` on database failure; ``UnknownLibPCacheError`` for unrecognized C error codes.
22 | func getPage(id: CBuffer, data: CMutableBuffer) throws {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:37:21-37:32
35 | /// - data: Destination buffer; must be `count * pageSize` bytes.
36 | ///
37 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or
38 | /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer`` if the buffers are mismatched;
39 | /// ``GetPagesError`` on read failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:38:13-38:24
36 | ///
37 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or
38 + /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer`` if the buffers are mismatched;
39 | /// ``GetPagesError`` on read failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
40 | /// ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:40:65-40:75
38 | /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer`` if the buffers are mismatched;
39 | /// ``GetPagesError`` on read failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
40 + /// ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database
41 | /// failure; ``UnknownLibPCacheError`` for unrecognized C error codes.
42 | func getPages(ids: CBuffer, data: CMutableBuffer) throws {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(counter:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:54:21-54:32
52 | /// - data: Destination buffer; must be `count * pageSize` bytes.
53 | ///
54 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if the counter template width is wrong; ``GetPagesError``
55 | /// on read failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid; ``CommonErrors/outOfMemory`` on
56 | /// allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(counter:data:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:56:33-56:43
54 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if the counter template width is wrong; ``GetPagesError``
55 | /// on read failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid; ``CommonErrors/outOfMemory`` on
56 + /// allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
57 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
58 | func getPages(counter: Counter, data: CMutableBuffer) throws {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:88:21-88:32
86 | /// - Returns: The number of pages retrieved.
87 | ///
88 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if any buffer has the wrong length;
89 | /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer`` if `idsOut` and `pagesOut` have
90 | /// different capacities; ``GetPagesError/rangeInvalidRange`` if `first > last`;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:89:13-89:24
87 | ///
88 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if any buffer has the wrong length;
89 + /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer`` if `idsOut` and `pagesOut` have
90 | /// different capacities; ``GetPagesError/rangeInvalidRange`` if `first > last`;
91 | /// ``GetPagesError/rangeBufferTooSmall`` if the output buffers are too small; ``CommonErrors/invalidHandle`` if the
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:92:91-92:101
90 | /// different capacities; ``GetPagesError/rangeInvalidRange`` if `first > last`;
91 | /// ``GetPagesError/rangeBufferTooSmall`` if the output buffers are too small; ``CommonErrors/invalidHandle`` if the
92 + /// volume handle is invalid; ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure;
93 | /// ``SQLiteError`` on database failure; ``UnknownLibPCacheError`` for unrecognized C error codes.
94 | func getPagesRange(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:into:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:134:21-134:32
132 | /// - data: Destination buffer; must be at least ``Configuration/pageSizeInt`` bytes.
133 | ///
134 + /// - Throws: ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `data` is smaller than ``Configuration/pageSizeInt``
135 | /// bytes; ``InvalidCall/idBufferIsNotTheExpectedSize`` on invalid id; ``GetPagesError`` on read failure;
136 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:into:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:135:20-135:31
133 | ///
134 | /// - Throws: ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `data` is smaller than ``Configuration/pageSizeInt``
135 + /// bytes; ``InvalidCall/idBufferIsNotTheExpectedSize`` on invalid id; ``GetPagesError`` on read failure;
136 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
137 | func getPage(id: RawSpan, into data: consuming MutableRawSpan) throws {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:into:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:136:31-136:41
134 | /// - Throws: ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `data` is smaller than ``Configuration/pageSizeInt``
135 | /// bytes; ``InvalidCall/idBufferIsNotTheExpectedSize`` on invalid id; ``GetPagesError`` on read failure;
136 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
137 | func getPage(id: RawSpan, into data: consuming MutableRawSpan) throws {
138 | let pageSize = try configuration.pageSizeInt
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:into:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:159:21-159:32
157 | /// idWidth`.
158 | ///
159 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `ids.byteCount` is not a multiple of `idWidth`;
160 | /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `data` is smaller than required; ``GetPagesError`` on read
161 | /// failure; ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:into:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:160:13-160:24
158 | ///
159 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `ids.byteCount` is not a multiple of `idWidth`;
160 + /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `data` is smaller than required; ``GetPagesError`` on read
161 | /// failure; ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying
162 | /// operation.
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:into:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:161:40-161:50
159 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `ids.byteCount` is not a multiple of `idWidth`;
160 | /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `data` is smaller than required; ``GetPagesError`` on read
161 + /// failure; ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying
162 | /// operation.
163 | func getPages(ids: RawSpan, into data: consuming MutableRawSpan) throws {
warning: 'checkPagesRange(first:last:)-swift.method' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/PC-Read.swift:186:31-186:44
184 | /// Retrieves all pages whose identifier falls within the closed interval `[first, last]`.
185 | ///
186 + /// Call ``checkPagesRange(first:last:)-swift.method`` first to determine the required buffer capacity. Pages are
| ├─suggestion: Replace 'swift.method' with '(CBuffer,_)' for 'func checkPagesRange(first: CBuffer, last: CBuffer) throws -> Int'
| ├─suggestion: Replace 'swift.method' with '(RawSpan,_)' for 'func checkPagesRange(first: RawSpan, last: RawSpan) throws -> Int'
| ╰─suggestion: Replace 'swift.method' with '(ContiguousBytes,_)' for 'func checkPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> Int'
187 | /// returned in ascending identifier order.
188 | ///
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:197:21-197:32
195 | /// - Returns: The number of pages retrieved.
196 | ///
197 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `idsOut` is not a multiple of `idWidth`;
198 | /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `pagesOut` is not a multiple of `pageSize`;
199 | /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer`` if capacities differ;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:198:13-198:24
196 | ///
197 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `idsOut` is not a multiple of `idWidth`;
198 + /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `pagesOut` is not a multiple of `pageSize`;
199 | /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer`` if capacities differ;
200 | /// ``GetPagesError/rangeInvalidRange`` if `first > last`; ``GetPagesError/rangeBufferTooSmall`` if the buffers are
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:199:13-199:24
197 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if `idsOut` is not a multiple of `idWidth`;
198 | /// ``InvalidCall/dataBufferIsNotTheExpectedSize`` if `pagesOut` is not a multiple of `pageSize`;
199 + /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer`` if capacities differ;
200 | /// ``GetPagesError/rangeInvalidRange`` if `first > last`; ``GetPagesError/rangeBufferTooSmall`` if the buffers are
201 | /// too small; ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:201:42-201:52
199 | /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer`` if capacities differ;
200 | /// ``GetPagesError/rangeInvalidRange`` if `first > last`; ``GetPagesError/rangeBufferTooSmall`` if the buffers are
201 + /// too small; ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying
202 | /// operation.
203 | func getPagesRange(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:234:21-234:32
232 | ///
233 | /// - Returns: The page data.
234 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure; ``CommonErrors``,
235 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
236 | func getPage(id: some ContiguousBytes) throws -> Data {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPage(id:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:235:13-235:23
233 | /// - Returns: The page data.
234 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure; ``CommonErrors``,
235 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
236 | func getPage(id: some ContiguousBytes) throws -> Data {
237 | var data = try Data(count: configuration.pageSizeInt)
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:251:21-251:32
249 | ///
250 | /// - Returns: `Data` containing all retrieved pages concatenated.
251 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure; ``CommonErrors``,
252 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
253 | func getPages(ids: some ContiguousBytes) throws -> Data {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:252:13-252:23
250 | /// - Returns: `Data` containing all retrieved pages concatenated.
251 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure; ``CommonErrors``,
252 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
253 | func getPages(ids: some ContiguousBytes) throws -> Data {
254 | let cfg = try configuration
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(counter:count:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:276:21-276:32
274 | ///
275 | /// - Returns: `Data` containing all retrieved pages concatenated.
276 + /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative; ``InvalidCall`` on invalid buffer size;
277 | /// ``GetPagesError`` on read failure; ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or
278 | /// ``UnknownLibPCacheError`` from the underlying operation.
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(counter:count:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:276:78-276:89
274 | ///
275 | /// - Returns: `Data` containing all retrieved pages concatenated.
276 + /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative; ``InvalidCall`` on invalid buffer size;
277 | /// ``GetPagesError`` on read failure; ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or
278 | /// ``UnknownLibPCacheError`` from the underlying operation.
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(counter:count:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:277:66-277:76
275 | /// - Returns: `Data` containing all retrieved pages concatenated.
276 | /// - Throws: ``InvalidCall/invalidArguments`` if `count` is negative; ``InvalidCall`` on invalid buffer size;
277 + /// ``GetPagesError`` on read failure; ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or
278 | /// ``UnknownLibPCacheError`` from the underlying operation.
279 | func getPages(counter: Counter, count: Int) throws -> Data {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:296:21-296:32
294 | ///
295 | /// - Returns: Tuple containing `(ids, pages)`.
296 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure; ``CommonErrors``,
297 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
298 | func getPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> (ids: Data, pages: Data) {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:297:13-297:23
295 | /// - Returns: Tuple containing `(ids, pages)`.
296 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure; ``CommonErrors``,
297 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
298 | func getPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> (ids: Data, pages: Data) {
299 | let bufferCapacity = try checkPagesRange(first: first, last: last)
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:320:21-320:32
318 | ///
319 | /// - Returns: Array of `(id, page)` tuples, one per retrieved page.
320 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure; ``CommonErrors``,
321 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
322 | func getPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> [(id: Data, page: Data)] {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPagesRange(first:last:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:321:13-321:23
319 | /// - Returns: Array of `(id, page)` tuples, one per retrieved page.
320 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure; ``CommonErrors``,
321 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
322 | func getPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> [(id: Data, page: Data)] {
323 | let bufferCapacity = try checkPagesRange(first: first, last: last)
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:376:21-376:32
374 | ///
375 | /// - Returns: `Data` containing all retrieved pages concatenated.
376 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure; ``CommonErrors``,
377 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
378 | func getPages(ids: [Data]) throws -> Data {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:377:13-377:23
375 | /// - Returns: `Data` containing all retrieved pages concatenated.
376 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure; ``CommonErrors``,
377 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
378 | func getPages(ids: [Data]) throws -> Data {
379 | guard !ids.isEmpty else { return Data() }
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:397:21-397:32
395 | ///
396 | /// - Returns: Array of `Data` objects, one per page.
397 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure; ``CommonErrors``,
398 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
399 | func getPages(ids: [Data]) throws -> [Data] {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/getPages(ids:)'
--> Sources/libpcache_Swift/Public/PC-Read.swift:398:13-398:23
396 | /// - Returns: Array of `Data` objects, one per page.
397 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``GetPagesError`` on read failure; ``CommonErrors``,
398 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
399 | func getPages(ids: [Data]) throws -> [Data] {
400 | guard !ids.isEmpty else { return [] }
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPage(id:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:23:21-23:32
21 | /// - durable: If `true`, block until data is durable on disk.
22 | ///
23 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or ``InvalidCall/dataBufferIsNotTheExpectedSize`` if
24 | /// either buffer has the wrong length; ``PutPagesError`` on write failure; ``CommonErrors/invalidHandle`` if the
25 | /// volume handle is invalid; ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPage(id:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:23:69-23:80
21 | /// - durable: If `true`, block until data is durable on disk.
22 | ///
23 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or ``InvalidCall/dataBufferIsNotTheExpectedSize`` if
24 | /// either buffer has the wrong length; ``PutPagesError`` on write failure; ``CommonErrors/invalidHandle`` if the
25 | /// volume handle is invalid; ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPage(id:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:25:91-25:101
23 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or ``InvalidCall/dataBufferIsNotTheExpectedSize`` if
24 | /// either buffer has the wrong length; ``PutPagesError`` on write failure; ``CommonErrors/invalidHandle`` if the
25 + /// volume handle is invalid; ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure;
26 | /// ``SQLiteError`` on database failure; ``UnknownLibPCacheError`` for unrecognized C error codes.
27 | func putPage(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:55:21-55:32
53 | /// - durable: If `true`, block until data is durable on disk.
54 | ///
55 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or
56 | /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer`` if the buffers are mismatched;
57 | /// ``PutPagesError`` on write failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:56:13-56:24
54 | ///
55 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` or
56 + /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer`` if the buffers are mismatched;
57 | /// ``PutPagesError`` on write failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
58 | /// ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:58:65-58:75
56 | /// ``InvalidCall/numberOfItemsInIDBufferDoesNotMatchTheNumberOfItemsInDataBuffer`` if the buffers are mismatched;
57 | /// ``PutPagesError`` on write failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid;
58 + /// ``CommonErrors/outOfMemory`` on allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database
59 | /// failure; ``UnknownLibPCacheError`` for unrecognized C error codes.
60 | func putPages(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:86:21-86:32
84 | /// - durable: If `true`, block until data is durable on disk.
85 | ///
86 + /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if the counter template width is wrong; ``PutPagesError``
87 | /// on write failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid; ``CommonErrors/outOfMemory``
88 | /// on allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:88:36-88:46
86 | /// - Throws: ``InvalidCall/idBufferIsNotTheExpectedSize`` if the counter template width is wrong; ``PutPagesError``
87 | /// on write failure; ``CommonErrors/invalidHandle`` if the volume handle is invalid; ``CommonErrors/outOfMemory``
88 + /// on allocation failure; ``POSIXError`` on I/O failure; ``SQLiteError`` on database failure;
89 | /// ``UnknownLibPCacheError`` for unrecognized C error codes.
90 | func putPages(
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPage(id:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:127:21-127:32
125 | /// - durable: If `true`, block until data is durable on disk.
126 | ///
127 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
128 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
129 | func putPage(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPage(id:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:128:13-128:23
126 | ///
127 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
128 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
129 | func putPage(
130 | id: RawSpan,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:155:21-155:32
153 | /// - durable: If `true`, block until data is durable on disk.
154 | ///
155 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
156 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
157 | func putPages(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:156:13-156:23
154 | ///
155 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
156 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
157 | func putPages(
158 | ids: RawSpan,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:183:21-183:32
181 | /// - durable: If `true`, block until data is durable on disk.
182 | ///
183 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
184 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
185 | func putPages(counter: Counter, data: RawSpan, failIfExists: Bool = false, durable: Bool = true) throws {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:184:13-184:23
182 | ///
183 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
184 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
185 | func putPages(counter: Counter, data: RawSpan, failIfExists: Bool = false, durable: Bool = true) throws {
186 | try data.withUnsafeBytes { dataBuf in
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPage(id:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:208:21-208:32
206 | /// - durable: If `true`, block until data is durable on disk.
207 | ///
208 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
209 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
210 | func putPage(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPage(id:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:209:13-209:23
207 | ///
208 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
209 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
210 | func putPage(
211 | id: some ContiguousBytes,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:236:21-236:32
234 | /// - durable: If `true`, block until data is durable on disk.
235 | ///
236 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
237 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
238 | func putPages(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:237:13-237:23
235 | ///
236 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
237 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
238 | func putPages(
239 | ids: some ContiguousBytes,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:264:21-264:32
262 | /// - durable: If `true`, block until data is durable on disk.
263 | ///
264 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
265 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
266 | func putPages(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:265:13-265:23
263 | ///
264 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
265 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
266 | func putPages(
267 | counter: Counter,
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:316:21-316:32
314 | /// - durable: If `true`, block until data is durable on disk.
315 | ///
316 + /// - Throws: ``InvalidCall`` on invalid buffer size or mismatched array counts; ``PutPagesError`` on write failure;
317 | /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
318 | func putPages(ids: [Data], data: [Data], failIfExists: Bool = false, durable: Bool = true) throws {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(ids:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:317:31-317:41
315 | ///
316 | /// - Throws: ``InvalidCall`` on invalid buffer size or mismatched array counts; ``PutPagesError`` on write failure;
317 + /// ``CommonErrors``, ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
318 | func putPages(ids: [Data], data: [Data], failIfExists: Bool = false, durable: Bool = true) throws {
319 | guard ids.count == data.count else {
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:343:21-343:32
341 | /// - durable: If `true`, block until data is durable on disk.
342 | ///
343 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
344 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
345 | func putPages(counter: Counter, data: [Data], failIfExists: Bool = false, durable: Bool = true) throws {
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(counter:data:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:344:13-344:23
342 | ///
343 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
344 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
345 | func putPages(counter: Counter, data: [Data], failIfExists: Bool = false, durable: Bool = true) throws {
346 | guard !data.isEmpty else { return }
warning: 'InvalidCall' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(pages:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:370:21-370:32
368 | /// - durable: If `true`, block until data is durable on disk.
369 | ///
370 + /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
371 | /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
372 | func putPages(
warning: 'POSIXError' doesn't exist at '/libpcache_Swift/PersistentCache/putPages(pages:failIfExists:durable:)'
--> Sources/libpcache_Swift/Public/PC-Write.swift:371:13-371:23
369 | ///
370 | /// - Throws: ``InvalidCall`` on invalid buffer size; ``PutPagesError`` on write failure; ``CommonErrors``,
371 + /// ``POSIXError``, ``SQLiteError``, or ``UnknownLibPCacheError`` from the underlying operation.
372 | func putPages(
373 | pages: [(id: Data, data: Data)],
warning: 'putPage(id:data:failIfExists:durable:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:57:48-57:86
55 | /// Errors returned by write operations on a ``PersistentCache`` volume.
56 | ///
57 + /// Write operations include ``PersistentCache/putPage(id:data:failIfExists:durable:)``,
| ├─suggestion: Insert '-(CBuffer,_,_,_)' for 'func putPage(id: CBuffer, data: CBuffer, failIfExists: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-(RawSpan,_,_,_)' for 'func putPage(id: RawSpan, data: RawSpan, failIfExists: Bool = false, durable: Bool = true) throws'
| ╰─suggestion: Insert '-(ContiguousBytes,_,_,_)' for 'func putPage(id: some ContiguousBytes, data: some ContiguousBytes, failIfExists: Bool = false, durable: Bool = true) throws'
58 | /// ``PersistentCache/putPages(ids:data:failIfExists:durable:)``, and
59 | /// ``PersistentCache/putPages(counter:data:failIfExists:durable:)``.
warning: 'putPages(ids:data:failIfExists:durable:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:58:23-58:63
56 | ///
57 | /// Write operations include ``PersistentCache/putPage(id:data:failIfExists:durable:)``,
58 + /// ``PersistentCache/putPages(ids:data:failIfExists:durable:)``, and
| ├─suggestion: Insert '-(CBuffer,_,_,_)' for 'func putPages(ids: CBuffer, data: CBuffer, failIfExists: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-(RawSpan,_,_,_)' for 'func putPages(ids: RawSpan, data: RawSpan, failIfExists: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-([Data],_,_,_)' for 'func putPages(ids: [Data], data: [Data], failIfExists: Bool = false, durable: Bool = true) throws'
| ╰─suggestion: Insert '-(ContiguousBytes,_,_,_)' for 'func putPages(ids: some ContiguousBytes, data: some ContiguousBytes, failIfExists: Bool = false, durable: Bool = true) throws'
59 | /// ``PersistentCache/putPages(counter:data:failIfExists:durable:)``.
60 | public enum PutPagesError: Error, Equatable {
warning: 'putPages(counter:data:failIfExists:durable:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:59:23-59:67
57 | /// Write operations include ``PersistentCache/putPage(id:data:failIfExists:durable:)``,
58 | /// ``PersistentCache/putPages(ids:data:failIfExists:durable:)``, and
59 + /// ``PersistentCache/putPages(counter:data:failIfExists:durable:)``.
| ├─suggestion: Insert '-(_,CBuffer,_,_)' for 'func putPages(counter: Counter, data: CBuffer, failIfExists: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-(_,RawSpan,_,_)' for 'func putPages(counter: Counter, data: RawSpan, failIfExists: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-(_,[Data],_,_)' for 'func putPages(counter: Counter, data: [Data], failIfExists: Bool = false, durable: Bool = true) throws'
| ╰─suggestion: Insert '-(_,ContiguousBytes,_,_)' for 'func putPages(counter: Counter, data: some ContiguousBytes, failIfExists: Bool = false, durable: Bool = true) throws'
60 | public enum PutPagesError: Error, Equatable {
61 | /// FIXED volume is full and has no free slots.
warning: 'getPagesRange(first:last:idsOut:pagesOut:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:72:72-72:114
70 | ///
71 | /// Read operations include ``PersistentCache/getPage(id:data:)``, ``PersistentCache/getPages(ids:data:)``,
72 + /// ``PersistentCache/getPages(counter:data:)``, and ``PersistentCache/getPagesRange(first:last:idsOut:pagesOut:)``.
| ├─suggestion: Insert '-(CBuffer,_,_,_)' for 'func getPagesRange(first: CBuffer, last: CBuffer, idsOut: CMutableBuffer, pagesOut: CMutableBuffer) throws -> Int'
| ╰─suggestion: Insert '-(RawSpan,_,_,_)' for 'func getPagesRange(first: RawSpan, last: RawSpan, idsOut: consuming MutableRawSpan, pagesOut: consuming MutableRawSpan) throws -> Int'
73 | public enum GetPagesError: Error, Equatable {
74 | /// No page with the given identifier exists in the volume.
warning: 'checkPage(id:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:86:48-86:62
84 | /// Errors returned by check operations on a ``PersistentCache`` volume.
85 | ///
86 + /// Check operations include ``PersistentCache/checkPage(id:)``, ``PersistentCache/checkPages(ids:)``,
| ├─suggestion: Insert '-(CBuffer)' for 'func checkPage(id: CBuffer) throws -> Bool'
| ├─suggestion: Insert '-(RawSpan)' for 'func checkPage(id: RawSpan) throws -> Bool'
| ╰─suggestion: Insert '-(ContiguousBytes)' for 'func checkPage(id: some ContiguousBytes) throws -> Bool'
87 | /// ``PersistentCache/checkPages(counter:count:)``, and ``PersistentCache/checkPagesRange(first:last:)``.
88 | public enum CheckPagesError: Error, Equatable {
warning: 'checkPages(ids:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:86:84-86:100
84 | /// Errors returned by check operations on a ``PersistentCache`` volume.
85 | ///
86 + /// Check operations include ``PersistentCache/checkPage(id:)``, ``PersistentCache/checkPages(ids:)``,
| ├─suggestion: Insert '-([Data])' for 'func checkPages(ids: [Data]) throws -> [Bool]'
| ╰─suggestion: Insert '-(ContiguousBytes)' for 'func checkPages(ids: some ContiguousBytes) throws -> [Bool]'
87 | /// ``PersistentCache/checkPages(counter:count:)``, and ``PersistentCache/checkPagesRange(first:last:)``.
88 | public enum CheckPagesError: Error, Equatable {
warning: 'checkPagesRange(first:last:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:87:75-87:103
85 | ///
86 | /// Check operations include ``PersistentCache/checkPage(id:)``, ``PersistentCache/checkPages(ids:)``,
87 + /// ``PersistentCache/checkPages(counter:count:)``, and ``PersistentCache/checkPagesRange(first:last:)``.
| ├─suggestion: Insert '-(CBuffer,_)' for 'func checkPagesRange(first: CBuffer, last: CBuffer) throws -> Int'
| ├─suggestion: Insert '-(RawSpan,_)' for 'func checkPagesRange(first: RawSpan, last: RawSpan) throws -> Int'
| ╰─suggestion: Insert '-(ContiguousBytes,_)' for 'func checkPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> Int'
88 | public enum CheckPagesError: Error, Equatable {
89 | /// `position` is out of bounds, the counter would overflow, or `endianness` is invalid.
warning: 'deletePage(id:wipeDataFile:durable:)' doesn't exist at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:97:49-97:85
95 | /// Errors returned by delete operations on a ``PersistentCache`` volume.
96 | ///
97 + /// Delete operations include ``PersistentCache/deletePage(id:wipeDataFile:durable:)``,
| ╰─suggestion: Replace 'deletePage(id:wipeDataFile:durable:)' with 'deletePages(counter:count:wipe:durable:)'
98 | /// ``PersistentCache/deletePages(ids:wipeDataFile:durable:)``,
99 | /// ``PersistentCache/deletePages(counter:count:wipeDataFile:durable:)``, and
warning: 'deletePages(ids:wipeDataFile:durable:)' doesn't exist at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:98:23-98:61
96 | ///
97 | /// Delete operations include ``PersistentCache/deletePage(id:wipeDataFile:durable:)``,
98 + /// ``PersistentCache/deletePages(ids:wipeDataFile:durable:)``,
| ╰─suggestion: Replace 'deletePages(ids:wipeDataFile:durable:)' with 'deletePages(counter:count:wipe:durable:)'
99 | /// ``PersistentCache/deletePages(counter:count:wipeDataFile:durable:)``, and
100 | /// ``PersistentCache/deletePagesRange(first:last:wipeDataFile:durable:)``.
warning: 'deletePages(counter:count:wipeDataFile:durable:)' doesn't exist at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:99:23-99:71
97 | /// Delete operations include ``PersistentCache/deletePage(id:wipeDataFile:durable:)``,
98 | /// ``PersistentCache/deletePages(ids:wipeDataFile:durable:)``,
99 + /// ``PersistentCache/deletePages(counter:count:wipeDataFile:durable:)``, and
| ╰─suggestion: Replace 'deletePages(counter:count:wipeDataFile:durable:)' with 'deletePages(counter:count:wipe:durable:)'
100 | /// ``PersistentCache/deletePagesRange(first:last:wipeDataFile:durable:)``.
101 | public enum DeletePagesError: Error, Equatable {
warning: 'deletePagesRange(first:last:wipeDataFile:durable:)' doesn't exist at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/Errors.swift:100:23-100:73
98 | /// ``PersistentCache/deletePages(ids:wipeDataFile:durable:)``,
99 | /// ``PersistentCache/deletePages(counter:count:wipeDataFile:durable:)``, and
100 + /// ``PersistentCache/deletePagesRange(first:last:wipeDataFile:durable:)``.
| ╰─suggestion: Replace 'deletePagesRange(first:last:wipeDataFile:durable:)' with 'deletePagesRange(first:last:wipe:durable:)'
101 | public enum DeletePagesError: Error, Equatable {
102 | /// `first` is greater than `last`.
warning: 'PersistentCache.create(files:configuration:options:)' doesn't exist at '/libpcache_Swift/Configuration'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:44:18-44:70
42 | /// These values are fixed at creation time and stored in the `metadata` table of the SQLite index.
43 | ///
44 + /// - SeeAlso: ``PersistentCache.create(files:configuration:options:)`` to create a volume with this configuration
45 | public struct Configuration: Sendable, Equatable {
46 | /// Size of every page, in bytes.
warning: 'getPagesRange(first:last:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:154:49-154:75
152 | /// Byte order used when embedding a counter in page identifiers.
153 | ///
154 + /// When using range methods (``PersistentCache/getPagesRange(first:last:)``,
| ├─suggestion: Insert '->(_,_)' for 'func getPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> (ids: Data, pages: Data)'
| ╰─suggestion: Insert '->_' for 'func getPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> [(id: Data, page: Data)]'
155 | /// ``PersistentCache/checkPagesRange(first:last:)``, ``PersistentCache/deletePagesRange(first:last:)``) prefer
156 | /// ``bigEndian``. Range methods compare identifiers byte-by-byte (SQLite BLOB ordering). With big-endian, the
warning: 'checkPagesRange(first:last:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:155:23-155:51
153 | ///
154 | /// When using range methods (``PersistentCache/getPagesRange(first:last:)``,
155 + /// ``PersistentCache/checkPagesRange(first:last:)``, ``PersistentCache/deletePagesRange(first:last:)``) prefer
| ├─suggestion: Insert '-(CBuffer,_)' for 'func checkPagesRange(first: CBuffer, last: CBuffer) throws -> Int'
| ├─suggestion: Insert '-(RawSpan,_)' for 'func checkPagesRange(first: RawSpan, last: RawSpan) throws -> Int'
| ╰─suggestion: Insert '-(ContiguousBytes,_)' for 'func checkPagesRange(first: some ContiguousBytes, last: some ContiguousBytes) throws -> Int'
156 | /// ``bigEndian``. Range methods compare identifiers byte-by-byte (SQLite BLOB ordering). With big-endian, the
157 | /// most-significant byte occupies the lowest address, so a larger counter always produces a lexicographically greater
warning: 'deletePagesRange(first:last:)' doesn't exist at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:155:73-155:102
153 | ///
154 | /// When using range methods (``PersistentCache/getPagesRange(first:last:)``,
155 + /// ``PersistentCache/checkPagesRange(first:last:)``, ``PersistentCache/deletePagesRange(first:last:)``) prefer
| ├─suggestion: Replace 'deletePagesRange(first:last:)' with 'deletePagesRange(first:last:wipe:durable:)'
| ├─suggestion: Replace 'deletePagesRange(first:last:)' with 'getPagesRange(first:last:)'
| ╰─suggestion: Replace 'deletePagesRange(first:last:)' with 'checkPagesRange(first:last:)'
156 | /// ``bigEndian``. Range methods compare identifiers byte-by-byte (SQLite BLOB ordering). With big-endian, the
157 | /// most-significant byte occupies the lowest address, so a larger counter always produces a lexicographically greater
warning: 'template' doesn't exist at '/libpcache_Swift/Counter'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:172:78-172:86
170 | ///
171 | /// ``Counter`` derives page identifiers automatically from a template: a `UInt32` counter — starting at
172 + /// ``initialValue``, incremented per page — is XOR'd into four bytes of ``template``. The operations
173 | /// ``PersistentCache/putPages(counter:data:failIfExists:durable:)``, ``PersistentCache/getPages(counter:count:)``,
174 | /// ``PersistentCache/checkPages(counter:count:)``, and
warning: 'putPages(counter:data:failIfExists:durable:)' is ambiguous at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:173:23-173:67
171 | /// ``Counter`` derives page identifiers automatically from a template: a `UInt32` counter — starting at
172 | /// ``initialValue``, incremented per page — is XOR'd into four bytes of ``template``. The operations
173 + /// ``PersistentCache/putPages(counter:data:failIfExists:durable:)``, ``PersistentCache/getPages(counter:count:)``,
| ├─suggestion: Insert '-(_,CBuffer,_,_)' for 'func putPages(counter: Counter, data: CBuffer, failIfExists: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-(_,RawSpan,_,_)' for 'func putPages(counter: Counter, data: RawSpan, failIfExists: Bool = false, durable: Bool = true) throws'
| ├─suggestion: Insert '-(_,[Data],_,_)' for 'func putPages(counter: Counter, data: [Data], failIfExists: Bool = false, durable: Bool = true) throws'
| ╰─suggestion: Insert '-(_,ContiguousBytes,_,_)' for 'func putPages(counter: Counter, data: some ContiguousBytes, failIfExists: Bool = false, durable: Bool = true) throws'
174 | /// ``PersistentCache/checkPages(counter:count:)``, and
175 | /// ``PersistentCache/deletePages(counter:count:wipeDataFile:durable:)`` share the same identifier derivation scheme.
warning: 'deletePages(counter:count:wipeDataFile:durable:)' doesn't exist at '/libpcache_Swift/PersistentCache'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:175:23-175:71
173 | /// ``PersistentCache/putPages(counter:data:failIfExists:durable:)``, ``PersistentCache/getPages(counter:count:)``,
174 | /// ``PersistentCache/checkPages(counter:count:)``, and
175 + /// ``PersistentCache/deletePages(counter:count:wipeDataFile:durable:)`` share the same identifier derivation scheme.
| ╰─suggestion: Replace 'deletePages(counter:count:wipeDataFile:durable:)' with 'deletePages(counter:count:wipe:durable:)'
176 | /// The operations are therefore symmetric: the same `template`, `start`, `count`, `position`, and `endianness`
177 | /// reconstruct the same identifiers for reads, checks, and deletes as were used for writes.
warning: 'bigEndian' doesn't exist at '/libpcache_Swift/Counter'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:180:40-180:49
178 | ///
179 | /// ### Identifier Derivation Example With `idWidth = 8`, `template = {0xDE,0xAD,0xBE,0xEF, 0x00,0x00,0x00,0x00}`,
180 + /// `start = 5`, `position = 0`, and ``bigEndian``, the counter value 5 is encoded as `{0x00,0x00,0x00,0x05}` and XOR'd
181 | /// into bytes `[4..7]`: ```swift // template[4..7] ^ {0x00,0x00,0x00,0x05} = {0x00,0x00,0x00,0x05} // Derived id for
182 | /// counter 5: {0xDE,0xAD,0xBE,0xEF, 0x00,0x00,0x00,0x05} // Derived id for counter 6: {0xDE,0xAD,0xBE,0xEF,
warning: 'swift ' doesn't exist at '/libpcache_Swift/Counter'
--> Sources/libpcache_Swift/Public/Types/StructsAndEnums.swift:181:28-181:34
179 | /// ### Identifier Derivation Example With `idWidth = 8`, `template = {0xDE,0xAD,0xBE,0xEF, 0x00,0x00,0x00,0x00}`,
180 | /// `start = 5`, `position = 0`, and ``bigEndian``, the counter value 5 is encoded as `{0x00,0x00,0x00,0x05}` and XOR'd
181 + /// into bytes `[4..7]`: ```swift // template[4..7] ^ {0x00,0x00,0x00,0x05} = {0x00,0x00,0x00,0x05} // Derived id for
182 | /// counter 5: {0xDE,0xAD,0xBE,0xEF, 0x00,0x00,0x00,0x05} // Derived id for counter 6: {0xDE,0xAD,0xBE,0xEF,
183 | /// 0x00,0x00,0x00,0x06} ```
Finished building documentation for 'libpcache_Swift' (0.56s)
Generated documentation archive at:
/Users/admin/builder/spi-builder-workspace/.docs/ruinelson/libpcache_swift/main
Fetching https://github.com/swiftlang/swift-docc-plugin
[1/2345] Fetching swift-docc-plugin
Fetched https://github.com/swiftlang/swift-docc-plugin from cache (1.59s)
Computing version for https://github.com/swiftlang/swift-docc-plugin
Computed https://github.com/swiftlang/swift-docc-plugin at 1.5.0 (3.82s)
Fetching https://github.com/swiftlang/swift-docc-symbolkit
[1/3806] Fetching swift-docc-symbolkit
Fetched https://github.com/swiftlang/swift-docc-symbolkit from cache (1.48s)
Computing version for https://github.com/swiftlang/swift-docc-symbolkit
Computed https://github.com/swiftlang/swift-docc-symbolkit at 1.0.0 (2.17s)
Creating working copy for https://github.com/swiftlang/swift-docc-symbolkit
Working copy of https://github.com/swiftlang/swift-docc-symbolkit resolved at 1.0.0
Creating working copy for https://github.com/swiftlang/swift-docc-plugin
Working copy of https://github.com/swiftlang/swift-docc-plugin resolved at 1.5.0
Building for debugging...
[0/8] Write sources
[2/8] Write snippet-extract-tool-entitlement.plist
[3/8] Write sources
[4/8] Write swift-version--6988338F2F200930.txt
[6/54] Emitting module SymbolKit
[7/58] Compiling SymbolKit Identifier.swift
[8/58] Compiling SymbolKit KindIdentifier.swift
[9/58] Compiling SymbolKit Location.swift
[10/58] Compiling SymbolKit Mutability.swift
[11/58] Compiling SymbolKit Mixin+Equals.swift
[12/58] Compiling SymbolKit Mixin+Hash.swift
[13/58] Compiling SymbolKit Mixin.swift
[14/58] Compiling SymbolKit LineList.swift
[15/58] Compiling SymbolKit Position.swift
[16/58] Compiling SymbolKit GenericConstraint.swift
[17/58] Compiling SymbolKit GenericParameter.swift
[18/58] Compiling SymbolKit Generics.swift
[19/58] Compiling SymbolKit Namespace.swift
[20/58] Compiling SymbolKit Symbol.swift
[21/58] Compiling SymbolKit SymbolKind.swift
[22/58] Compiling SymbolKit SymbolGraph.swift
[23/58] Compiling SymbolKit GraphCollector.swift
[24/58] Compiling SymbolKit Relationship.swift
[25/58] Compiling SymbolKit RelationshipKind.swift
[26/58] Compiling SymbolKit SourceOrigin.swift
[27/58] Compiling SymbolKit GenericConstraints.swift
[28/58] Compiling SymbolKit Swift.swift
[29/58] Compiling Snippets SnippetParser.swift
[30/58] Compiling Snippets SnippetLanguage.swift
[31/58] Compiling Snippets Snippet.swift
[32/58] Emitting module Snippets
[33/58] Compiling SymbolKit DeclarationFragments.swift
[34/58] Compiling SymbolKit Fragment.swift
[35/58] Compiling SymbolKit FragmentKind.swift
[36/58] Compiling SymbolKit FunctionParameter.swift
[37/58] Compiling SymbolKit FunctionSignature.swift
[38/58] Compiling SymbolKit Names.swift
[39/58] Compiling SymbolKit SPI.swift
[40/58] Compiling SymbolKit Snippet.swift
[41/58] Compiling SymbolKit Extension.swift
[42/58] Compiling SymbolKit SourceRange.swift
[43/58] Compiling SymbolKit Metadata.swift
[44/58] Compiling SymbolKit Module.swift
[45/58] Compiling SymbolKit OperatingSystem.swift
[46/58] Compiling SymbolKit Platform.swift
[47/58] Compiling SymbolKit SemanticVersion.swift
[48/58] Compiling SymbolKit AccessControl.swift
[49/58] Compiling SymbolKit Availability.swift
[50/58] Compiling SymbolKit AvailabilityItem.swift
[51/58] Compiling SymbolKit Domain.swift
[52/58] Compiling SymbolKit UnifiedSymbol+Encodable.swift
[53/58] Compiling SymbolKit UnifiedSymbol.swift
[54/58] Compiling SymbolKit UnifiedSymbolGraph+Encodable.swift
[55/58] Compiling SymbolKit UnifiedSymbolGraph.swift
[56/62] Compiling snippet_extract URL+Status.swift
[57/62] Compiling snippet_extract SymbolGraph+Snippet.swift
[58/62] Emitting module snippet_extract
[59/62] Compiling snippet_extract SnippetBuildCommand.swift
[59/62] Write Objects.LinkFileList
[60/62] Linking snippet-extract-tool
[61/62] Applying snippet-extract-tool
Build of product 'snippet-extract' complete! (4.34s)
Building for debugging...
[0/1] Write swift-version--6988338F2F200930.txt
Build of target: 'libpcache_Swift' complete! (0.23s)
416
4 /Users/admin/builder/spi-builder-workspace/.docs/ruinelson/libpcache_swift/main
✅ Doc result (uploading) reported
========================================
SyncDocs
========================================
Doc archive source directory: $PWD/.docs/ruinelson/libpcache_swift/main
File count: 416
Doc size: 4.0MB
Preparing doc bundle ...
Using presigned URL upload - AWS credentials not required
Uploading -ruinelson-libpcache_swift-main-9aa3d589.zip to presigned URL
Starting upload of 826628 bytes...
Upload completed successfully
Done.