From 49a23ad4218e2b37eb3a77091b26eb9308246e39 Mon Sep 17 00:00:00 2001
From: Xavier Noria <fxn@hashref.com>
Date: Sun, 23 Aug 2009 01:23:56 +0200
Subject: [PATCH] AS guide: documents String#squish

---
 railties/guides/source/active_support_overview.textile | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/railties/guides/source/active_support_overview.textile b/railties/guides/source/active_support_overview.textile
index 65ec023876..5e6c2030c6 100644
--- a/railties/guides/source/active_support_overview.textile
+++ b/railties/guides/source/active_support_overview.textile
@@ -682,6 +682,16 @@ h4. +bytesize+
 
 Ruby 1.9 introduces +String#bytesize+ to obtain the length of a string in bytes. Ruby 1.8.7 defines this method as an alias for +String#size+ for forward compatibility, and Active Support does so for previous versions.
 
+h4. +squish+
+
+The method +String#squish+ strips leading and trailing whitespace, and substitutes runs of whitespace with a single space each:
+
+<ruby>
+" \n  foo\n\r \t bar \n".squish # => "foo bar"
+</ruby>
+
+There's also the destructive version +String#squish!+.
+
 h3. Extensions to +Numeric+
 
 ...