From a2aed3dcbb39af8ac3cbd206f76c96065670dc08 Mon Sep 17 00:00:00 2001 From: krflol Date: Thu, 8 Oct 2026 14:09:13 -0500 Subject: [PATCH] Point the Rust quickstart to the native Windows stack fix --- docs/getting-started/rust.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/getting-started/rust.md b/docs/getting-started/rust.md index 49c13aa..4ec4178 100644 --- a/docs/getting-started/rust.md +++ b/docs/getting-started/rust.md @@ -18,7 +18,7 @@ With Rust 1.85 or newer and a working native Rust toolchain: ```bash cargo new invoice-demo cd invoice-demo -cargo add fullbleed@=2.5.17 +cargo add fullbleed@=2.5.19 ``` Replace `src/main.rs` with: @@ -47,6 +47,11 @@ bytes, which you can also return from an HTTP handler or write to your own storage. For a file directly, use `engine.render_to_file(html, css, "invoice.pdf")?`. +For unoptimized builds on Windows, use 2.5.19 or newer. Versions 2.5.17 and +2.5.18 can overflow the default main-thread stack on small table layouts; +the [2.5.19 release](https://github.com/fullbleed-engine/fullbleed-official/releases/tag/v2.5.19) +includes the fix and its regression evidence. + This first example uses standard PDF fonts. For explicit typography and broader character coverage, register the font files your document uses. The Python wheel's bundled fonts are not included in the Rust crate. @@ -126,7 +131,7 @@ playground font files. The `register_font_file` and `register_font_dir` helpers are also available, but skip unreadable or invalid files. A glyph report can find missing characters; it does not prove that the intended typeface loaded. The -[API font guide](https://docs.rs/fullbleed/2.5.17/fullbleed/#supply-fonts-explicitly) +[API font guide](https://docs.rs/fullbleed/2.5.19/fullbleed/#supply-fonts-explicitly) explains these choices. For one PNG per page, preview the PDF you just wrote at your chosen DPI: @@ -142,9 +147,9 @@ designed example and downloaded playground projects use the same path. ## Keep building -Use [the hosted Rust API reference](https://docs.rs/fullbleed/2.5.17/fullbleed/) +Use [the hosted Rust API reference](https://docs.rs/fullbleed/2.5.19/fullbleed/) for the first-PDF program, method selection, fonts, and executable examples of -fixed-layout and reflowing templates. The quickstart above uses 2.5.17; the +fixed-layout and reflowing templates. The quickstart above uses 2.5.19; the downloadable designed starter remains pinned to 2.5.11 and matches the [2.5.11 source](https://github.com/fullbleed-engine/fullbleed-official/blob/v2.5.11/src/lib.rs). Check