From 72e5dfd3ee799540212359dec853014762419d83 Mon Sep 17 00:00:00 2001
From: Joe Mooring <joe.mooring@veriphor.com>
Date: Sat, 19 Oct 2024 12:01:36 -0700
Subject: [PATCH] Documents strings.TrimSpace

---
 content/en/functions/strings/Chomp.md      |  1 +
 content/en/functions/strings/Trim.md       | 39 +---------------------
 content/en/functions/strings/TrimLeft.md   |  1 +
 content/en/functions/strings/TrimPrefix.md |  1 +
 content/en/functions/strings/TrimRight.md  |  1 +
 content/en/functions/strings/TrimSpace.md  | 26 +++++++++++++++
 content/en/functions/strings/TrimSuffix.md |  1 +
 7 files changed, 32 insertions(+), 38 deletions(-)
 create mode 100644 content/en/functions/strings/TrimSpace.md

diff --git a/content/en/functions/strings/Chomp.md b/content/en/functions/strings/Chomp.md
index 349f1e9b71..087de1fb8c 100644
--- a/content/en/functions/strings/Chomp.md
+++ b/content/en/functions/strings/Chomp.md
@@ -7,6 +7,7 @@ action:
   aliases: [chomp]
   related:
     - functions/strings/Trim
+    - functions/strings/TrimSpace
     - functions/strings/TrimLeft
     - functions/strings/TrimPrefix
     - functions/strings/TrimRight
diff --git a/content/en/functions/strings/Trim.md b/content/en/functions/strings/Trim.md
index 9a87ff2068..a8c4cf92de 100644
--- a/content/en/functions/strings/Trim.md
+++ b/content/en/functions/strings/Trim.md
@@ -7,6 +7,7 @@ action:
   aliases: [trim]
   related:
     - functions/strings/Chomp
+    - functions/strings/TrimSpace
     - functions/strings/TrimLeft
     - functions/strings/TrimPrefix
     - functions/strings/TrimRight
@@ -19,41 +20,3 @@ aliases: [/functions/trim]
 ```go-html-template
 {{ trim "++foo--" "+-" }} → foo
 ```
-
-To remove leading and trailing newline characters and carriage returns:
-
-```go-html-template
-{{ trim "\nfoo\n" "\n\r" }} → foo
-{{ trim "\n\nfoo\n\n" "\n\r" }} → foo
-
-{{ trim "\r\nfoo\r\n" "\n\r" }} → foo
-{{ trim "\r\n\r\nfoo\r\n\r\n" "\n\r" }} → foo
-```
-
-The `strings.Trim` function is commonly used in shortcodes to remove leading and trailing newlines characters and carriage returns from the content within the opening and closing shortcode tags.
-
-For example, with this Markdown:
-
-```text
-{{</* my-shortcode */>}}
-Able was I ere I saw Elba.
-{{</* /my-shortcode */>}}
-```
-
-The value of `.Inner` in the shortcode template is:
-
-```text
-\nAble was I ere I saw Elba.\n
-```
-
-If authored on a Windows system the value of `.Inner` might, depending on the editor configuration, be:
-
-```text
-\r\nAble was I ere I saw Elba.\r\n
-```
-
-This construct is common in shortcode templates:
-
-```go-html-template
-{{ trim .Inner "\n\r" }}
-```
diff --git a/content/en/functions/strings/TrimLeft.md b/content/en/functions/strings/TrimLeft.md
index 07cdf00641..d94aa05a3d 100644
--- a/content/en/functions/strings/TrimLeft.md
+++ b/content/en/functions/strings/TrimLeft.md
@@ -8,6 +8,7 @@ action:
   related:
     - functions/strings/Chomp
     - functions/strings/Trim
+    - functions/strings/TrimSpace
     - functions/strings/TrimPrefix
     - functions/strings/TrimRight
     - functions/strings/TrimSuffix
diff --git a/content/en/functions/strings/TrimPrefix.md b/content/en/functions/strings/TrimPrefix.md
index 917cf06f57..331c52a031 100644
--- a/content/en/functions/strings/TrimPrefix.md
+++ b/content/en/functions/strings/TrimPrefix.md
@@ -8,6 +8,7 @@ action:
   related:
     - functions/strings/Chomp
     - functions/strings/Trim
+    - functions/strings/TrimSpace
     - functions/strings/TrimLeft
     - functions/strings/TrimRight
     - functions/strings/TrimSuffix
diff --git a/content/en/functions/strings/TrimRight.md b/content/en/functions/strings/TrimRight.md
index b244925ef6..f36597d3d2 100644
--- a/content/en/functions/strings/TrimRight.md
+++ b/content/en/functions/strings/TrimRight.md
@@ -8,6 +8,7 @@ action:
   related:
     - functions/strings/Chomp
     - functions/strings/Trim
+    - functions/strings/TrimSpace
     - functions/strings/TrimLeft
     - functions/strings/TrimPrefix
     - functions/strings/TrimSuffix
diff --git a/content/en/functions/strings/TrimSpace.md b/content/en/functions/strings/TrimSpace.md
new file mode 100644
index 0000000000..12634b8a7c
--- /dev/null
+++ b/content/en/functions/strings/TrimSpace.md
@@ -0,0 +1,26 @@
+---
+title: strings.TrimSpace
+description: Returns the given string, removing leading and trailing whitespace as defined by Unicode.
+categories: []
+keywords: []
+action:
+  related:
+    - functions/strings/Chomp
+    - functions/strings/Trim
+    - functions/strings/TrimLeft
+    - functions/strings/TrimPrefix
+    - functions/strings/TrimRight
+    - functions/strings/TrimSuffix
+  returnType: string
+  signatures: [strings.TrimSpace INPUT]
+---
+
+{{< new-in 0.137.0 >}}
+
+Whitespace characters include `\t`, `\n`, `\v`, `\f`, `\r`, and characters in the [Space Separator] category.
+
+[Space Separator]: https://www.compart.com/en/unicode/category/Zs
+
+```go-html-template
+{{ strings.TrimSpace "\n\r\t   foo   \n\r\t" }} → foo
+```
diff --git a/content/en/functions/strings/TrimSuffix.md b/content/en/functions/strings/TrimSuffix.md
index 704bbd2d22..d612ae695f 100644
--- a/content/en/functions/strings/TrimSuffix.md
+++ b/content/en/functions/strings/TrimSuffix.md
@@ -8,6 +8,7 @@ action:
   related:
     - functions/strings/Chomp
     - functions/strings/Trim
+    - functions/strings/TrimSpace
     - functions/strings/TrimLeft
     - functions/strings/TrimPrefix
     - functions/strings/TrimRight