From b05721869c404cbf5a5098aa625662e2b4345c6f Mon Sep 17 00:00:00 2001
From: "Y.D.X." <73375426+YDX-2147483647@users.noreply.github.com>
Date: Thu, 24 Jul 2025 18:24:21 +0800
Subject: [PATCH] Mention `text.costs` and `page.height` in the docs of
 `pagebreak`

---
 crates/typst-library/src/layout/page.rs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/crates/typst-library/src/layout/page.rs b/crates/typst-library/src/layout/page.rs
index 64ed99e34..38e4b8492 100644
--- a/crates/typst-library/src/layout/page.rs
+++ b/crates/typst-library/src/layout/page.rs
@@ -397,6 +397,12 @@ impl LocalName for PageElem {
 /// == Compound Theory
 /// In 1984, the first ...
 /// ```
+///
+/// Note that even without manual page breaks, the content will be automatically
+/// paginated based on the size of the content and the page. You could adjust
+/// [costs]($text.costs) to fine-tune the algorithm that prevents widows and
+/// orphans. You can also set [the page height]($page.height) to `{auto}` to
+/// let the page grow dynamically until a manual page break occurs.
 #[elem(title = "Page Break")]
 pub struct PagebreakElem {
     /// If `{true}`, the page break is skipped if the current page is already