From b13e5c4ff3dee91fcff37607ed9348d5024f1a74 Mon Sep 17 00:00:00 2001
From: AganzeFelicite <aganze@awesomity.rw>
Date: Thu, 22 Oct 2026 09:00:37 +0200
Subject: [PATCH] M7: doc comments on the font scan's folders and scan_dir
 (#298)

---
 crates/text/src/fontdb.rs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/crates/text/src/fontdb.rs b/crates/text/src/fontdb.rs
index edfe5b60..32d34679 100644
--- a/crates/text/src/fontdb.rs
+++ b/crates/text/src/fontdb.rs
@@ -731,6 +731,7 @@ impl FontDb {
     }
 }
 
+/// The folders this platform keeps installed and activated fonts in, walked by the font scan.
 fn system_font_dirs() -> Vec<std::path::PathBuf> {
     #[allow(unused_mut)]
     let mut v: Vec<std::path::PathBuf> = Vec::new();
@@ -794,6 +795,9 @@ fn unix_user_font_dirs(home: Option<std::ffi::OsString>, data_home: Option<std::
     dirs
 }
 
+/// Adds the faces of every font file under `dir` (up to six folders deep) to `out`, keyed by
+/// lowercased family: files named `.ttf`, `.otf`, `.ttc` or `.otc`, and files without an extension
+/// that start with a font signature.
 fn scan_dir(dir: &std::path::Path, depth: usize, out: &mut BTreeMap<String, (String, Vec<Pending>)>) {
     if depth > 6 {
         return;