From 698bee234d880b5bf3ca14b73acab265e1c7445f Mon Sep 17 00:00:00 2001
From: "He-Pin(kerr)" <hepin1989@gmail.com>
Date: Fri, 19 Jun 2026 05:47:29 +0800
Subject: [PATCH] docs: document array parameter support in
 stripChars/lstripChars/rstripChars

---
 doc/ref/stdlib.html | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/doc/ref/stdlib.html b/doc/ref/stdlib.html
index af9a0648..ef45125a 100644
--- a/doc/ref/stdlib.html
+++ b/doc/ref/stdlib.html
@@ -625,6 +625,14 @@ <h4 id="std-stripChars">
       <p>
         Example: <code>std.stripChars("cacabbbbaacc", "ac")</code> yields <code>"bbbb"</code>.
       </p>
+      <p>
+        The <code>chars</code> parameter may also be an array of single-character strings. When an
+        array is provided, only single-character string elements are used as characters to strip;
+        non-string elements and multi-character strings are silently ignored.
+      </p>
+      <p>
+        Example: <code>std.stripChars("abcba", ["a", "c"])</code> yields <code>"bcb"</code>.
+      </p>
     </div>
     <div style="clear: both"></div>
   </div>
@@ -660,6 +668,14 @@ <h4 id="std-lstripChars">
       <p>
         Example: <code>std.lstripChars("cacabbbbaacc", "ac")</code> yields <code>"bbbbaacc"</code>.
       </p>
+      <p>
+        The <code>chars</code> parameter may also be an array of single-character strings. When an
+        array is provided, only single-character string elements are used as characters to strip;
+        non-string elements and multi-character strings are silently ignored.
+      </p>
+      <p>
+        Example: <code>std.lstripChars("abcba", ["a", "c"])</code> yields <code>"bcba"</code>.
+      </p>
     </div>
     <div style="clear: both"></div>
   </div>
@@ -695,6 +711,14 @@ <h4 id="std-rstripChars">
       <p>
         Example: <code>std.rstripChars("cacabbbbaacc", "ac")</code> yields <code>"cacabbbb"</code>.
       </p>
+      <p>
+        The <code>chars</code> parameter may also be an array of single-character strings. When an
+        array is provided, only single-character string elements are used as characters to strip;
+        non-string elements and multi-character strings are silently ignored.
+      </p>
+      <p>
+        Example: <code>std.rstripChars("abcba", ["a", "c"])</code> yields <code>"abcb"</code>.
+      </p>
     </div>
     <div style="clear: both"></div>
   </div>