docs: record the PDF loading timeout and lifetime limitations

This commit is contained in:
Zhihui Song committed 2026-11-08 18:53:41 +08:00
1 parent 800a6f9fd7
commit 51934db382
1 file changed
+5
+5
View File
@@ -74,6 +74,11 @@ The narrow changes used by craft-print are:
An unsuccessful job requests cancellation; the status connection is unadvised
before its COM apartment is released. The timeout does not bound calls into a
printer driver or an interactive output-file dialog.
- PDF loading uses a read-only file-backed stream, but `LoadFromStreamAsync` is
currently joined without a deadline. The completion timeout above does not bound
document loading. Adding cancellation requires keeping the stream and temporary
file alive until the native operation has actually stopped; returning from a
timeout alone is not sufficient. This remains a known limitation of the loader.
- `WinPdfPrinter::print_with_progress(path, ticket, callback)` reports `(processed,
total)` after each successful Direct2D AddPage, preserving one job and its ticket.
These counts measure page processing, never physical printing or terminal success.