From 3e2e19262013a35fb09a3f8185017a88685d107e Mon Sep 17 00:00:00 2001
From: Nick Anderson <nick@cmdln.org>
Date: Fri, 22 May 2026 11:45:48 -0500
Subject: [PATCH] ENT-14129: Add search_up() documentation as alias for
 findfiles_up()

search_up() was introduced in 3.18 as an alias for findfiles_up() but
was never documented.  Add a stub page at
content/reference/functions/search_up.markdown that points readers to
the findfiles_up() reference, and note the alias on the findfiles_up
page itself.
---
 content/reference/functions/findfiles_up.markdown |  3 ++-
 content/reference/functions/search_up.markdown    | 15 +++++++++++++++
 2 files changed, 17 insertions(+), 1 deletion(-)
 create mode 100644 content/reference/functions/search_up.markdown

diff --git a/content/reference/functions/findfiles_up.markdown b/content/reference/functions/findfiles_up.markdown
index bc2c0bd24..3c54c15f7 100644
--- a/content/reference/functions/findfiles_up.markdown
+++ b/content/reference/functions/findfiles_up.markdown
@@ -3,12 +3,13 @@ layout: default
 title: findfiles_up
 aliases:
   - "/reference-functions-findfiles_up.html"
+  - "/reference/functions/search_up"
 ---
 
 {{< CFEngine_function_prototype(path, glob, level) >}}
 
 **Description:** Return a data array of files that match a given glob pattern
-by searching up the directory tree.
+by searching up the directory tree. Also available as `search_up()`.
 
 This function searches for files matching a given glob pattern `glob` in the
 local filesystem by searching up the directory tree from a given absolute
diff --git a/content/reference/functions/search_up.markdown b/content/reference/functions/search_up.markdown
new file mode 100644
index 000000000..67f899129
--- /dev/null
+++ b/content/reference/functions/search_up.markdown
@@ -0,0 +1,15 @@
+---
+layout: default
+title: search_up
+aliases:
+  - "/reference-functions-search_up.html"
+alias: reference-functions-search_up
+---
+
+`search_up()` is an alias for `findfiles_up()`.
+
+See the `findfiles_up()` documentation for usage, examples, and details.
+
+**History:**
+
+- Introduced in 3.18 (as an alias for `findfiles_up()`).