Updated documentation for commit 3b6d95140393bf78930c9f4045ba2feab36f3946

2 files changed, 62 insertions, 55 deletions

diff --git a/api-index.json b/api-index.json
index 75d81b36..ef235bed 100644
--- a/api-index.json
+++ b/api-index.json
@@ -474,7 +474,7 @@
    "author":"Stuart Sierra",
    "doc":"String utilities for Clojure"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib/str-utils2-api.html",
    "name":"clojure.contrib.str-utils2",
@@ -4964,7 +4964,7 @@
    "Returns a string of all elements in 'sequence', separated by\n'separator'.  Like Perl's 'join'.",
    "name":"str-join"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L101",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L101",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/blank?",
    "namespace":"clojure.contrib.str-utils2",
@@ -4972,16 +4972,16 @@
    "doc":"True if s is nil, empty, or contains only whitespace.",
    "name":"blank?"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L120",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L126",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/butlast",
    "namespace":"clojure.contrib.str-utils2",
    "arglists":[["s", "n"]],
    "doc":
-   "Returns s without the last n characters.  Returns an empty string\nif n is greater than the length of s.",
+   "Returns s without the last n characters.  Returns an empty string\nif n is greater than the length of s.\n\nNote the argument order is the opposite of clojure.core/butlast;\nthis is to keep the string as the first argument for use with ->",
    "name":"butlast"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L258",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L267",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/capitalize",
    "namespace":"clojure.contrib.str-utils2",
@@ -4990,7 +4990,7 @@
    "Converts first character of the string to upper-case, all other\ncharacters to lower-case.",
    "name":"capitalize"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L231",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L240",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/chomp",
    "namespace":"clojure.contrib.str-utils2",
@@ -4999,7 +4999,7 @@
    "Removes all trailing newline \\n or return \\r characters from\nstring.  Note: String.trim() is similar and faster.",
    "name":"chomp"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L226",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L235",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/chop",
    "namespace":"clojure.contrib.str-utils2",
@@ -5007,7 +5007,7 @@
    "doc":"Removes the last character of string.",
    "name":"chop"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L77",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L77",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/codepoints",
    "namespace":"clojure.contrib.str-utils2",
@@ -5016,7 +5016,7 @@
    "Returns a sequence of integer Unicode code points in s.  Handles\nUnicode supplementary characters (above U+FFFF) correctly.",
    "name":"codepoints"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L310",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L319",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/contains?",
    "namespace":"clojure.contrib.str-utils2",
@@ -5024,7 +5024,7 @@
    "doc":"True if s contains the substring.",
    "name":"contains?"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L37",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L37",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/dochars",
    "namespace":"clojure.contrib.str-utils2",
@@ -5033,7 +5033,7 @@
    "bindings => [name string]\n\nRepeatedly executes body, with name bound to each character in\nstring.  Does NOT handle Unicode supplementary characters (above\nU+FFFF).",
    "name":"dochars"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L53",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L53",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/docodepoints",
    "namespace":"clojure.contrib.str-utils2",
@@ -5042,7 +5042,7 @@
    "bindings => [name string]\n\nRepeatedly executes body, with name bound to the integer code point\nof each Unicode character in the string.  Handles Unicode\nsupplementary characters (above U+FFFF) correctly.",
    "name":"docodepoints"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L90",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L90",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/escape",
    "namespace":"clojure.contrib.str-utils2",
@@ -5051,7 +5051,7 @@
    "Escapes characters in string according to a cmap, a function or map\nfrom characters to their replacements.",
    "name":"escape"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L315",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L324",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/get",
    "namespace":"clojure.contrib.str-utils2",
@@ -5059,7 +5059,7 @@
    "doc":"Gets the i'th character in string.",
    "name":"get"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L220",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L229",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/join",
    "namespace":"clojure.contrib.str-utils2",
@@ -5068,7 +5068,7 @@
    "Returns a string of all elements in coll, separated by\nseparator.  Like Perl's join.",
    "name":"join"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L294",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L303",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/lower-case",
    "namespace":"clojure.contrib.str-utils2",
@@ -5076,7 +5076,7 @@
    "doc":"Converts string to all lower-case.",
    "name":"lower-case"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L267",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L276",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/ltrim",
    "namespace":"clojure.contrib.str-utils2",
@@ -5084,7 +5084,7 @@
    "doc":"Removes whitespace from the left side of string.",
    "name":"ltrim"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L199",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L208",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/partition",
    "namespace":"clojure.contrib.str-utils2",
@@ -5093,7 +5093,7 @@
    "Splits the string into a lazy sequence of substrings, alternating\nbetween substrings that match the patthern and the substrings\nbetween the matches.  The sequence always starts with the substring\nbefore the first match, or an empty string if the beginning of the\nstring matches.\n\nFor example: (partition \"abc123def\" #\"[a-z]+\")\nreturns: (\"\" \"abc\" \"123\" \"def\")",
    "name":"partition"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L135",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L144",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/replace",
    "namespace":"clojure.contrib.str-utils2",
@@ -5102,7 +5102,7 @@
    "Replaces all instances of pattern in string with replacement.  \n\nAllowed argument types for pattern and replacement are:\n 1. String and String\n 2. Character and Character\n 3. regex Pattern and String\n    (Uses java.util.regex.Matcher.replaceAll)\n 4. regex Pattern and function\n    (Calls function with re-groups of each match, uses return \n     value as replacement.)",
    "name":"replace"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L170",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L179",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/replace-first",
    "namespace":"clojure.contrib.str-utils2",
@@ -5111,7 +5111,7 @@
    "Replaces the first instance of pattern in s with replacement.\n\nAllowed argument types for pattern and replacement are:\n 1. String and String\n 2. regex Pattern and String\n    (Uses java.util.regex.Matcher.replaceAll)\n 3. regex Pattern and function",
    "name":"replace-first"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L272",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L281",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/rtrim",
    "namespace":"clojure.contrib.str-utils2",
@@ -5119,7 +5119,7 @@
    "doc":"Removes whitespace from the right side of string.",
    "name":"rtrim"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L299",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L308",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/split",
    "namespace":"clojure.contrib.str-utils2",
@@ -5128,7 +5128,7 @@
    "Splits string on a regular expression.  Optional argument limit is\nthe maximum number of splits.",
    "name":"split"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L277",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L286",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/split-lines",
    "namespace":"clojure.contrib.str-utils2",
@@ -5136,7 +5136,7 @@
    "doc":"Splits s on \\n or \\r\\n.",
    "name":"split-lines"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L240",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L249",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/swap-case",
    "namespace":"clojure.contrib.str-utils2",
@@ -5145,7 +5145,7 @@
    "Changes upper case characters to lower case and vice-versa.\nHandles Unicode supplementary characters correctly.  Uses the\nlocale-sensitive String.toUpperCase() and String.toLowerCase()\nmethods.",
    "name":"swap-case"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L128",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L137",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/tail",
    "namespace":"clojure.contrib.str-utils2",
@@ -5153,15 +5153,16 @@
    "doc":"Returns the last n characters of s.",
    "name":"tail"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L106",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L106",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/take",
    "namespace":"clojure.contrib.str-utils2",
    "arglists":[["s", "n"]],
-   "doc":"Take first n characters from s, up to the length of s.",
+   "doc":
+   "Take first n characters from s, up to the length of s.\n\nNote the argument order is the opposite of clojure.core/take; this\nis to keep the string as the first argument for use with ->",
    "name":"take"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L305",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L314",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/trim",
    "namespace":"clojure.contrib.str-utils2",
@@ -5169,7 +5170,7 @@
    "doc":"Removes whitespace from both ends of string.",
    "name":"trim"},
   {"source-url":
-   "http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L289",
+   "http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L298",
    "wiki-url":
    "http://richhickey.github.com/clojure-contrib//str-utils2-api.html#str-utils2/upper-case",
    "namespace":"clojure.contrib.str-utils2",
diff --git a/str-utils2-api.html b/str-utils2-api.html
index 550e7516..6adc8b6b 100644
--- a/str-utils2-api.html
+++ b/str-utils2-api.html
@@ -142,7 +142,7 @@ Some ideas are borrowed from
   <pre id="var-usage">Usage: (blank? s)
 </pre>
   <pre id="var-docstr">True if s is nil, empty, or contains only whitespace.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L101" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L101" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -151,8 +151,11 @@ Some ideas are borrowed from
   <pre id="var-usage">Usage: (butlast s n)
 </pre>
   <pre id="var-docstr">Returns s without the last n characters.  Returns an empty string
-if n is greater than the length of s.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L120" id="var-source">Source</a>
+if n is greater than the length of s.
+
+Note the argument order is the opposite of clojure.core/butlast;
+this is to keep the string as the first argument for use with -&gt;</pre>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L126" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -162,7 +165,7 @@ if n is greater than the length of s.</pre>
 </pre>
   <pre id="var-docstr">Converts first character of the string to upper-case, all other
 characters to lower-case.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L258" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L267" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -172,7 +175,7 @@ characters to lower-case.</pre>
 </pre>
   <pre id="var-docstr">Removes all trailing newline \n or return \r characters from
 string.  Note: String.trim() is similar and faster.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L231" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L240" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -181,7 +184,7 @@ string.  Note: String.trim() is similar and faster.</pre>
   <pre id="var-usage">Usage: (chop s)
 </pre>
   <pre id="var-docstr">Removes the last character of string.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L226" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L235" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -191,7 +194,7 @@ string.  Note: String.trim() is similar and faster.</pre>
 </pre>
   <pre id="var-docstr">Returns a sequence of integer Unicode code points in s.  Handles
 Unicode supplementary characters (above U+FFFF) correctly.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L77" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L77" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -200,7 +203,7 @@ Unicode supplementary characters (above U+FFFF) correctly.</pre>
   <pre id="var-usage">Usage: (contains? s substring)
 </pre>
   <pre id="var-docstr">True if s contains the substring.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L310" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L319" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -213,7 +216,7 @@ Unicode supplementary characters (above U+FFFF) correctly.</pre>
 Repeatedly executes body, with name bound to each character in
 string.  Does NOT handle Unicode supplementary characters (above
 U+FFFF).</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L37" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L37" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -226,7 +229,7 @@ U+FFFF).</pre>
 Repeatedly executes body, with name bound to the integer code point
 of each Unicode character in the string.  Handles Unicode
 supplementary characters (above U+FFFF) correctly.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L53" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L53" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -236,7 +239,7 @@ supplementary characters (above U+FFFF) correctly.</pre>
 </pre>
   <pre id="var-docstr">Escapes characters in string according to a cmap, a function or map
 from characters to their replacements.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L90" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L90" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -245,7 +248,7 @@ from characters to their replacements.</pre>
   <pre id="var-usage">Usage: (get s i)
 </pre>
   <pre id="var-docstr">Gets the i'th character in string.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L315" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L324" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -255,7 +258,7 @@ from characters to their replacements.</pre>
 </pre>
   <pre id="var-docstr">Returns a string of all elements in coll, separated by
 separator.  Like Perl's join.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L220" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L229" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -264,7 +267,7 @@ separator.  Like Perl's join.</pre>
   <pre id="var-usage">Usage: (lower-case s)
 </pre>
   <pre id="var-docstr">Converts string to all lower-case.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L294" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L303" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -273,7 +276,7 @@ separator.  Like Perl's join.</pre>
   <pre id="var-usage">Usage: (ltrim s)
 </pre>
   <pre id="var-docstr">Removes whitespace from the left side of string.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L267" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L276" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -289,7 +292,7 @@ string matches.
 
 For example: (partition "abc123def" #"[a-z]+")
 returns: ("" "abc" "123" "def")</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L199" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L208" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -307,7 +310,7 @@ Allowed argument types for pattern and replacement are:
  4. regex Pattern and function
     (Calls function with re-groups of each match, uses return 
      value as replacement.)</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L135" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L144" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -322,7 +325,7 @@ Allowed argument types for pattern and replacement are:
  2. regex Pattern and String
     (Uses java.util.regex.Matcher.replaceAll)
  3. regex Pattern and function</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L170" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L179" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -331,7 +334,7 @@ Allowed argument types for pattern and replacement are:
   <pre id="var-usage">Usage: (rtrim s)
 </pre>
   <pre id="var-docstr">Removes whitespace from the right side of string.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L272" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L281" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -342,7 +345,7 @@ Allowed argument types for pattern and replacement are:
 </pre>
   <pre id="var-docstr">Splits string on a regular expression.  Optional argument limit is
 the maximum number of splits.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L299" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L308" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -351,7 +354,7 @@ the maximum number of splits.</pre>
   <pre id="var-usage">Usage: (split-lines s)
 </pre>
   <pre id="var-docstr">Splits s on \n or \r\n.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L277" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L286" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -363,7 +366,7 @@ the maximum number of splits.</pre>
 Handles Unicode supplementary characters correctly.  Uses the
 locale-sensitive String.toUpperCase() and String.toLowerCase()
 methods.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L240" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L249" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -372,7 +375,7 @@ methods.</pre>
   <pre id="var-usage">Usage: (tail s n)
 </pre>
   <pre id="var-docstr">Returns the last n characters of s.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L128" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L137" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -380,8 +383,11 @@ methods.</pre>
   <span id="var-type">function</span><br />
   <pre id="var-usage">Usage: (take s n)
 </pre>
-  <pre id="var-docstr">Take first n characters from s, up to the length of s.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L106" id="var-source">Source</a>
+  <pre id="var-docstr">Take first n characters from s, up to the length of s.
+
+Note the argument order is the opposite of clojure.core/take; this
+is to keep the string as the first argument for use with -&gt;</pre>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L106" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -390,7 +396,7 @@ methods.</pre>
   <pre id="var-usage">Usage: (trim s)
 </pre>
   <pre id="var-docstr">Removes whitespace from both ends of string.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L305" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L314" id="var-source">Source</a>
 </div><div id="var-entry">
   <br />
   <hr />
@@ -399,7 +405,7 @@ methods.</pre>
   <pre id="var-usage">Usage: (upper-case s)
 </pre>
   <pre id="var-docstr">Converts string to all upper-case.</pre>
-  <a href="http://github.com/richhickey/clojure-contrib/blob/8b360da5be1cac6612b3882037efa4c4c89ae643/src/clojure/contrib/str_utils2.clj#L289" id="var-source">Source</a>
+  <a href="http://github.com/richhickey/clojure-contrib/blob/3b6d95140393bf78930c9f4045ba2feab36f3946/src/clojure/contrib/str_utils2.clj#L298" id="var-source">Source</a>
 </div>