From 4c874d82a23b2c8110865eb880bfac8cfd955bea Mon Sep 17 00:00:00 2001
From: Nghiathan13 <thanminhnghia3@gmail.com>
Date: Mon, 19 Oct 2026 03:10:48 +0700
Subject: [PATCH] #2964: document break_lines

---
 crates/layout/src/para.rs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/crates/layout/src/para.rs b/crates/layout/src/para.rs
index f80ce34ff..6a6a7ad78 100644
--- a/crates/layout/src/para.rs
+++ b/crates/layout/src/para.rs
@@ -1884,6 +1884,8 @@ fn ptab_stop(align: PTabAlign, base: PTabBase, leader: TabLeader, width: f32, in
     TabStop { pos, align, leader }
 }
 
+/// Break a paragraph into lines, measure each line, apply the paragraph's alignment and place
+/// the list label. Fills `pl.lines`, `pl.height` and the label's position.
 fn break_lines(pl: &mut ParaLayout, env: &ParaEnv, mark_style: u32, level: Option<&Level>) {
     // Narrow cells and float spans must retain their usable width.
     const MIN_LINE_WIDTH: f32 = 1.0;