From 63628f5369c4b24d41bf341f952559f070886a87 Mon Sep 17 00:00:00 2001
From: RogerHaase <haaserd@gmail.com>
Date: Sun, 15 Jun 2025 13:31:13 -0700
Subject: [PATCH] update docs for searching an item's subitems #1885

---
 docs/user/search.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/user/search.rst b/docs/user/search.rst
index e334eee6d..b1d3d8583 100644
--- a/docs/user/search.rst
+++ b/docs/user/search.rst
@@ -141,6 +141,19 @@ Search for something like wiki, willi, wi, ...::
   r"w.*i"
 
 
+Searching an item's subitems
+============================
+To limit the search to an item's sub-items, use a leading `>`, followed by the
+item's name, followed by the search arguments.
+
+Examples
+--------
+Wild cards, regular expressions, etc. may be used in the search arguments::
+
+  >colors blue
+  >users/JohnDoe red*
+  >home red OR blue OR green
+
 Searching in specific fields
 ============================