From 92014e2ee8c6f96cdf922675531388f5916fef10 Mon Sep 17 00:00:00 2001
From: Allen Webster <editor@4coder.net>
Date: Tue, 12 Jul 2016 18:17:45 -0400
Subject: [PATCH] finished up string docs, enhanced the match check rule

---
 4coder_API.html             | 761 ++++++++++++++++++++++++------------
 4coder_default_building.cpp |   9 +
 4coder_search.cpp           |  15 +-
 4coder_string.h             | 155 ++++----
 4ed_metagen.cpp             | 242 +++++++-----
 README.txt                  | 144 +++----
 internal_4coder_string.cpp  | 525 ++++++++++++++++++-------
 7 files changed, 1199 insertions(+), 652 deletions(-)

diff --git a/4coder_API.html b/4coder_API.html
index 91144fb6..5d6e6b91 100644
--- a/4coder_API.html
+++ b/4coder_API.html
@@ -2244,19 +2244,22 @@ int_color color;<br>
 </div>
 <div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#Style_Tag_doc'>Style_Tag</a></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#int_color_doc'>int_color</a></div></div><hr>
 <h2 id='section_string_library'>&sect;4 String Library</h2>
-<h3>&sect;4.1 String Function List</h3>
+<h3>&sect;4.1 String Intro</h3>
+<ul>
+<div><i>
+Coming Soon</i><div>
+<h3>&sect;4.2 String Function List</h3>
 <ul>
-<li><a href='#char_not_slash_str_doc'>char_not_slash</a></li>
 <li><a href='#char_is_slash_str_doc'>char_is_slash</a></li>
 <li><a href='#char_to_upper_str_doc'>char_to_upper</a></li>
 <li><a href='#char_to_lower_str_doc'>char_to_lower</a></li>
 <li><a href='#char_is_whitespace_str_doc'>char_is_whitespace</a></li>
 <li><a href='#char_is_alpha_numeric_str_doc'>char_is_alpha_numeric</a></li>
-<li><a href='#char_is_hex_str_doc'>char_is_hex</a></li>
-<li><a href='#char_is_numeric_str_doc'>char_is_numeric</a></li>
+<li><a href='#char_is_alpha_numeric_true_str_doc'>char_is_alpha_numeric_true</a></li>
 <li><a href='#char_is_alpha_str_doc'>char_is_alpha</a></li>
 <li><a href='#char_is_alpha_true_str_doc'>char_is_alpha_true</a></li>
-<li><a href='#char_is_alpha_numeric_true_str_doc'>char_is_alpha_numeric_true</a></li>
+<li><a href='#char_is_hex_str_doc'>char_is_hex</a></li>
+<li><a href='#char_is_numeric_str_doc'>char_is_numeric</a></li>
 <li><a href='#string_zero_str_doc'>string_zero</a></li>
 <li><a href='#make_string_str_doc'>make_string</a></li>
 <li><a href='#make_lit_string_str_doc'>make_lit_string</a></li>
@@ -2265,10 +2268,10 @@ int_color color;<br>
 <li><a href='#str_size_str_doc'>str_size</a></li>
 <li><a href='#make_string_slowly_str_doc'>make_string_slowly</a></li>
 <li><a href='#substr_str_doc'>substr</a></li>
-<li><a href='#tailstr_str_doc'>tailstr</a></li>
 <li><a href='#skip_whitespace_str_doc'>skip_whitespace</a></li>
 <li><a href='#chop_whitespace_str_doc'>chop_whitespace</a></li>
 <li><a href='#skip_chop_whitespace_str_doc'>skip_chop_whitespace</a></li>
+<li><a href='#tailstr_str_doc'>tailstr</a></li>
 <li><a href='#match_str_doc'>match</a></li>
 <li><a href='#match_part_str_doc'>match_part</a></li>
 <li><a href='#match_insensitive_str_doc'>match_insensitive</a></li>
@@ -2313,626 +2316,904 @@ int_color color;<br>
 <li><a href='#remove_last_folder_str_doc'>remove_last_folder</a></li>
 <li><a href='#string_set_match_str_doc'>string_set_match</a></li>
 </ul>
-<h3>&sect;4.2 String Function Descriptions</h3>
+<h3>&sect;4.3 String Function Descriptions</h3>
 <ul>
-<div id='char_not_slash_str_doc'> <h4>&sect;4.2.1: char_not_slash</h4>
- <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
-fstr_bool char_not_slash(
-<div style='margin-left: 4mm;'>char c<br></div>)
-</div>
-</div><hr>
-<div id='char_is_slash_str_doc'> <h4>&sect;4.2.2: char_is_slash</h4>
+<div id='char_is_slash_str_doc'> <h4>&sect;4.3.1: char_is_slash</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool char_is_slash(
 <div style='margin-left: 4mm;'>char c<br></div>)
 </div>
-</div><hr>
-<div id='char_to_upper_str_doc'> <h4>&sect;4.2.3: char_to_upper</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if c is \ or /.</div></div><hr>
+<div id='char_to_upper_str_doc'> <h4>&sect;4.3.2: char_to_upper</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 char char_to_upper(
 <div style='margin-left: 4mm;'>char c<br></div>)
 </div>
-</div><hr>
-<div id='char_to_lower_str_doc'> <h4>&sect;4.2.4: char_to_lower</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>If c is a lowercase letter this call returns the uppercase equivalent, otherwise it returns c.</div></div><hr>
+<div id='char_to_lower_str_doc'> <h4>&sect;4.3.3: char_to_lower</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 char char_to_lower(
 <div style='margin-left: 4mm;'>char c<br></div>)
 </div>
-</div><hr>
-<div id='char_is_whitespace_str_doc'> <h4>&sect;4.2.5: char_is_whitespace</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>If c is an uppercase letter this call returns the lowercase equivalent, otherwise it returns c.</div></div><hr>
+<div id='char_is_whitespace_str_doc'> <h4>&sect;4.3.4: char_is_whitespace</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool char_is_whitespace(
 <div style='margin-left: 4mm;'>char c<br></div>)
 </div>
-</div><hr>
-<div id='char_is_alpha_numeric_str_doc'> <h4>&sect;4.2.6: char_is_alpha_numeric</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if c is whitespace.</div></div><hr>
+<div id='char_is_alpha_numeric_str_doc'> <h4>&sect;4.3.5: char_is_alpha_numeric</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool char_is_alpha_numeric(
 <div style='margin-left: 4mm;'>char c<br></div>)
 </div>
-</div><hr>
-<div id='char_is_hex_str_doc'> <h4>&sect;4.2.7: char_is_hex</h4>
- <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
-fstr_bool char_is_hex(
-<div style='margin-left: 4mm;'>char c<br></div>)
-</div>
-</div><hr>
-<div id='char_is_numeric_str_doc'> <h4>&sect;4.2.8: char_is_numeric</h4>
- <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
-fstr_bool char_is_numeric(
-<div style='margin-left: 4mm;'>char c<br></div>)
-</div>
-</div><hr>
-<div id='char_is_alpha_str_doc'> <h4>&sect;4.2.9: char_is_alpha</h4>
- <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
-fstr_bool char_is_alpha(
-<div style='margin-left: 4mm;'>char c<br></div>)
-</div>
-</div><hr>
-<div id='char_is_alpha_true_str_doc'> <h4>&sect;4.2.10: char_is_alpha_true</h4>
- <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
-fstr_bool char_is_alpha_true(
-<div style='margin-left: 4mm;'>char c<br></div>)
-</div>
-</div><hr>
-<div id='char_is_alpha_numeric_true_str_doc'> <h4>&sect;4.2.11: char_is_alpha_numeric_true</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if c is any alphanumeric character including underscore.</div></div><hr>
+<div id='char_is_alpha_numeric_true_str_doc'> <h4>&sect;4.3.6: char_is_alpha_numeric_true</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool char_is_alpha_numeric_true(
 <div style='margin-left: 4mm;'>char c<br></div>)
 </div>
-</div><hr>
-<div id='string_zero_str_doc'> <h4>&sect;4.2.12: string_zero</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if c is any alphanumeric character no including underscore.</div></div><hr>
+<div id='char_is_alpha_str_doc'> <h4>&sect;4.3.7: char_is_alpha</h4>
+ <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
+fstr_bool char_is_alpha(
+<div style='margin-left: 4mm;'>char c<br></div>)
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if c is any alphabetic character including underscore.</div></div><hr>
+<div id='char_is_alpha_true_str_doc'> <h4>&sect;4.3.8: char_is_alpha_true</h4>
+ <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
+fstr_bool char_is_alpha_true(
+<div style='margin-left: 4mm;'>char c<br></div>)
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if c is any alphabetic character.</div></div><hr>
+<div id='char_is_hex_str_doc'> <h4>&sect;4.3.9: char_is_hex</h4>
+ <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
+fstr_bool char_is_hex(
+<div style='margin-left: 4mm;'>char c<br></div>)
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if c is any valid hexadecimal digit.</div></div><hr>
+<div id='char_is_numeric_str_doc'> <h4>&sect;4.3.10: char_is_numeric</h4>
+ <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
+fstr_bool char_is_numeric(
+<div style='margin-left: 4mm;'>char c<br></div>)
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if c is any valid decimal digit.</div></div><hr>
+<div id='string_zero_str_doc'> <h4>&sect;4.3.11: string_zero</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 String string_zero(
 <div style='margin-left: 4mm;'><br></div>)
 </div>
-</div><hr>
-<div id='make_string_str_doc'> <h4>&sect;4.2.13: make_string</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns a String struct of zeroed members.</div></div><hr>
+<div id='make_string_str_doc'> <h4>&sect;4.3.12: make_string</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 String make_string(
 <div style='margin-left: 4mm;'>void *str,<br>int32_t size,<br>int32_t mem_size<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.14: make_string</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>str</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The str parameter provides the of memory with which the string shall operate.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>size</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The size parameter expresses the initial size of the string.
+If the memory does not already contain a useful string this should be zero.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>mem_size</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The mem_size parameter expresses the full size of the memory provided by str.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns the String created from the parameters.</div></div><hr>
+<div> <h4>&sect;4.3.13: make_string</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 String make_string(
 <div style='margin-left: 4mm;'>void *str,<br>int32_t size<br></div>)
 </div>
-</div><hr>
-<div id='make_lit_string_str_doc'> <h4>&sect;4.2.15: make_lit_string</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>str</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The str parameter provides the of memory with which the string shall operate.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>size</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The size parameter expresses the initial size of the string.
+If the memory does not already contain a useful string this should be zero. Since this version
+does not specify the size of the memory it is also assumed that this size is the maximum size
+of the memory.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns the String created from the parameters.</div></div><hr>
+<div id='make_lit_string_str_doc'> <h4>&sect;4.3.14: make_lit_string</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 #define make_lit_string(s)</div>
-</div><hr>
-<div id='make_fixed_width_string_str_doc'> <h4>&sect;4.2.16: make_fixed_width_string</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This macro takes a literal string in quotes and uses it to create a String
+with the correct size and memory size.  Strings created this way should usually not be mutated.</div></div><hr>
+<div id='make_fixed_width_string_str_doc'> <h4>&sect;4.3.15: make_fixed_width_string</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 #define make_fixed_width_string(s)</div>
-</div><hr>
-<div id='expand_str_str_doc'> <h4>&sect;4.2.17: expand_str</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This macro takes a local char array with a fixed width and uses it to create
+an empty String with the correct size and memory size to operate on the array.</div></div><hr>
+<div id='expand_str_str_doc'> <h4>&sect;4.3.16: expand_str</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 #define expand_str(s)</div>
-</div><hr>
-<div id='str_size_str_doc'> <h4>&sect;4.2.18: str_size</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This macro is a helper for any calls that take a char*,int pair to specify a
+string. This macro expands to both of those parameters from one String struct.</div></div><hr>
+<div id='str_size_str_doc'> <h4>&sect;4.3.17: str_size</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t str_size(
 <div style='margin-left: 4mm;'>char *str<br></div>)
 </div>
-</div><hr>
-<div id='make_string_slowly_str_doc'> <h4>&sect;4.2.19: make_string_slowly</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns the number of bytes before a null terminator starting at str.</div></div><hr>
+<div id='make_string_slowly_str_doc'> <h4>&sect;4.3.18: make_string_slowly</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 String make_string_slowly(
 <div style='margin-left: 4mm;'>void *str<br></div>)
 </div>
-</div><hr>
-<div id='substr_str_doc'> <h4>&sect;4.2.20: substr</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call makes a string by counting the number of bytes before a null terminator and
+treating that as the size and memory size of the string.</div></div><hr>
+<div id='substr_str_doc'> <h4>&sect;4.3.19: substr</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 String substr(
 <div style='margin-left: 4mm;'>String str,<br>int32_t start<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.21: substr</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call creates a substring of str that starts with an offset from str's base.
+The new string uses the same underlying memory so both strings will see changes.
+Usually strings created this way should only go through immutable calls.</div></div><hr>
+<div> <h4>&sect;4.3.20: substr</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 String substr(
 <div style='margin-left: 4mm;'>String str,<br>int32_t start,<br>int32_t size<br></div>)
 </div>
-</div><hr>
-<div id='tailstr_str_doc'> <h4>&sect;4.2.22: tailstr</h4>
- <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
-String tailstr(
-<div style='margin-left: 4mm;'>String str<br></div>)
-</div>
-</div><hr>
-<div id='skip_whitespace_str_doc'> <h4>&sect;4.2.23: skip_whitespace</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call creates a substring of str that starts with an offset from str's base,
+and has a fixed size. The new string uses the same underlying memory so both strings
+will see changes. Usually strings created this way should only go through immutable calls.</div></div><hr>
+<div id='skip_whitespace_str_doc'> <h4>&sect;4.3.21: skip_whitespace</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 String skip_whitespace(
 <div style='margin-left: 4mm;'>String str<br></div>)
 </div>
-</div><hr>
-<div id='chop_whitespace_str_doc'> <h4>&sect;4.2.24: chop_whitespace</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call creates a substring that starts with the first non-whitespace character of str.
+Like other substr calls, the new string uses the underlying memory and so should usually be
+considered immutable.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#substr_doc'>substr</a></div></div><hr>
+<div id='chop_whitespace_str_doc'> <h4>&sect;4.3.22: chop_whitespace</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 String chop_whitespace(
 <div style='margin-left: 4mm;'>String str<br></div>)
 </div>
-</div><hr>
-<div id='skip_chop_whitespace_str_doc'> <h4>&sect;4.2.25: skip_chop_whitespace</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call creates a substring that ends with the last non-whitespace character of str.
+Like other substr calls, the new string uses the underlying memory and so should usually be
+considered immutable.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#substr_doc'>substr</a></div></div><hr>
+<div id='skip_chop_whitespace_str_doc'> <h4>&sect;4.3.23: skip_chop_whitespace</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 String skip_chop_whitespace(
 <div style='margin-left: 4mm;'>String str<br></div>)
 </div>
-</div><hr>
-<div id='match_str_doc'> <h4>&sect;4.2.26: match</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call is equivalent to calling skip_whitespace and chop_whitespace together.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#skip_whitespace_doc'>skip_whitespace</a></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#chop_whitespace_doc'>chop_whitespace</a></div></div><hr>
+<div id='tailstr_str_doc'> <h4>&sect;4.3.24: tailstr</h4>
+ <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
+String tailstr(
+<div style='margin-left: 4mm;'>String str<br></div>)
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns an empty String with underlying memory taken from
+the portion of str's memory that is not used.</div></div><hr>
+<div id='match_str_doc'> <h4>&sect;4.3.25: match</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match(
 <div style='margin-left: 4mm;'>char *a,<br>char *b<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.27: match</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if a and b are equivalent.</div></div><hr>
+<div> <h4>&sect;4.3.26: match</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match(
 <div style='margin-left: 4mm;'>String a,<br>char *b<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.28: match</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if a and b are equivalent.</div></div><hr>
+<div> <h4>&sect;4.3.27: match</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match(
 <div style='margin-left: 4mm;'>char *a,<br>String b<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.29: match</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if a and b are equivalent.</div></div><hr>
+<div> <h4>&sect;4.3.28: match</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match(
 <div style='margin-left: 4mm;'>String a,<br>String b<br></div>)
 </div>
-</div><hr>
-<div id='match_part_str_doc'> <h4>&sect;4.2.30: match_part</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if a and b are equivalent.</div></div><hr>
+<div id='match_part_str_doc'> <h4>&sect;4.3.29: match_part</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_part(
 <div style='margin-left: 4mm;'>char *a,<br>char *b,<br>int32_t *len<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.31: match_part</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>len</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>If this call returns non-zero this parameter is used to output the length of b.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call is similar to a match call, except that it is permitted for a to be longer than b.
+In other words this call returns non-zero if b is a prefix of a.</div></div><hr>
+<div> <h4>&sect;4.3.30: match_part</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_part(
 <div style='margin-left: 4mm;'>String a,<br>char *b,<br>int32_t *len<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.32: match_part</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>len</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>If this call returns non-zero this parameter is used to output the length of b.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call is similar to a match call, except that it is permitted for a to be longer than b.
+In other words this call returns non-zero if b is a prefix of a.</div></div><hr>
+<div> <h4>&sect;4.3.31: match_part</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_part(
 <div style='margin-left: 4mm;'>char *a,<br>char *b<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.33: match_part</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>len</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>If this call returns non-zero this parameter is used to output the length of b.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call is similar to a match call, except that it is permitted for a to be longer than b.
+In other words this call returns non-zero if b is a prefix of a.</div></div><hr>
+<div> <h4>&sect;4.3.32: match_part</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_part(
 <div style='margin-left: 4mm;'>String a,<br>char *b<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.34: match_part</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call is similar to a match call, except that it is permitted for a to be longer than b.
+In other words this call returns non-zero if b is a prefix of a.</div></div><hr>
+<div> <h4>&sect;4.3.33: match_part</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_part(
 <div style='margin-left: 4mm;'>char *a,<br>String b<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.35: match_part</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call is similar to a match call, except that it is permitted for a to be longer than b.
+In other words this call returns non-zero if b is a prefix of a.</div></div><hr>
+<div> <h4>&sect;4.3.34: match_part</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_part(
 <div style='margin-left: 4mm;'>String a,<br>String b<br></div>)
 </div>
-</div><hr>
-<div id='match_insensitive_str_doc'> <h4>&sect;4.2.36: match_insensitive</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call is similar to a match call, except that it is permitted for a to be longer than b.
+In other words this call returns non-zero if b is a prefix of a.</div></div><hr>
+<div id='match_insensitive_str_doc'> <h4>&sect;4.3.35: match_insensitive</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_insensitive(
 <div style='margin-left: 4mm;'>char *a,<br>char *b<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.37: match_insensitive</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if a and b are equivalent under case insensitive comparison.</div></div><hr>
+<div> <h4>&sect;4.3.36: match_insensitive</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_insensitive(
 <div style='margin-left: 4mm;'>String a,<br>char *b<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.38: match_insensitive</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if a and b are equivalent under case insensitive comparison.</div></div><hr>
+<div> <h4>&sect;4.3.37: match_insensitive</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_insensitive(
 <div style='margin-left: 4mm;'>char *a,<br>String b<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.39: match_insensitive</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if a and b are equivalent under case insensitive comparison.</div></div><hr>
+<div> <h4>&sect;4.3.38: match_insensitive</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_insensitive(
 <div style='margin-left: 4mm;'>String a,<br>String b<br></div>)
 </div>
-</div><hr>
-<div id='match_part_insensitive_str_doc'> <h4>&sect;4.2.40: match_part_insensitive</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if a and b are equivalent under case insensitive comparison.</div></div><hr>
+<div id='match_part_insensitive_str_doc'> <h4>&sect;4.3.39: match_part_insensitive</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_part_insensitive(
 <div style='margin-left: 4mm;'>char *a,<br>char *b,<br>int32_t *len<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.41: match_part_insensitive</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>len</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>If this call returns non-zero this parameter is used to output the length of b.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call performs the same partial matching rule as match_part under case insensitive comparison.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#match_part_doc'>match_part</a></div></div><hr>
+<div> <h4>&sect;4.3.40: match_part_insensitive</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_part_insensitive(
 <div style='margin-left: 4mm;'>String a,<br>char *b,<br>int32_t *len<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.42: match_part_insensitive</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>len</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>If this call returns non-zero this parameter is used to output the length of b.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call performs the same partial matching rule as match_part under case insensitive comparison.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#match_part_doc'>match_part</a></div></div><hr>
+<div> <h4>&sect;4.3.41: match_part_insensitive</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_part_insensitive(
 <div style='margin-left: 4mm;'>char *a,<br>char *b<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.43: match_part_insensitive</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call performs the same partial matching rule as match_part under case insensitive comparison.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#match_part_doc'>match_part</a></div></div><hr>
+<div> <h4>&sect;4.3.42: match_part_insensitive</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_part_insensitive(
 <div style='margin-left: 4mm;'>String a,<br>char *b<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.44: match_part_insensitive</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call performs the same partial matching rule as match_part under case insensitive comparison.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#match_part_doc'>match_part</a></div></div><hr>
+<div> <h4>&sect;4.3.43: match_part_insensitive</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_part_insensitive(
 <div style='margin-left: 4mm;'>char *a,<br>String b<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.45: match_part_insensitive</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call performs the same partial matching rule as match_part under case insensitive comparison.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#match_part_doc'>match_part</a></div></div><hr>
+<div> <h4>&sect;4.3.44: match_part_insensitive</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool match_part_insensitive(
 <div style='margin-left: 4mm;'>String a,<br>String b<br></div>)
 </div>
-</div><hr>
-<div id='compare_str_doc'> <h4>&sect;4.2.46: compare</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call performs the same partial matching rule as match_part under case insensitive comparison.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#match_part_doc'>match_part</a></div></div><hr>
+<div id='compare_str_doc'> <h4>&sect;4.3.45: compare</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t compare(
 <div style='margin-left: 4mm;'>char *a,<br>char *b<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.47: compare</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns zero if a and b are equivalent,
+it returns negative if a sorts before b alphabetically,
+and positive if a sorts after b alphabetically.</div></div><hr>
+<div> <h4>&sect;4.3.46: compare</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t compare(
 <div style='margin-left: 4mm;'>String a,<br>char *b<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.48: compare</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns zero if a and b are equivalent,
+it returns negative if a sorts before b alphabetically,
+and positive if a sorts after b alphabetically.</div></div><hr>
+<div> <h4>&sect;4.3.47: compare</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t compare(
 <div style='margin-left: 4mm;'>char *a,<br>String b<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.49: compare</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns zero if a and b are equivalent,
+it returns negative if a sorts before b alphabetically,
+and positive if a sorts after b alphabetically.</div></div><hr>
+<div> <h4>&sect;4.3.48: compare</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t compare(
 <div style='margin-left: 4mm;'>String a,<br>String b<br></div>)
 </div>
-</div><hr>
-<div id='find_str_doc'> <h4>&sect;4.2.50: find</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns zero if a and b are equivalent,
+it returns negative if a sorts before b alphabetically,
+and positive if a sorts after b alphabetically.</div></div><hr>
+<div id='find_str_doc'> <h4>&sect;4.3.49: find</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t find(
 <div style='margin-left: 4mm;'>char *str,<br>int32_t start,<br>char character<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.51: find</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>str</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The str parameter provides a null terminated string to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>start</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The start parameter provides the index of the first character in str to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>character</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The character parameter provides the character for which to search.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns the index of the first occurance of character, or the size of the string
+if the character is not found.</div></div><hr>
+<div> <h4>&sect;4.3.50: find</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t find(
 <div style='margin-left: 4mm;'>String str,<br>int32_t start,<br>char character<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.52: find</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>str</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The str parameter provides a string to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>start</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The start parameter provides the index of the first character in str to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>character</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The character parameter provides the character for which to search.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns the index of the first occurance of character, or the size of the string
+if the character is not found.</div></div><hr>
+<div> <h4>&sect;4.3.51: find</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t find(
 <div style='margin-left: 4mm;'>char *str,<br>int32_t start,<br>char *characters<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.53: find</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>str</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The str parameter provides a null terminated string to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>start</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The start parameter provides the index of the first character in str to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>character</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The characters parameter provides a null terminated array of characters for which to search.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns the index of the first occurance of a character in the characters array,
+or the size of the string if no such character is not found.</div></div><hr>
+<div> <h4>&sect;4.3.52: find</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t find(
 <div style='margin-left: 4mm;'>String str,<br>int32_t start,<br>char *characters<br></div>)
 </div>
-</div><hr>
-<div id='find_substr_str_doc'> <h4>&sect;4.2.54: find_substr</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>str</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The str parameter provides a string to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>start</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The start parameter provides the index of the first character in str to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>character</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The characters parameter provides a null terminated array of characters for which to search.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns the index of the first occurance of a character in the characters array,
+or the size of the string if no such character is not found.</div></div><hr>
+<div id='find_substr_str_doc'> <h4>&sect;4.3.53: find_substr</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t find_substr(
 <div style='margin-left: 4mm;'>char *str,<br>int32_t start,<br>String seek<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.55: find_substr</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>str</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The str parameter provides a null terminated string to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>start</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The start parameter provides the index of the first character in str to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>seek</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The seek parameter provides a string to find in str.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns the index of the first occurance of the seek substring in str or the
+size of str if no such substring in str is found.</div></div><hr>
+<div> <h4>&sect;4.3.54: find_substr</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t find_substr(
 <div style='margin-left: 4mm;'>String str,<br>int32_t start,<br>String seek<br></div>)
 </div>
-</div><hr>
-<div id='rfind_substr_str_doc'> <h4>&sect;4.2.56: rfind_substr</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>str</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The str parameter provides a string to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>start</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The start parameter provides the index of the first character in str to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>seek</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The seek parameter provides a string to find in str.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns the index of the first occurance of the seek substring in str or the
+size of str if no such substring in str is found.</div></div><hr>
+<div id='rfind_substr_str_doc'> <h4>&sect;4.3.55: rfind_substr</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t rfind_substr(
 <div style='margin-left: 4mm;'>String str,<br>int32_t start,<br>String seek<br></div>)
 </div>
-</div><hr>
-<div id='find_substr_insensitive_str_doc'> <h4>&sect;4.2.57: find_substr_insensitive</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>str</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The str parameter provides a string to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>start</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The start parameter provides the index of the first character in str to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>seek</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The seek parameter provides a string to find in str.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns the index of the last occurance of the seek substring in str
+or -1 if no such substring in str is found.</div></div><hr>
+<div id='find_substr_insensitive_str_doc'> <h4>&sect;4.3.56: find_substr_insensitive</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t find_substr_insensitive(
 <div style='margin-left: 4mm;'>char *str,<br>int32_t start,<br>String seek<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.58: find_substr_insensitive</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>str</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The str parameter provides a null terminated string to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>start</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The start parameter provides the index of the first character in str to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>seek</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The seek parameter provides a string to find in str.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call acts as find_substr under case insensitive comparison.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#find_substr_doc'>find_substr</a></div></div><hr>
+<div> <h4>&sect;4.3.57: find_substr_insensitive</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t find_substr_insensitive(
 <div style='margin-left: 4mm;'>String str,<br>int32_t start,<br>String seek<br></div>)
 </div>
-</div><hr>
-<div id='has_substr_str_doc'> <h4>&sect;4.2.59: has_substr</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>str</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The str parameter provides a string to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>start</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The start parameter provides the index of the first character in str to search.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>seek</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The seek parameter provides a string to find in str.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call acts as find_substr under case insensitive comparison.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#find_substr_doc'>find_substr</a></div></div><hr>
+<div id='has_substr_str_doc'> <h4>&sect;4.3.58: has_substr</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool has_substr(
 <div style='margin-left: 4mm;'>char *s,<br>String seek<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.60: has_substr</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if the string s contains a substring equivalent to seek.</div></div><hr>
+<div> <h4>&sect;4.3.59: has_substr</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool has_substr(
 <div style='margin-left: 4mm;'>String s,<br>String seek<br></div>)
 </div>
-</div><hr>
-<div id='has_substr_insensitive_str_doc'> <h4>&sect;4.2.61: has_substr_insensitive</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if the string s contains a substring equivalent to seek.</div></div><hr>
+<div id='has_substr_insensitive_str_doc'> <h4>&sect;4.3.60: has_substr_insensitive</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool has_substr_insensitive(
 <div style='margin-left: 4mm;'>char *s,<br>String seek<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.62: has_substr_insensitive</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if the string s contains a substring equivalent to seek
+under case insensitive comparison.</div></div><hr>
+<div> <h4>&sect;4.3.61: has_substr_insensitive</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool has_substr_insensitive(
 <div style='margin-left: 4mm;'>String s,<br>String seek<br></div>)
 </div>
-</div><hr>
-<div id='copy_fast_unsafe_str_doc'> <h4>&sect;4.2.63: copy_fast_unsafe</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns non-zero if the string s contains a substring equivalent to seek
+under case insensitive comparison.</div></div><hr>
+<div id='copy_fast_unsafe_str_doc'> <h4>&sect;4.3.62: copy_fast_unsafe</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t copy_fast_unsafe(
 <div style='margin-left: 4mm;'>char *dest,<br>char *src<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.64: copy_fast_unsafe</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call performs a copy from the src buffer to the dest buffer.
+The copy does not stop until a null terminator is found in src.  There
+is no safety against overrun so dest must be large enough to contain src.
+The null terminator is not written to dest. This call returns the number
+of bytes coppied to dest.</div></div><hr>
+<div> <h4>&sect;4.3.63: copy_fast_unsafe</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
-void copy_fast_unsafe(
+int32_t copy_fast_unsafe(
 <div style='margin-left: 4mm;'>char *dest,<br>String src<br></div>)
 </div>
-</div><hr>
-<div id='copy_checked_str_doc'> <h4>&sect;4.2.65: copy_checked</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call performs a copy from the src string to the dest buffer.
+The copy does not stop until src.size characters are coppied.  There
+is no safety against overrun so dest must be large enough to contain src.
+The null terminator is not written to dest. This call returns the number
+of bytes coppied to dest.</div></div><hr>
+<div id='copy_checked_str_doc'> <h4>&sect;4.3.64: copy_checked</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool copy_checked(
 <div style='margin-left: 4mm;'>String *dest,<br>String src<br></div>)
 </div>
-</div><hr>
-<div id='copy_partial_str_doc'> <h4>&sect;4.2.66: copy_partial</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call performs a copy from the src string to the dest string.
+The memory_size of dest is checked before any coppying is done.
+This call returns non-zero on a successful copy.</div></div><hr>
+<div id='copy_partial_str_doc'> <h4>&sect;4.3.65: copy_partial</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool copy_partial(
 <div style='margin-left: 4mm;'>String *dest,<br>char *src<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.67: copy_partial</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call performs a copy from the src buffer to the dest string.
+The memory_size of dest is checked if the entire copy cannot be performed,
+as many bytes as possible are coppied to dest. This call returns non-zero
+if the entire string is coppied to dest.</div></div><hr>
+<div> <h4>&sect;4.3.66: copy_partial</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool copy_partial(
 <div style='margin-left: 4mm;'>String *dest,<br>String src<br></div>)
 </div>
-</div><hr>
-<div id='copy_str_doc'> <h4>&sect;4.2.68: copy</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call performs a copy from the src string to the dest string.
+The memory_size of dest is checked if the entire copy cannot be performed,
+as many bytes as possible are coppied to dest. This call returns non-zero
+if the entire string is coppied to dest.</div></div><hr>
+<div id='copy_str_doc'> <h4>&sect;4.3.67: copy</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t copy(
 <div style='margin-left: 4mm;'>char *dest,<br>char *src<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.69: copy</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call performs a copy from src to dest equivalent to copy_fast_unsafe.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#copy_fast_unsafe_doc'>copy_fast_unsafe</a></div></div><hr>
+<div> <h4>&sect;4.3.68: copy</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 void copy(
 <div style='margin-left: 4mm;'>String *dest,<br>String src<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.70: copy</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call performs a copy from src to dest equivalent to copy_checked.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#copy_checked_doc'>copy_checked</a></div></div><hr>
+<div> <h4>&sect;4.3.69: copy</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 void copy(
 <div style='margin-left: 4mm;'>String *dest,<br>char *src<br></div>)
 </div>
-</div><hr>
-<div id='append_checked_str_doc'> <h4>&sect;4.2.71: append_checked</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call performs a copy from src to dest equivalent to copy_partial.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#copy_partial_doc'>copy_partial</a></div></div><hr>
+<div id='append_checked_str_doc'> <h4>&sect;4.3.70: append_checked</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool append_checked(
 <div style='margin-left: 4mm;'>String *dest,<br>String src<br></div>)
 </div>
-</div><hr>
-<div id='append_partial_str_doc'> <h4>&sect;4.2.72: append_partial</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call checks if there is enough space in dest's underlying memory
+to append src onto dest. If there is src is appended and the call returns non-zero.</div></div><hr>
+<div id='append_partial_str_doc'> <h4>&sect;4.3.71: append_partial</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool append_partial(
 <div style='margin-left: 4mm;'>String *dest,<br>char *src<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.73: append_partial</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call attemps to append as much of src into the space in dest's underlying memory
+as possible.  If the entire string is appended the call returns non-zero.</div></div><hr>
+<div> <h4>&sect;4.3.72: append_partial</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool append_partial(
 <div style='margin-left: 4mm;'>String *dest,<br>String src<br></div>)
 </div>
-</div><hr>
-<div id='append_str_doc'> <h4>&sect;4.2.74: append</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call attemps to append as much of src into the space in dest's underlying memory
+as possible.  If the entire string is appended the call returns non-zero.</div></div><hr>
+<div id='append_str_doc'> <h4>&sect;4.3.73: append</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool append(
 <div style='margin-left: 4mm;'>String *dest,<br>char c<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.75: append</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call attemps to append c onto dest.  If there is space left in dest's underlying
+memory the character is appended and the call returns non-zero.</div></div><hr>
+<div> <h4>&sect;4.3.74: append</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool append(
 <div style='margin-left: 4mm;'>String *dest,<br>String src<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.76: append</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call is equivalent to append_partial.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#append_partial_doc'>append_partial</a></div></div><hr>
+<div> <h4>&sect;4.3.75: append</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool append(
 <div style='margin-left: 4mm;'>String *dest,<br>char *src<br></div>)
 </div>
-</div><hr>
-<div id='terminate_with_null_str_doc'> <h4>&sect;4.2.77: terminate_with_null</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call is equivalent to append_partial.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#append_partial_doc'>append_partial</a></div></div><hr>
+<div id='terminate_with_null_str_doc'> <h4>&sect;4.3.76: terminate_with_null</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool terminate_with_null(
 <div style='margin-left: 4mm;'>String *str<br></div>)
 </div>
-</div><hr>
-<div id='append_padding_str_doc'> <h4>&sect;4.2.78: append_padding</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call attemps to append a null terminator onto str without effecting the
+size of str. This is usually called when the time comes to pass the the string to an
+API that requires a null terminator.  This call returns non-zero if there was a spare
+byte in the strings underlying memory.</div></div><hr>
+<div id='append_padding_str_doc'> <h4>&sect;4.3.77: append_padding</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool append_padding(
 <div style='margin-left: 4mm;'>String *dest,<br>char c,<br>int32_t target_size<br></div>)
 </div>
-</div><hr>
-<div id='replace_char_str_doc'> <h4>&sect;4.2.79: replace_char</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call pads out dest so that it has a size of target_size by appending
+the padding character c until the target size is achieved.  This call returns
+non-zero if dest does not run out of space in the underlying memory.</div></div><hr>
+<div id='replace_char_str_doc'> <h4>&sect;4.3.78: replace_char</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 void replace_char(
 <div style='margin-left: 4mm;'>String *str,<br>char replace,<br>char with<br></div>)
 </div>
-</div><hr>
-<div id='int_to_str_size_str_doc'> <h4>&sect;4.2.80: int_to_str_size</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>str</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The str parameter provides the string in which replacement shall be performed.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>replace</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The replace character specifies which character should be replaced.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>with</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The with character specifies what to write into the positions where replacement occurs.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call replaces all occurances of character in str with another character.</div></div><hr>
+<div id='int_to_str_size_str_doc'> <h4>&sect;4.3.79: int_to_str_size</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t int_to_str_size(
 <div style='margin-left: 4mm;'>int32_t x<br></div>)
 </div>
-</div><hr>
-<div id='int_to_str_str_doc'> <h4>&sect;4.2.81: int_to_str</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns the number of bytes required to represent x as a string.</div></div><hr>
+<div id='int_to_str_str_doc'> <h4>&sect;4.3.80: int_to_str</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool int_to_str(
 <div style='margin-left: 4mm;'>String *dest,<br>int32_t x<br></div>)
 </div>
-</div><hr>
-<div id='append_int_to_str_str_doc'> <h4>&sect;4.2.82: append_int_to_str</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call writes a string representation of x into dest. If there is enough
+space in dest this call returns non-zero.</div></div><hr>
+<div id='append_int_to_str_str_doc'> <h4>&sect;4.3.81: append_int_to_str</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool append_int_to_str(
 <div style='margin-left: 4mm;'>String *dest,<br>int32_t x<br></div>)
 </div>
-</div><hr>
-<div id='u64_to_str_size_str_doc'> <h4>&sect;4.2.83: u64_to_str_size</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call appends a string representation of x onto dest. If there is enough
+space in dest this call returns non-zero.</div></div><hr>
+<div id='u64_to_str_size_str_doc'> <h4>&sect;4.3.82: u64_to_str_size</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t u64_to_str_size(
 <div style='margin-left: 4mm;'>uint64_t x<br></div>)
 </div>
-</div><hr>
-<div id='u64_to_str_str_doc'> <h4>&sect;4.2.84: u64_to_str</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns the number of bytes required to represent x as a string.</div></div><hr>
+<div id='u64_to_str_str_doc'> <h4>&sect;4.3.83: u64_to_str</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool u64_to_str(
 <div style='margin-left: 4mm;'>String *dest,<br>uint64_t x<br></div>)
 </div>
-</div><hr>
-<div id='append_u64_to_str_str_doc'> <h4>&sect;4.2.85: append_u64_to_str</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call writes a string representation of x into dest. If there is enough
+space in dest this call returns non-zero.</div></div><hr>
+<div id='append_u64_to_str_str_doc'> <h4>&sect;4.3.84: append_u64_to_str</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool append_u64_to_str(
 <div style='margin-left: 4mm;'>String *dest,<br>uint64_t x<br></div>)
 </div>
-</div><hr>
-<div id='float_to_str_size_str_doc'> <h4>&sect;4.2.86: float_to_str_size</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call appends a string representation of x onto dest. If there is enough
+space in dest this call returns non-zero.</div></div><hr>
+<div id='float_to_str_size_str_doc'> <h4>&sect;4.3.85: float_to_str_size</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t float_to_str_size(
 <div style='margin-left: 4mm;'>float x<br></div>)
 </div>
-</div><hr>
-<div id='append_float_to_str_str_doc'> <h4>&sect;4.2.87: append_float_to_str</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns the number of bytes required to represent x as a string.</div></div><hr>
+<div id='append_float_to_str_str_doc'> <h4>&sect;4.3.86: append_float_to_str</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool append_float_to_str(
 <div style='margin-left: 4mm;'>String *dest,<br>float x<br></div>)
 </div>
-</div><hr>
-<div id='float_to_str_str_doc'> <h4>&sect;4.2.88: float_to_str</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call writes a string representation of x into dest. If there is enough
+space in dest this call returns non-zero.</div></div><hr>
+<div id='float_to_str_str_doc'> <h4>&sect;4.3.87: float_to_str</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool float_to_str(
 <div style='margin-left: 4mm;'>String *dest,<br>float x<br></div>)
 </div>
-</div><hr>
-<div id='str_to_int_str_doc'> <h4>&sect;4.2.89: str_to_int</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call appends a string representation of x onto dest. If there is enough
+space in dest this call returns non-zero.</div></div><hr>
+<div id='str_to_int_str_doc'> <h4>&sect;4.3.88: str_to_int</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t str_to_int(
 <div style='margin-left: 4mm;'>char *str<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.90: str_to_int</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>If str represents a valid string representation of an integer, this call will return
+the integer represented by the string.  Otherwise this call returns zero.</div></div><hr>
+<div> <h4>&sect;4.3.89: str_to_int</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t str_to_int(
 <div style='margin-left: 4mm;'>String str<br></div>)
 </div>
-</div><hr>
-<div id='hexchar_to_int_str_doc'> <h4>&sect;4.2.91: hexchar_to_int</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>If str represents a valid string representation of an integer, this call will return
+the integer represented by the string.  Otherwise this call returns zero.</div></div><hr>
+<div id='hexchar_to_int_str_doc'> <h4>&sect;4.3.90: hexchar_to_int</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t hexchar_to_int(
 <div style='margin-left: 4mm;'>char c<br></div>)
 </div>
-</div><hr>
-<div id='int_to_hexchar_str_doc'> <h4>&sect;4.2.92: int_to_hexchar</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>If c is a valid hexadecimal digit [0-9a-fA-F] this call returns the value of
+the integer value of the digit. Otherwise the return is some nonsense value.</div></div><hr>
+<div id='int_to_hexchar_str_doc'> <h4>&sect;4.3.91: int_to_hexchar</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 char int_to_hexchar(
 <div style='margin-left: 4mm;'>int32_t x<br></div>)
 </div>
-</div><hr>
-<div id='hexstr_to_int_str_doc'> <h4>&sect;4.2.93: hexstr_to_int</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>If x is in the range [0,15] this call returns the equivalent lowercase hexadecimal digit.
+Otherwise the return is some nonsense value.</div></div><hr>
+<div id='hexstr_to_int_str_doc'> <h4>&sect;4.3.92: hexstr_to_int</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 uint32_t hexstr_to_int(
 <div style='margin-left: 4mm;'>String str<br></div>)
 </div>
-</div><hr>
-<div id='color_to_hexstr_str_doc'> <h4>&sect;4.2.94: color_to_hexstr</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call interprets str has a hexadecimal representation of an integer and returns
+the represented integer value.</div></div><hr>
+<div id='color_to_hexstr_str_doc'> <h4>&sect;4.3.93: color_to_hexstr</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool color_to_hexstr(
 <div style='margin-left: 4mm;'>String *s,<br>uint32_t color<br></div>)
 </div>
-</div><hr>
-<div id='hexstr_to_color_str_doc'> <h4>&sect;4.2.95: hexstr_to_color</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call fills s with the hexadecimal representation of the color.
+If there is enough memory in s to represent the color this call returns non-zero.</div></div><hr>
+<div id='hexstr_to_color_str_doc'> <h4>&sect;4.3.94: hexstr_to_color</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool hexstr_to_color(
 <div style='margin-left: 4mm;'>String s,<br>uint32_t *out<br></div>)
 </div>
-</div><hr>
-<div id='reverse_seek_slash_str_doc'> <h4>&sect;4.2.96: reverse_seek_slash</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call interprets s as a color and writes the 32-bit integer representation into out.</div></div><hr>
+<div id='reverse_seek_slash_str_doc'> <h4>&sect;4.3.95: reverse_seek_slash</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t reverse_seek_slash(
 <div style='margin-left: 4mm;'>String str,<br>int32_t pos<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.97: reverse_seek_slash</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call searches for a slash in str by starting pos bytes from the end and going backwards.</div></div><hr>
+<div> <h4>&sect;4.3.96: reverse_seek_slash</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 int32_t reverse_seek_slash(
 <div style='margin-left: 4mm;'>String str<br></div>)
 </div>
-</div><hr>
-<div id='front_of_directory_str_doc'> <h4>&sect;4.2.98: front_of_directory</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call searches for a slash in str by starting at the end and going backwards.</div></div><hr>
+<div id='front_of_directory_str_doc'> <h4>&sect;4.3.97: front_of_directory</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 String front_of_directory(
 <div style='margin-left: 4mm;'>String dir<br></div>)
 </div>
-</div><hr>
-<div id='path_of_directory_str_doc'> <h4>&sect;4.2.99: path_of_directory</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns a substring of dir containing only the file name or
+folder name furthest to the right in the directory.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#substr_doc'>substr</a></div></div><hr>
+<div id='path_of_directory_str_doc'> <h4>&sect;4.3.98: path_of_directory</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 String path_of_directory(
 <div style='margin-left: 4mm;'>String dir<br></div>)
 </div>
-</div><hr>
-<div id='set_last_folder_str_doc'> <h4>&sect;4.2.100: set_last_folder</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns a substring of dir containing the whole path except
+for the final file or folder name.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#substr_doc'>substr</a></div></div><hr>
+<div id='set_last_folder_str_doc'> <h4>&sect;4.3.99: set_last_folder</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool set_last_folder(
 <div style='margin-left: 4mm;'>String *dir,<br>char *folder_name,<br>char slash<br></div>)
 </div>
-</div><hr>
-<div> <h4>&sect;4.2.101: set_last_folder</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>dir</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The dir parameter is the directory string in which to set the last folder in the directory.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>folder_name</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The folder_name parameter is a null terminated string specifying the name to set
+at the end of the directory.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>slash</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The slash parameter specifies what slash to use between names in the directory.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call deletes the last file name or folder name in the dir string and appends the new provided one.
+If there is enough memory in dir this call returns non-zero.</div></div><hr>
+<div> <h4>&sect;4.3.100: set_last_folder</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool set_last_folder(
 <div style='margin-left: 4mm;'>String *dir,<br>String folder_name,<br>char slash<br></div>)
 </div>
-</div><hr>
-<div id='file_extension_str_doc'> <h4>&sect;4.2.102: file_extension</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>dir</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The dir parameter is the directory string in which to set the last folder in the directory.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>folder_name</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The folder_name parameter is a string specifying the name to set at the end of the directory.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>slash</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The slash parameter specifies what slash to use between names in the directory.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call deletes the last file name or folder name in the dir string and appends the new provided one.
+If there is enough memory in dir this call returns non-zero.</div></div><hr>
+<div id='file_extension_str_doc'> <h4>&sect;4.3.101: file_extension</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 String file_extension(
 <div style='margin-left: 4mm;'>String str<br></div>)
 </div>
-</div><hr>
-<div id='remove_last_folder_str_doc'> <h4>&sect;4.2.103: remove_last_folder</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call returns a substring containing only the file extension of the provided filename.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#substr_doc'>substr</a></div></div><hr>
+<div id='remove_last_folder_str_doc'> <h4>&sect;4.3.102: remove_last_folder</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool remove_last_folder(
 <div style='margin-left: 4mm;'>String *str<br></div>)
 </div>
-</div><hr>
-<div id='string_set_match_str_doc'> <h4>&sect;4.2.104: string_set_match</h4>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call attemps to delete a folder or filename off the end of a path string.
+This call returns non-zero on success.</div></div><hr>
+<div id='string_set_match_str_doc'> <h4>&sect;4.3.103: string_set_match</h4>
  <div style='font-family: "Courier New", Courier, monospace; text-align: left; margin-top: 3mm; margin-bottom: 3mm; font-size: .95em; background: #DFDFDF; padding: 0.25em;'>
 fstr_bool string_set_match(
 <div style='margin-left: 4mm;'>String *str_set,<br>int32_t count,<br>String str,<br>int32_t *match_index<br></div>)
 </div>
-</div><hr>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Parameters</i></b></div><div>
+<div style='font-weight: 600;'>str_set</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The str_set parameter is an array of String structs specifying matchable strings.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>count</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The count parameter specifies the number of String structs in the str_set array.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>str</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>The str parameter specifies the string to match against the str_set.</div></div>
+</div>
+<div>
+<div style='font-weight: 600;'>match_index</div>
+<div style='margin-bottom: 6mm;'><div style='margin-left: 5mm; margin-right: 5mm;'>If this call succeeds match_index is filled with the index into str_set where the match occurred.</div></div>
+</div>
+<div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>Description</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'>This call tries to see if str matches any of the strings in str_set.  If there is a match the call
+succeeds and returns non-zero.  The matching rule is equivalent to the matching rule for match.</div><div style='margin-top: 3mm; margin-bottom: 3mm; color: #309030;'><b><i>See Also</i></b></div><div style='margin-left: 5mm; margin-right: 5mm;'><a href='#match_doc'>match</a></div></div><hr>
 </div>
 </body>
 </html>
diff --git a/4coder_default_building.cpp b/4coder_default_building.cpp
index 481b3b42..9778a1d8 100644
--- a/4coder_default_building.cpp
+++ b/4coder_default_building.cpp
@@ -283,9 +283,18 @@ parse_error(String line, Jump_Location *location,
     
     else{
         int colon_pos1 = find(line, 0, ':');
+        if (colon_pos1 == 1){
+            if (line.size > colon_pos1+1){
+                if (char_is_slash(line.str[colon_pos1+1])){
+                    colon_pos1 = find(line, colon_pos1+1, ':');
+                }
+            }
+        }
+        
         int colon_pos2 = find(line, colon_pos1+1, ':');
         int colon_pos3 = find(line, colon_pos2+1, ':');
         
+        
         if (gcc_style_verify(line, colon_pos3)){
             String filename = substr(line, 0, colon_pos1);
             String line_number = substr(line, colon_pos1+1, colon_pos2 - colon_pos1 - 1);
diff --git a/4coder_search.cpp b/4coder_search.cpp
index 4e411bd8..e6b4cf5f 100644
--- a/4coder_search.cpp
+++ b/4coder_search.cpp
@@ -207,12 +207,23 @@ match_check(Application_Links *app, Search_Range *range, int *pos, Search_Match
         }
     }
     else{
-        char prev = buffer_get_char(app, &result.buffer, result.start - 1);
+        char first = word.str[0];
+        
+        char prev = ' ';
+        if (char_is_alpha_numeric(first)){
+            prev = buffer_get_char(app, &result.buffer, result.start - 1);
+        }
         
         if (!char_is_alpha_numeric(prev)){
             result.end = result.start + word.size;
             if (result.end <= end_pos){
-                char next = buffer_get_char(app, &result.buffer, result.end);
+                char last = word.str[word.size-1];
+                
+                char next = ' ';
+                if (char_is_alpha_numeric(last)){
+                    next = buffer_get_char(app, &result.buffer, result.end);
+                }
+                
                 if (!char_is_alpha_numeric(next)){
                     result.found_match = true;
                     found_match = FindResult_FoundMatch;
diff --git a/4coder_string.h b/4coder_string.h
index 8ad99e5a..21c8ad42 100644
--- a/4coder_string.h
+++ b/4coder_string.h
@@ -40,17 +40,16 @@ struct Offset_String{
 #ifndef FCODER_STRING_H
 #define FCODER_STRING_H
 
-FSTRING_INLINE  fstr_bool     char_not_slash(char c);
 FSTRING_INLINE  fstr_bool     char_is_slash(char c);
 FSTRING_INLINE  char          char_to_upper(char c);
 FSTRING_INLINE  char          char_to_lower(char c);
 FSTRING_INLINE  fstr_bool     char_is_whitespace(char c);
 FSTRING_INLINE  fstr_bool     char_is_alpha_numeric(char c);
-FSTRING_INLINE  fstr_bool     char_is_hex(char c);
-FSTRING_INLINE  fstr_bool     char_is_numeric(char c);
+FSTRING_INLINE  fstr_bool     char_is_alpha_numeric_true(char c);
 FSTRING_INLINE  fstr_bool     char_is_alpha(char c);
 FSTRING_INLINE  fstr_bool     char_is_alpha_true(char c);
-FSTRING_INLINE  fstr_bool     char_is_alpha_numeric_true(char c);
+FSTRING_INLINE  fstr_bool     char_is_hex(char c);
+FSTRING_INLINE  fstr_bool     char_is_numeric(char c);
 FSTRING_INLINE  String        string_zero();
 FSTRING_INLINE  String        make_string(void *str, int32_t size, int32_t mem_size);
 FSTRING_INLINE  String        make_string(void *str, int32_t size);
@@ -67,10 +66,10 @@ FSTRING_LINK    int32_t       str_size(char *str);
 FSTRING_INLINE  String        make_string_slowly(void *str);
 FSTRING_INLINE  String        substr(String str, int32_t start);
 FSTRING_INLINE  String        substr(String str, int32_t start, int32_t size);
-FSTRING_INLINE  String        tailstr(String str);
 FSTRING_LINK    String        skip_whitespace(String str);
 FSTRING_LINK    String        chop_whitespace(String str);
 FSTRING_LINK    String        skip_chop_whitespace(String str);
+FSTRING_INLINE  String        tailstr(String str);
 FSTRING_LINK    fstr_bool     match(char *a, char *b);
 FSTRING_LINK    fstr_bool     match(String a, char *b);
 FSTRING_INLINE  fstr_bool     match(char *a, String b);
@@ -109,7 +108,7 @@ FSTRING_INLINE  fstr_bool     has_substr(String s, String seek);
 FSTRING_INLINE  fstr_bool     has_substr_insensitive(char *s, String seek);
 FSTRING_INLINE  fstr_bool     has_substr_insensitive(String s, String seek);
 FSTRING_LINK    int32_t       copy_fast_unsafe(char *dest, char *src);
-FSTRING_LINK    void          copy_fast_unsafe(char *dest, String src);
+FSTRING_LINK    int32_t       copy_fast_unsafe(char *dest, String src);
 FSTRING_LINK    fstr_bool     copy_checked(String *dest, String src);
 FSTRING_LINK    fstr_bool     copy_partial(String *dest, char *src);
 FSTRING_LINK    fstr_bool     copy_partial(String *dest, String src);
@@ -160,78 +159,81 @@ FSTRING_LINK    fstr_bool     string_set_match(String *str_set, int32_t count, S
 
 #ifndef FSTRING_GUARD
 FSTRING_INLINE fstr_bool
-char_not_slash(char c){
-    return (c != '\\' && c != '/');
-}
-#endif
-
-#ifndef FSTRING_GUARD
-FSTRING_INLINE fstr_bool
-char_is_slash(char c){
+char_is_slash(char c)
+{
     return (c == '\\' || c == '/');
 }
 #endif
 
 #ifndef FSTRING_GUARD
 FSTRING_INLINE char
-char_to_upper(char c){
+char_to_upper(char c)
+{
     return (c >= 'a' && c <= 'z') ? c + (char)('A' - 'a') : c;
 }
 #endif
 
 #ifndef FSTRING_GUARD
 FSTRING_INLINE char
-char_to_lower(char c){
+char_to_lower(char c)
+{
     return (c >= 'A' && c <= 'Z') ? c - (char)('A' - 'a') : c;
 }
 #endif
 
 #ifndef FSTRING_GUARD
 FSTRING_INLINE fstr_bool
-char_is_whitespace(char c){
+char_is_whitespace(char c)
+{
     return (c == ' ' || c == '\n' || c == '\r' || c == '\t');
 }
 #endif
 
 #ifndef FSTRING_GUARD
 FSTRING_INLINE fstr_bool
-char_is_alpha_numeric(char c){
+char_is_alpha_numeric(char c)
+{
     return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z' || c >= '0' && c <= '9' || c == '_');
 }
 #endif
 
 #ifndef FSTRING_GUARD
 FSTRING_INLINE fstr_bool
-char_is_hex(char c){
-    return c >= '0' && c <= '9' || c >= 'A' && c <= 'F' || c >= 'a' && c <= 'f';
+char_is_alpha_numeric_true(char c)
+{
+    return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z' || c >= '0' && c <= '9');
 }
 #endif
 
 #ifndef FSTRING_GUARD
 FSTRING_INLINE fstr_bool
-char_is_numeric(char c){
-    return (c >= '0' && c <= '9');
-}
-#endif
-
-#ifndef FSTRING_GUARD
-FSTRING_INLINE fstr_bool
-char_is_alpha(char c){
+char_is_alpha(char c)
+{
     return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z' || c == '_');
 }
 #endif
 
 #ifndef FSTRING_GUARD
 FSTRING_INLINE fstr_bool
-char_is_alpha_true(char c){
+char_is_alpha_true(char c)
+{
     return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z');
 }
 #endif
 
 #ifndef FSTRING_GUARD
 FSTRING_INLINE fstr_bool
-char_is_alpha_numeric_true(char c){
-    return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z' || c >= '0' && c <= '9');
+char_is_hex(char c)
+{
+    return c >= '0' && c <= '9' || c >= 'A' && c <= 'F' || c >= 'a' && c <= 'f';
+}
+#endif
+
+#ifndef FSTRING_GUARD
+FSTRING_INLINE fstr_bool
+char_is_numeric(char c)
+{
+    return (c >= '0' && c <= '9');
 }
 #endif
 
@@ -242,7 +244,8 @@ char_is_alpha_numeric_true(char c){
 
 #ifndef FSTRING_GUARD
 FSTRING_INLINE String
-string_zero(){
+string_zero()
+{
     String str={0};
     return(str);
 }
@@ -250,7 +253,8 @@ string_zero(){
 
 #ifndef FSTRING_GUARD
 FSTRING_INLINE String
-make_string(void *str, int32_t size, int32_t mem_size){
+make_string(void *str, int32_t size, int32_t mem_size)
+{
     String result;
     result.str = (char*)str;
     result.size = size;
@@ -272,7 +276,8 @@ make_string(void *str, int32_t size){
 
 #ifdef FSTRING_IMPLEMENTATION
 FSTRING_LINK int32_t
-str_size(char *str){
+str_size(char *str)
+{
     int32_t i = 0;
     while (str[i]) ++i;
     return i;
@@ -281,7 +286,8 @@ str_size(char *str){
 
 #ifndef FSTRING_GUARD
 FSTRING_INLINE String
-make_string_slowly(void *str){
+make_string_slowly(void *str)
+{
     String result;
     result.str = (char*)str;
     result.size = str_size((char*)str);
@@ -292,11 +298,12 @@ make_string_slowly(void *str){
 
 // TODO(allen): I don't love the substr rule, I chose
 // substr(String, start) and substr(String, start, size)
-// but I wish I had substr(String, end) and substr(String, start, end)
+// but I wish I had substr(String, start) and substr(String, start, end)
 
 #ifndef FSTRING_GUARD
 FSTRING_INLINE String
-substr(String str, int32_t start){
+substr(String str, int32_t start)
+{
     String result;
     result.str = str.str + start;
     result.size = str.size - start;
@@ -307,7 +314,8 @@ substr(String str, int32_t start){
 
 #ifndef FSTRING_GUARD
 FSTRING_INLINE String
-substr(String str, int32_t start, int32_t size){
+substr(String str, int32_t start, int32_t size)
+{
     String result;
     result.str = str.str + start;
     result.size = size;
@@ -319,20 +327,10 @@ substr(String str, int32_t start, int32_t size){
 }
 #endif
 
-#ifndef FSTRING_GUARD
-FSTRING_INLINE String
-tailstr(String str){
-    String result;
-    result.str = str.str + str.size;
-    result.memory_size = str.memory_size - str.size;
-    result.size = 0;
-    return(result);
-}
-#endif
-
 #ifdef FSTRING_IMPLEMENTATION
 FSTRING_LINK String
-skip_whitespace(String str){
+skip_whitespace(String str)
+{
     String result = {0};
     int i = 0;
     for (; i < str.size && char_is_whitespace(str.str[i]); ++i);
@@ -343,7 +341,8 @@ skip_whitespace(String str){
 
 #ifdef FSTRING_IMPLEMENTATION
 FSTRING_LINK String
-chop_whitespace(String str){
+chop_whitespace(String str)
+{
     String result = {0};
     int i = str.size;
     for (; i > 0 && char_is_whitespace(str.str[i-1]); --i);
@@ -354,13 +353,26 @@ chop_whitespace(String str){
 
 #ifdef FSTRING_IMPLEMENTATION
 FSTRING_LINK String
-skip_chop_whitespace(String str){
+skip_chop_whitespace(String str)
+{
     str = skip_whitespace(str);
     str = chop_whitespace(str);
     return(str);
 }
 #endif
 
+#ifndef FSTRING_GUARD
+FSTRING_INLINE String
+tailstr(String str)
+{
+    String result;
+    result.str = str.str + str.size;
+    result.memory_size = str.memory_size - str.size;
+    result.size = 0;
+    return(result);
+}
+#endif
+
 
 //
 // String Comparison
@@ -914,18 +926,19 @@ copy_fast_unsafe(char *dest, char *src){
         ++dest;
         ++src;
     }
-    return (int)(dest - start);
+    return (int32_t)(dest - start);
 }
 #endif
 
 #ifdef FSTRING_IMPLEMENTATION
-FSTRING_LINK void
+FSTRING_LINK int32_t
 copy_fast_unsafe(char *dest, String src){
     int32_t i = 0;
     while (i != src.size){
         dest[i] = src.str[i];
         ++i;
     }
+    return(src.size);
 }
 #endif
 
@@ -967,23 +980,17 @@ copy_partial(String *dest, char *src){
 #ifdef FSTRING_IMPLEMENTATION
 FSTRING_LINK fstr_bool
 copy_partial(String *dest, String src){
-    fstr_bool result;
-    int32_t memory_size = dest->memory_size;
     char *dest_str = dest->str;
-    if (memory_size < src.size){
-        result = 0;
-        for (int32_t i = 0; i < memory_size; ++i){
-            dest_str[i] = src.str[i];
-        }
-        dest->size = memory_size;
+    int32_t memory_size = dest->memory_size;
+    fstr_bool result = false;
+    if (memory_size >= src.size){
+        result = true;
+        memory_size = src.size;
     }
-    else{
-        result = 1;
-        for (int32_t i = 0; i < src.size; ++i){
-            dest_str[i] = src.str[i];
-        }
-        dest->size = src.size;
+    for (int32_t i = 0; i < memory_size; ++i){
+        dest_str[i] = src.str[i];
     }
+    dest->size = memory_size;
     return result;
 }
 #endif
@@ -1069,7 +1076,8 @@ append(String *dest, char *src){
 #endif
 
 #ifdef FSTRING_IMPLEMENTATION
-FSTRING_LINK fstr_bool terminate_with_null(String *str){
+FSTRING_LINK fstr_bool
+terminate_with_null(String *str){
     fstr_bool result = 0;
     if (str->size < str->memory_size){
         str->str[str->size] = 0;
@@ -1084,7 +1092,7 @@ FSTRING_LINK fstr_bool
 append_padding(String *dest, char c, int32_t target_size){
     fstr_bool result = 1;
     int32_t offset = target_size - dest->size;
-    int32_t r;
+    int32_t r = 0;
     if (offset > 0){
         for (r = 0; r < offset; ++r){
             if (append(dest, c) == 0){
@@ -1106,8 +1114,7 @@ append_padding(String *dest, char c, int32_t target_size){
 FSTRING_LINK void
 replace_char(String *str, char replace, char with){
     char *s = str->str;
-    int32_t i;
-    
+    int32_t i = 0;
     for (i = 0; i < str->size; ++i, ++s){
         if (*s == replace) *s = with;
     }
@@ -1364,7 +1371,7 @@ str_to_int(String str){
 #ifdef FSTRING_IMPLEMENTATION
 FSTRING_LINK int32_t
 hexchar_to_int(char c){
-    int32_t x;
+    int32_t x = 0;
     if (c >= '0' && c <= '9'){
         x = c-'0';
     }
@@ -1461,7 +1468,7 @@ hexstr_to_color(String s, uint32_t *out){
 FSTRING_LINK int32_t
 reverse_seek_slash(String str, int32_t pos){
     int32_t i = str.size - 1 - pos;
-    while (i >= 0 && char_not_slash(str.str[i])){
+    while (i >= 0 && !char_is_slash(str.str[i])){
         --i;
     }
     return i;
diff --git a/4ed_metagen.cpp b/4ed_metagen.cpp
index 2d406407..184f544a 100644
--- a/4ed_metagen.cpp
+++ b/4ed_metagen.cpp
@@ -1508,58 +1508,62 @@ do_macro_parse(int *index, Cpp_Token **token_ptr, int count,
     if (i > 0){
         Cpp_Token *doc_token = token-1;
         
-        macro_set.doc_string[sig_count] = make_string(file.data + doc_token->start, doc_token->size);
+        String doc_string = make_string(file.data + doc_token->start, doc_token->size);
         
-        for (; i < count; ++i, ++token){
-            if (token->type == CPP_TOKEN_IDENTIFIER){
-                break;
-            }
-        }
-        
-        if (i < count && (token->flags & CPP_TFLAG_PP_BODY)){
-            macro_set.name[sig_count] = make_string(file.data + token->start, token->size);
+        if (check_and_fix_docs(&doc_string)){
+            macro_set.doc_string[sig_count] = doc_string;
             
-            ++i, ++token;
-            if (i < count){
-                Cpp_Token *args_start_token = token;
-                for (; i < count; ++i, ++token){
-                    if (token->type == CPP_TOKEN_PARENTHESE_CLOSE){
-                        break;
-                    }
+            for (; i < count; ++i, ++token){
+                if (token->type == CPP_TOKEN_IDENTIFIER){
+                    break;
                 }
+            }
+            
+            if (i < count && (token->flags & CPP_TFLAG_PP_BODY)){
+                macro_set.name[sig_count] = make_string(file.data + token->start, token->size);
                 
+                ++i, ++token;
                 if (i < count){
-                    int start = args_start_token->start;
-                    int end = token->start + token->size;
-                    macro_set.args[sig_count] = make_string(file.data + start, end - start);
-                    
-                    Argument_Breakdown *breakdown = &macro_set.breakdown[sig_count];
-                    *breakdown = do_parameter_parse(file, args_start_token, token);
-                    
-                    ++i, ++token;
-                    if (i < count){
-                        Cpp_Token *body_start = token;
-                        
-                        if (body_start->flags & CPP_TFLAG_PP_BODY){
-                            for (; i < count; ++i, ++token){
-                                if (!(token->flags & CPP_TFLAG_PP_BODY)){
-                                    break;
-                                }
-                            }
-                            
-                            --i, --token;
-                            
-                            Cpp_Token *body_end = token;
-                            
-                            start = body_start->start;
-                            end = body_end->start + body_end->size;
-                            macro_set.body[sig_count] = make_string(file.data + start, end - start);
+                    Cpp_Token *args_start_token = token;
+                    for (; i < count; ++i, ++token){
+                        if (token->type == CPP_TOKEN_PARENTHESE_CLOSE){
+                            break;
                         }
                     }
                     
-                    macro_set.is_macro[sig_count] = true;
-                    macro_set.valid[sig_count] = true;
-                    result = true;
+                    if (i < count){
+                        int start = args_start_token->start;
+                        int end = token->start + token->size;
+                        macro_set.args[sig_count] = make_string(file.data + start, end - start);
+                        
+                        Argument_Breakdown *breakdown = &macro_set.breakdown[sig_count];
+                        *breakdown = do_parameter_parse(file, args_start_token, token);
+                        
+                        ++i, ++token;
+                        if (i < count){
+                            Cpp_Token *body_start = token;
+                            
+                            if (body_start->flags & CPP_TFLAG_PP_BODY){
+                                for (; i < count; ++i, ++token){
+                                    if (!(token->flags & CPP_TFLAG_PP_BODY)){
+                                        break;
+                                    }
+                                }
+                                
+                                --i, --token;
+                                
+                                Cpp_Token *body_end = token;
+                                
+                                start = body_start->start;
+                                end = body_end->start + body_end->size;
+                                macro_set.body[sig_count] = make_string(file.data + start, end - start);
+                            }
+                        }
+                        
+                        macro_set.is_macro[sig_count] = true;
+                        macro_set.valid[sig_count] = true;
+                        result = true;
+                    }
                 }
             }
         }
@@ -1662,6 +1666,61 @@ print_function_body_code(FILE *file, int *index, Cpp_Token **token_ptr, int coun
     *token_ptr = token;
 }
 
+static void
+print_function_docs(FILE *file, Partition *part, String name, String doc_string){
+    if (doc_string.size == 0){
+        fprintf(file, "No documentation generated for this function, assume it is non-public.\n");
+        fprintf(stderr, "warning: no documentation string for %.*s\n", name.size, name.str);
+    }
+    
+    Documentation doc_ = {0};
+    Documentation *doc = &doc_;
+    
+    perform_doc_parse(part, doc_string, doc);
+    
+    int doc_param_count = doc->param_count;
+    if (doc_param_count > 0){
+        fprintf(file, DOC_HEAD_OPEN"Parameters"DOC_HEAD_CLOSE);
+        
+        for (int j = 0; j < doc_param_count; ++j){
+            String param_name = doc->param_name[j];
+            String param_docs = doc->param_docs[j];
+            
+            // TODO(allen): check that param_name is actually
+            // a parameter to this function!
+            
+            fprintf(file,
+                    "<div>\n"
+                    DOC_ITEM_HEAD_OPEN"%.*s"DOC_ITEM_HEAD_CLOSE"\n"
+                    "<div style='margin-bottom: 6mm;'>"DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE"</div>\n"
+                    "</div>\n",
+                    param_name.size, param_name.str,
+                    param_docs.size, param_docs.str
+                    );
+        }
+    }
+    
+    String ret_doc = doc->return_doc;
+    if (ret_doc.size != 0){
+        fprintf(file, DOC_HEAD_OPEN"Return"DOC_HEAD_CLOSE);
+        fprintf(file,
+                DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE,
+                ret_doc.size, ret_doc.str
+                );
+    }
+    
+    String main_doc = doc->main_doc;
+    if (main_doc.size != 0){
+        fprintf(file, DOC_HEAD_OPEN"Description"DOC_HEAD_CLOSE);
+        fprintf(file,
+                DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE,
+                main_doc.size, main_doc.str
+                );
+    }
+    
+    print_see_also(file, doc);
+}
+
 char*
 generate_custom_headers(){
 #define API_H "4coder_custom_api.h"
@@ -2407,6 +2466,7 @@ generate_custom_headers(){
                 "<h2 id='section_%s'>&sect;"MAJOR_SECTION" %s</h2>\n",
                 sections[1].id_string,
                 sections[1].display_string);
+        
         {
             fprintf(file,
                 "<div><i>\n"
@@ -2504,8 +2564,8 @@ generate_custom_headers(){
                 
                 fprintf(file,
                         "<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n"
-                        " <h4>&sect;"SECTION".%d: %.*s</h4>\n"
-                        " <div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
+                        "<h4>&sect;"SECTION".%d: %.*s</h4>\n"
+                        "<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
                         name.size, name.str, i+1,
                         name.size, name.str
                         );
@@ -2513,55 +2573,7 @@ generate_custom_headers(){
                 fprintf(file, "</div>\n");
                 
                 String doc_string = function_set.doc_string[i];
-                if (doc_string.size == 0){
-                    fprintf(file, "No documentation generated for this function, assume it is non-public.\n");
-                    fprintf(stderr, "warning: no documentation string for %.*s\n", name.size, name.str);
-                }
-                
-                Documentation *doc = &function_set.doc[i];
-                perform_doc_parse(part, doc_string, doc);
-                
-                int doc_param_count = doc->param_count;
-                if (doc_param_count > 0){
-                    fprintf(file, DOC_HEAD_OPEN"Parameters"DOC_HEAD_CLOSE);
-                    
-                    for (int j = 0; j < doc_param_count; ++j){
-                        String param_name = doc->param_name[j];
-                        String param_docs = doc->param_docs[j];
-                        
-                        // TODO(allen): check that param_name is actually
-                        // a parameter to this function!
-                        
-                        fprintf(file,
-                                "<div>\n"
-                                DOC_ITEM_HEAD_OPEN"%.*s"DOC_ITEM_HEAD_CLOSE"\n"
-                                "<div style='margin-bottom: 6mm;'>"DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE"</div>\n"
-                                "</div>\n",
-                                param_name.size, param_name.str,
-                                param_docs.size, param_docs.str
-                                );
-                    }
-                }
-                
-                String ret_doc = doc->return_doc;
-                if (ret_doc.size != 0){
-                    fprintf(file, DOC_HEAD_OPEN"Return"DOC_HEAD_CLOSE);
-                    fprintf(file,
-                            DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE,
-                            ret_doc.size, ret_doc.str
-                            );
-                }
-                
-                String main_doc = doc->main_doc;
-                if (main_doc.size != 0){
-                    fprintf(file, DOC_HEAD_OPEN"Description"DOC_HEAD_CLOSE);
-                    fprintf(file,
-                            DOC_ITEM_OPEN"%.*s"DOC_ITEM_CLOSE,
-                            main_doc.size, main_doc.str
-                            );
-                }
-                
-                print_see_also(file, doc);
+                print_function_docs(file, part, name, doc_string);
                 
                 fprintf(file, "</div><hr>\n");
             }
@@ -2577,8 +2589,8 @@ generate_custom_headers(){
                 
                 fprintf(file,
                         "<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n"
-                        " <h4>&sect;"SECTION".%d: %.*s</h4>\n"
-                        " <div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
+                        "<h4>&sect;"SECTION".%d: %.*s</h4>\n"
+                        "<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
                         name.size, name.str, I,
                         name.size, name.str
                         );
@@ -2620,8 +2632,8 @@ generate_custom_headers(){
                 
                 fprintf(file,
                         "<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n"
-                        " <h4>&sect;"SECTION".%d: %.*s</h4>\n"
-                        " <div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
+                        "<h4>&sect;"SECTION".%d: %.*s</h4>\n"
+                        "<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
                         name.size, name.str, I,
                         name.size, name.str
                         );
@@ -2681,8 +2693,8 @@ generate_custom_headers(){
                 
                 fprintf(file,
                         "<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n"
-                        " <h4>&sect;"SECTION".%d: %.*s</h4>\n"
-                        " <div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
+                        "<h4>&sect;"SECTION".%d: %.*s</h4>\n"
+                        "<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
                         name.size, name.str, I,
                         name.size, name.str
                         );
@@ -2743,8 +2755,8 @@ generate_custom_headers(){
                 String name = member->name;
                 fprintf(file,
                         "<div id='%.*s_doc' style='margin-bottom: 1cm;'>\n"
-                        " <h4>&sect;"SECTION".%d: %.*s</h4>\n"
-                        " <div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
+                        "<h4>&sect;"SECTION".%d: %.*s</h4>\n"
+                        "<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>",
                         name.size, name.str, I,
                         name.size, name.str
                         );
@@ -2796,6 +2808,20 @@ generate_custom_headers(){
 #undef SECTION
 #define SECTION MAJOR_SECTION".1"
             
+            fprintf(file,
+                    "<h3>&sect;"SECTION" String Intro</h3>\n"
+                    "<ul>\n");
+            
+            {
+                fprintf(file,
+                        "<div><i>\n"
+                        "Coming Soon"
+                        "</i><div>\n");
+            }
+            
+#undef SECTION
+#define SECTION MAJOR_SECTION".2"
+            
             fprintf(file,
                     "<h3>&sect;"SECTION" String Function List</h3>\n"
                     "<ul>\n");
@@ -2828,7 +2854,7 @@ generate_custom_headers(){
             used_string_count = 0;
             
 #undef SECTION
-#define SECTION MAJOR_SECTION".2"
+#define SECTION MAJOR_SECTION".3"
             
             fprintf(file,
                     "<h3>&sect;"SECTION" String Function Descriptions</h3>\n"
@@ -2854,8 +2880,8 @@ generate_custom_headers(){
                 }
                 
                 fprintf(file,
-                        " <h4>&sect;"SECTION".%d: %.*s</h4>\n"
-                        " <div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>\n",
+                        "<h4>&sect;"SECTION".%d: %.*s</h4>\n"
+                        "<div style='"CODE_STYLE" "DESCRIPT_SECTION_STYLE"'>\n",
                         i+1, name.size, name.str);
                 
                 if (string_function_set.is_macro[i]){
@@ -2867,6 +2893,10 @@ generate_custom_headers(){
                 
                 fprintf(file, "</div>\n");
                 
+                
+                String doc_string = string_function_set.doc_string[i];
+                print_function_docs(file, part, name, doc_string);
+                
                 fprintf(file, "</div><hr>\n");
             }
         }
diff --git a/README.txt b/README.txt
index 6e3cf219..9168ed98 100644
--- a/README.txt
+++ b/README.txt
@@ -1,4 +1,4 @@
-Distribution Date: 11.7.2016 (dd.mm.yyyy)
+Distribution Date: 12.7.2016 (dd.mm.yyyy)
 
 Thank you for contributing to the 4coder project!
 
@@ -27,63 +27,6 @@ if you start digging and pressing hard enough.
 INSTRUCTIONS FOR USE
 -----------------------------------------------------
 
-****Changes in 4.0.7****
-Right clicking in a buffer now sets the mark.
-
-alt + d: brings up the debug view from which there are several options:
- i - input
- m - memory and threads
- v - views
-more debug features coming in the future.  This is mostly here so that
-I can help everyone gather better data for bug reports and get them
-fixed more easily.
-
-****Changes in 4.0.5****
-Improved indentation rule
-
-****Changes in 4.0.3****
-4coder now uses 0% CPU when you are not using it.
-
-There is a scrollbar on files now.  (It is not the nicest scrollbar to use in the world,
-but the real purpose it serves is to indicate where in a file you are.  I imagine most
-scrolling will still happen with the wheel or cursor navigation.)
-
-File lists are now arrow navigatable and scrollable... these two systems do no work
-together very well yet.
-
-Color adjusting is possible again, but the UI is heavily downgraded from the fancieness
-of the old system.
-
-While editing:
-alt + Z: execute command line with the same output buffer and same command
-   as in the previous use of "alt + z".
-
-****Changes in 4.0.2****
-The previous file limit of 128 has been raised to something over 8 million.
-
-A *messages* buffer is now opened on launch to provide some information about
- new features and messages will be posted there to report events sometimes.
-
-subst and link directories no longer confuse the system, it treats them as one file.
-
-on the command line: -f <N> sets the font size, the default is 16
-
-ctrl + e: centers the view on the cursor
-
-****Changes in 4.0.0****
-alt + x: changed to arbitrary command (NOW WORKS ANYWHERE!)
-Opens a command prompt from which you can execute:
-   "open menu" to open the menu (old behavior of alt+x)
-   "open all code" loads all cpp and h files in current directory
-   "close all code" closes all cpp and h files currently open
-   "open in quotes" opens the file who's name under the cursor is surrounded by quotes
-   "dos lines" dosify the file end of iles
-   "nix lines" nixify the file end of iles
-
-alt + z: execute arbitrary command-line command
-Specify an output buffer and a command to execute
-and the results will be dropped into the specified buffer.
-
 ****Command line options****
 4ed [<files-to-open>] [options]
 
@@ -101,12 +44,13 @@ and the results will be dropped into the specified buffer.
 -T -- invoke special tool isntead of launching 4coder normally
    -T version : prints the 4coder version string
 
-****Old Information****
+****Command Bindings****
 Basic Navigation:
-mouse click - move cursor
+mouse left click - move cursor
+mouse right click - set mark
 arrows - move cursor
 home & end - move cursor to beginning/end of line
-page up & page down - page up & page down respectively
+page up & page down - move up/down by close to the height of the entire screen
 control + left/right - move cursor left/right to first whitespace
 control + up/down - move cursor up or down to first blank line
 
@@ -114,13 +58,21 @@ Fancy Navigation:
 control + f : begin find mode, uses interaction bar
 control + r : begin reverse-find mode, uses interaction bar
 
+control + F : list all locations of a word in all open buffers, uses interaction bar
+    > This command creates a *search* buffer that displays the locations and the line of each
+    > occurence of the requested word.  By positioning the cursor and pressing return the user
+    > jump to the word's occurence.
+
 While in find mode or reverse-find mode, pressing enter ends the mode
 leaving the cursor wherever the find highlighter is, and pressing escape
 ends the mode leaving the cursor wherever it was before the find mode began.
 
-control + g - goto line number
+control + g - goto line number, uses interaction bar
 control + m - swap cursor and mark
 
+control + e - center the view vertically on the cursor
+control + E - in a view with unwrapped lines move the view to a position just left of the cursor
+
 Basic Editing:
 characters keys, delete, and backspace
 control + c : copy between cursor and mark
@@ -129,29 +81,32 @@ control + v : paste at cursor
 control + V : use after normal paste to cycle through older copied text
 control + d : delete between cursor and mark
 control + SPACE : set mark to cursor
+control + backspace : backspace one word
+control + delete : delete one word
+alt + backspace : snipe one word
 
 Undo and History:
 control + z : undo
 control + y : redo
-control + Z: undo / history timelines
 control + h: history back step
 control + H: history forward step
-alt + left: increase rewind speed (through undo)
-alt + right: increase fastforward speed (through redo)
-alt + down: stop redining / fastforwarding
 
 Fancy Editing:
 control + u : to uppercase between cursor and mark
 control + j : to lowercase between cursor and mark
-control + q: query replace
-control + a: replace in range
-control + =: write increment
-control + -: decrement increment
-control + [: write {} pair with cursor in line between
-control + {: as <control + [> with a semicolon after "}"
-control + }: as <control + [> with a "break;" after "}"
-control + 9: wrap the range specified by mark and cursor in parens
-control + i: wrap the range specified by mark and cursor in #if 0 #endif
+control + q : query replace
+control + a : replace in range
+control + ~ : clean the trailing whitespace off of all lines
+
+Fancy Editing in Code Files:
+control + [ : write "{}" pair with cursor in line between
+control + { : as control + [ with a semicolon after "}"
+control + } : as control + [ with a "break;" after "}"
+control + 0 : write "= {0};" at the cursor
+control + i : wrap the range specified by mark and cursor in #if 0 #endif
+
+alt + 1 : if cursor is inside a string, treat the string as a filename and
+    > try to open the file with that name in the other panel
 
 Whitespace Boringness:
 Typing characters: },],),; and inserting newlines cause the line to autotab
@@ -163,25 +118,42 @@ control + ! : set the flie to nix mode for writing to disk
 
 Viewing Options:
 alt + c - open theme selection UI
+alt + d - open debug view
+
 control + p : vertically split the current panel (max 16)
-control + '-' : horizontally split the current panel (max 16)
+control + _ : horizontally split the current panel (max 16)
 control + P : close the currently selected panel
 control + , : switch to another panel
+
 control + l : toggle line wrapping
-control + L : toggle end of line mode
-	mode 1: treat all \r\n and all \n as newline, show \r when not followed by \n
-	mode 2: treat all \r and \n as newline
-	mode 3: treat all \n as newline, show all \r
 control + ? : toggle highlight whitespace mode
 
-Tools:
-alt + m : search in the current hot directory and up through all parent
+f2 : toggle mouse suppresion mode
+
+alt + s : show the scrollbar in this view
+alt + w : hide the scrollbar in this view
+
+Build Tools:
+alt + m :
+[On Windows] search in the current hot directory and up through all parent
     > directories for a build.bat, and execute that bat if it discovered, sending
     > output to the buffer *compilation*
+[On Linux] The behavior is similar but the search looks for build.sh and if that
+    > fails it looks for a Makefile
+
+alt + . : change to the build panel
+alt + , : close the build panel
+alt + n : goto the next error listed in the build panel
+alt + N : goto the previous error listed in the build panel
+alt + M : goto the first error listed in the build panel
+
+alt + z : execute any command line command you specify and send the output to the buffer you specify
+alt + Z : repeat the command previously executed by the alt + z command
 
 File Managing:
 control + n : create a new file, begins interactive input mode
 control + o : open file, begins interactive input mode
+alt + o : open file in other panel, same as control + o but runs first changes the active view
 control + O : reopen the current file
 	(discarding any differences the live version has from the file system's version)
 control + s : save
@@ -190,10 +162,10 @@ control + i : switch active file in this panel, begins interactive input mode
 control + k : kill (close) a file, begins interactive input mode
 control + K : kill (close) the file being viewed in the currently active panel
 
-While in interactive input mode, pressing enter confirms the input for the command, and
-pressing escape (once) will end the input mode and abort the command.  If the file does
-not exist either the nearest match will be opened, or no file will be opened if none is
-considered a match.  Use backspace to go back through directories.
+While in interactive input mode, there are several ways to select an option.
+The options can be clicked.  One option is always highlighted and pressing
+return or tab will select the highlighted option.  Arrow keys navigate the
+highlighted option.  Typing in characters narrows down the list of options.
 
 Menu UI
 Keyboard options:
diff --git a/internal_4coder_string.cpp b/internal_4coder_string.cpp
index 1cc19a6f..ff8c319b 100644
--- a/internal_4coder_string.cpp
+++ b/internal_4coder_string.cpp
@@ -49,58 +49,63 @@ FSTRING_DECLS
 //
 
 FSTRING_INLINE fstr_bool
-char_not_slash(char c)/* DOC() */{
-    return (c != '\\' && c != '/');
-}
-
-FSTRING_INLINE fstr_bool
-char_is_slash(char c)/* DOC() */{
+char_is_slash(char c)
+/* DOC(This call returns non-zero if c is \ or /.) */{
     return (c == '\\' || c == '/');
 }
 
 FSTRING_INLINE char
-char_to_upper(char c)/* DOC() */{
+char_to_upper(char c)
+/* DOC(If c is a lowercase letter this call returns the uppercase equivalent, otherwise it returns c.) */{
     return (c >= 'a' && c <= 'z') ? c + (char)('A' - 'a') : c;
 }
 
 FSTRING_INLINE char
-char_to_lower(char c)/* DOC() */{
+char_to_lower(char c)
+/* DOC(If c is an uppercase letter this call returns the lowercase equivalent, otherwise it returns c.) */{
     return (c >= 'A' && c <= 'Z') ? c - (char)('A' - 'a') : c;
 }
 
 FSTRING_INLINE fstr_bool
-char_is_whitespace(char c)/* DOC() */{
+char_is_whitespace(char c)
+/* DOC(This call returns non-zero if c is whitespace.) */{
     return (c == ' ' || c == '\n' || c == '\r' || c == '\t');
 }
 
 FSTRING_INLINE fstr_bool
-char_is_alpha_numeric(char c)/* DOC() */{
+char_is_alpha_numeric(char c)
+/* DOC(This call returns non-zero if c is any alphanumeric character including underscore.) */{
     return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z' || c >= '0' && c <= '9' || c == '_');
 }
 
 FSTRING_INLINE fstr_bool
-char_is_hex(char c)/* DOC() */{
-    return c >= '0' && c <= '9' || c >= 'A' && c <= 'F' || c >= 'a' && c <= 'f';
+char_is_alpha_numeric_true(char c)
+/* DOC(This call returns non-zero if c is any alphanumeric character no including underscore.) */{
+    return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z' || c >= '0' && c <= '9');
 }
 
 FSTRING_INLINE fstr_bool
-char_is_numeric(char c)/* DOC() */{
-    return (c >= '0' && c <= '9');
-}
-
-FSTRING_INLINE fstr_bool
-char_is_alpha(char c)/* DOC() */{
+char_is_alpha(char c)
+/* DOC(This call returns non-zero if c is any alphabetic character including underscore.) */{
     return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z' || c == '_');
 }
 
 FSTRING_INLINE fstr_bool
-char_is_alpha_true(char c)/* DOC() */{
+char_is_alpha_true(char c)
+/* DOC(This call returns non-zero if c is any alphabetic character.) */{
     return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z');
 }
 
 FSTRING_INLINE fstr_bool
-char_is_alpha_numeric_true(char c)/* DOC() */{
-    return (c >= 'a' && c <= 'z' || c >= 'A' && c <= 'Z' || c >= '0' && c <= '9');
+char_is_hex(char c)
+/* DOC(This call returns non-zero if c is any valid hexadecimal digit.) */{
+    return c >= '0' && c <= '9' || c >= 'A' && c <= 'F' || c >= 'a' && c <= 'f';
+}
+
+FSTRING_INLINE fstr_bool
+char_is_numeric(char c)
+/* DOC(This call returns non-zero if c is any valid decimal digit.) */{
+    return (c >= '0' && c <= '9');
 }
 
 
@@ -109,13 +114,21 @@ char_is_alpha_numeric_true(char c)/* DOC() */{
 //
 
 FSTRING_INLINE String
-string_zero()/* DOC() */{
+string_zero()
+/* DOC(This call returns a String struct of zeroed members.) */{
     String str={0};
     return(str);
 }
 
 FSTRING_INLINE String
-make_string(void *str, int32_t size, int32_t mem_size)/* DOC() */{
+make_string(void *str, int32_t size, int32_t mem_size)
+/*
+DOC_PARAM(str, The str parameter provides the of memory with which the string shall operate.)
+DOC_PARAM(size, The size parameter expresses the initial size of the string.
+If the memory does not already contain a useful string this should be zero.)
+DOC_PARAM(mem_size, The mem_size parameter expresses the full size of the memory provided by str.)
+DOC(This call returns the String created from the parameters.)
+*/{
     String result;
     result.str = (char*)str;
     result.size = size;
@@ -124,7 +137,14 @@ make_string(void *str, int32_t size, int32_t mem_size)/* DOC() */{
 }
 
 FSTRING_INLINE String
-make_string(void *str, int32_t size)/* DOC() */{
+make_string(void *str, int32_t size)/*
+DOC_PARAM(str, The str parameter provides the of memory with which the string shall operate.)
+DOC_PARAM(size, The size parameter expresses the initial size of the string.
+If the memory does not already contain a useful string this should be zero. Since this version
+does not specify the size of the memory it is also assumed that this size is the maximum size
+of the memory.)
+DOC(This call returns the String created from the parameters.)
+*/{
     String result;
     result.str = (char*)str;
     result.size = size;
@@ -132,24 +152,30 @@ make_string(void *str, int32_t size)/* DOC() */{
     return result;
 }
 
-DOC_EXPORT /* DOC() */
+DOC_EXPORT /* DOC(This macro takes a literal string in quotes and uses it to create a String
+with the correct size and memory size.  Strings created this way should usually not be mutated.) */
 #define make_lit_string(s) (make_string((char*)(s), sizeof(s)-1, sizeof(s)))
 
-DOC_EXPORT /* DOC() */
+DOC_EXPORT /* DOC(This macro takes a local char array with a fixed width and uses it to create
+an empty String with the correct size and memory size to operate on the array.) */
 #define make_fixed_width_string(s) (make_string((char*)(s), 0, sizeof(s)))
 
-DOC_EXPORT /* DOC() */
+DOC_EXPORT /* DOC(This macro is a helper for any calls that take a char*,int pair to specify a
+string. This macro expands to both of those parameters from one String struct.) */
 #define expand_str(s) ((s).str), ((s).size)
 
 FSTRING_LINK int32_t
-str_size(char *str)/* DOC() */{
+str_size(char *str)
+/* DOC(This call returns the number of bytes before a null terminator starting at str.) */{
     int32_t i = 0;
     while (str[i]) ++i;
     return i;
 }
 
 FSTRING_INLINE String
-make_string_slowly(void *str)/* DOC() */{
+make_string_slowly(void *str)
+/* DOC(This call makes a string by counting the number of bytes before a null terminator and
+treating that as the size and memory size of the string.) */{
     String result;
     result.str = (char*)str;
     result.size = str_size((char*)str);
@@ -159,10 +185,13 @@ make_string_slowly(void *str)/* DOC() */{
 
 // TODO(allen): I don't love the substr rule, I chose
 // substr(String, start) and substr(String, start, size)
-// but I wish I had substr(String, end) and substr(String, start, end)
+// but I wish I had substr(String, start) and substr(String, start, end)
 
 FSTRING_INLINE String
-substr(String str, int32_t start)/* DOC() */{
+substr(String str, int32_t start)
+/* DOC(This call creates a substring of str that starts with an offset from str's base.
+The new string uses the same underlying memory so both strings will see changes.
+Usually strings created this way should only go through immutable calls.) */{
     String result;
     result.str = str.str + start;
     result.size = str.size - start;
@@ -171,7 +200,10 @@ substr(String str, int32_t start)/* DOC() */{
 }
 
 FSTRING_INLINE String
-substr(String str, int32_t start, int32_t size)/* DOC() */{
+substr(String str, int32_t start, int32_t size)
+/* DOC(This call creates a substring of str that starts with an offset from str's base,
+and has a fixed size. The new string uses the same underlying memory so both strings
+will see changes. Usually strings created this way should only go through immutable calls.) */{
     String result;
     result.str = str.str + start;
     result.size = size;
@@ -182,17 +214,11 @@ substr(String str, int32_t start, int32_t size)/* DOC() */{
     return(result);
 }
 
-FSTRING_INLINE String
-tailstr(String str)/* DOC() */{
-    String result;
-    result.str = str.str + str.size;
-    result.memory_size = str.memory_size - str.size;
-    result.size = 0;
-    return(result);
-}
-
 FSTRING_LINK String
-skip_whitespace(String str)/* DOC() */{
+skip_whitespace(String str)
+/* DOC(This call creates a substring that starts with the first non-whitespace character of str.
+Like other substr calls, the new string uses the underlying memory and so should usually be
+considered immutable.) DOC_SEE(substr) */{
     String result = {0};
     int i = 0;
     for (; i < str.size && char_is_whitespace(str.str[i]); ++i);
@@ -201,7 +227,10 @@ skip_whitespace(String str)/* DOC() */{
 }
 
 FSTRING_LINK String
-chop_whitespace(String str)/* DOC() */{
+chop_whitespace(String str)
+/* DOC(This call creates a substring that ends with the last non-whitespace character of str.
+Like other substr calls, the new string uses the underlying memory and so should usually be
+considered immutable.) DOC_SEE(substr) */{
     String result = {0};
     int i = str.size;
     for (; i > 0 && char_is_whitespace(str.str[i-1]); --i);
@@ -210,19 +239,32 @@ chop_whitespace(String str)/* DOC() */{
 }
 
 FSTRING_LINK String
-skip_chop_whitespace(String str)/* DOC() */{
+skip_chop_whitespace(String str)
+/* DOC(This call is equivalent to calling skip_whitespace and chop_whitespace together.)
+DOC_SEE(skip_whitespace) DOC_SEE(chop_whitespace)*/{
     str = skip_whitespace(str);
     str = chop_whitespace(str);
     return(str);
 }
 
+FSTRING_INLINE String
+tailstr(String str)
+/* DOC(This call returns an empty String with underlying memory taken from
+the portion of str's memory that is not used.) */{
+    String result;
+    result.str = str.str + str.size;
+    result.memory_size = str.memory_size - str.size;
+    result.size = 0;
+    return(result);
+}
+
 
 //
 // String Comparison
 //
 
 FSTRING_LINK fstr_bool
-match(char *a, char *b)/* DOC() */{
+match(char *a, char *b)/* DOC(This call returns non-zero if a and b are equivalent.) */{
     for (int32_t i = 0;; ++i){
         if (a[i] != b[i]){
             return 0;
@@ -234,7 +276,7 @@ match(char *a, char *b)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-match(String a, char *b)/* DOC() */{
+match(String a, char *b)/* DOC(This call returns non-zero if a and b are equivalent.) */{
     int32_t i = 0;
     for (; i < a.size; ++i){
         if (a.str[i] != b[i]){
@@ -248,12 +290,12 @@ match(String a, char *b)/* DOC() */{
 }
 
 FSTRING_INLINE fstr_bool
-match(char *a, String b)/* DOC() */{
+match(char *a, String b)/* DOC(This call returns non-zero if a and b are equivalent.) */{
     return(match(b,a));
 }
 
 FSTRING_LINK fstr_bool
-match(String a, String b)/* DOC() */{
+match(String a, String b)/* DOC(This call returns non-zero if a and b are equivalent.) */{
     if (a.size != b.size){
         return 0;
     }
@@ -266,7 +308,10 @@ match(String a, String b)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-match_part(char *a, char *b, int32_t *len)/* DOC() */{
+match_part(char *a, char *b, int32_t *len)/*
+DOC_PARAM(len, If this call returns non-zero this parameter is used to output the length of b.)
+DOC(This call is similar to a match call, except that it is permitted for a to be longer than b.
+In other words this call returns non-zero if b is a prefix of a.) */{
     int32_t i;
     for (i = 0; b[i] != 0; ++i){
         if (a[i] != b[i]){
@@ -279,7 +324,10 @@ match_part(char *a, char *b, int32_t *len)/* DOC() */{
 
 
 FSTRING_LINK fstr_bool
-match_part(String a, char *b, int32_t *len)/* DOC() */{
+match_part(String a, char *b, int32_t *len)/*
+DOC_PARAM(len, If this call returns non-zero this parameter is used to output the length of b.)
+DOC(This call is similar to a match call, except that it is permitted for a to be longer than b.
+In other words this call returns non-zero if b is a prefix of a.) */{
     int32_t i;
     for (i = 0; b[i] != 0; ++i){
         if (a.str[i] != b[i] || i == a.size){
@@ -291,19 +339,26 @@ match_part(String a, char *b, int32_t *len)/* DOC() */{
 }
 
 FSTRING_INLINE fstr_bool
-match_part(char *a, char *b)/* DOC() */{
+match_part(char *a, char *b)/*
+DOC_PARAM(len, If this call returns non-zero this parameter is used to output the length of b.)
+DOC(This call is similar to a match call, except that it is permitted for a to be longer than b.
+In other words this call returns non-zero if b is a prefix of a.) */{
     int32_t x;
     return match_part(a,b,&x);
 }
 
 FSTRING_INLINE fstr_bool
-match_part(String a, char *b)/* DOC() */{
+match_part(String a, char *b)/*
+DOC(This call is similar to a match call, except that it is permitted for a to be longer than b.
+In other words this call returns non-zero if b is a prefix of a.) */{
     int32_t x;
     return match_part(a,b,&x);
 }
 
 FSTRING_LINK fstr_bool
-match_part(char *a, String b)/* DOC() */{
+match_part(char *a, String b)/*
+DOC(This call is similar to a match call, except that it is permitted for a to be longer than b.
+In other words this call returns non-zero if b is a prefix of a.) */{
     for (int32_t i = 0; i != b.size; ++i){
         if (a[i] != b.str[i]){
             return 0;
@@ -313,7 +368,9 @@ match_part(char *a, String b)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-match_part(String a, String b)/* DOC() */{
+match_part(String a, String b)/*
+DOC(This call is similar to a match call, except that it is permitted for a to be longer than b.
+In other words this call returns non-zero if b is a prefix of a.) */{
     if (a.size < b.size){
         return 0;
     }
@@ -326,7 +383,8 @@ match_part(String a, String b)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-match_insensitive(char *a, char *b)/* DOC() */{
+match_insensitive(char *a, char *b)/*
+DOC(This call returns non-zero if a and b are equivalent under case insensitive comparison.) */{
     for (int32_t i = 0;; ++i){
         if (char_to_upper(a[i]) !=
             char_to_upper(b[i])){
@@ -339,7 +397,8 @@ match_insensitive(char *a, char *b)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-match_insensitive(String a, char *b)/* DOC() */{
+match_insensitive(String a, char *b)/*
+DOC(This call returns non-zero if a and b are equivalent under case insensitive comparison.) */{
     int32_t i = 0;
     for (; i < a.size; ++i){
         if (char_to_upper(a.str[i]) !=
@@ -354,12 +413,14 @@ match_insensitive(String a, char *b)/* DOC() */{
 }
 
 FSTRING_INLINE fstr_bool
-match_insensitive(char *a, String b)/* DOC() */{
+match_insensitive(char *a, String b)/*
+DOC(This call returns non-zero if a and b are equivalent under case insensitive comparison.) */{
     return match_insensitive(b,a);
 }
 
 FSTRING_LINK fstr_bool
-match_insensitive(String a, String b)/* DOC() */{
+match_insensitive(String a, String b)/*
+DOC(This call returns non-zero if a and b are equivalent under case insensitive comparison.) */{
     if (a.size != b.size){
         return 0;
     }
@@ -373,7 +434,10 @@ match_insensitive(String a, String b)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-match_part_insensitive(char *a, char *b, int32_t *len)/* DOC() */{
+match_part_insensitive(char *a, char *b, int32_t *len)/*
+DOC_PARAM(len, If this call returns non-zero this parameter is used to output the length of b.)
+DOC(This call performs the same partial matching rule as match_part under case insensitive comparison.)
+DOC_SEE(match_part) */{
     int32_t i;
     for (i = 0; b[i] != 0; ++i){
         if (char_to_upper(a[i]) != char_to_upper(b[i])){
@@ -385,7 +449,10 @@ match_part_insensitive(char *a, char *b, int32_t *len)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-match_part_insensitive(String a, char *b, int32_t *len)/* DOC() */{
+match_part_insensitive(String a, char *b, int32_t *len)/*
+DOC_PARAM(len, If this call returns non-zero this parameter is used to output the length of b.)
+DOC(This call performs the same partial matching rule as match_part under case insensitive comparison.)
+DOC_SEE(match_part) */{
     int32_t i;
     for (i = 0; b[i] != 0; ++i){
         if (char_to_upper(a.str[i]) != char_to_upper(b[i]) ||
@@ -398,19 +465,25 @@ match_part_insensitive(String a, char *b, int32_t *len)/* DOC() */{
 }
 
 FSTRING_INLINE fstr_bool
-match_part_insensitive(char *a, char *b)/* DOC() */{
+match_part_insensitive(char *a, char *b)/*
+DOC(This call performs the same partial matching rule as match_part under case insensitive comparison.)
+DOC_SEE(match_part) */{
     int32_t x;
     return match_part(a,b,&x);
 }
 
 FSTRING_INLINE fstr_bool
-match_part_insensitive(String a, char *b)/* DOC() */{
+match_part_insensitive(String a, char *b)/*
+DOC(This call performs the same partial matching rule as match_part under case insensitive comparison.)
+DOC_SEE(match_part) */{
     int32_t x;
     return match_part(a,b,&x);
 }
 
 FSTRING_LINK fstr_bool
-match_part_insensitive(char *a, String b)/* DOC() */{
+match_part_insensitive(char *a, String b)/*
+DOC(This call performs the same partial matching rule as match_part under case insensitive comparison.)
+DOC_SEE(match_part) */{
     for (int32_t i = 0; i != b.size; ++i){
         if (char_to_upper(a[i]) != char_to_upper(b.str[i])){
             return 0;
@@ -420,7 +493,9 @@ match_part_insensitive(char *a, String b)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-match_part_insensitive(String a, String b)/* DOC() */{
+match_part_insensitive(String a, String b)/*
+DOC(This call performs the same partial matching rule as match_part under case insensitive comparison.)
+DOC_SEE(match_part) */{
     if (a.size < b.size){
         return 0;
     }
@@ -433,7 +508,10 @@ match_part_insensitive(String a, String b)/* DOC() */{
 }
 
 FSTRING_LINK int32_t
-compare(char *a, char *b)/* DOC() */{
+compare(char *a, char *b)/*
+DOC(This call returns zero if a and b are equivalent,
+it returns negative if a sorts before b alphabetically,
+and positive if a sorts after b alphabetically.) */{
     int32_t i = 0;
     while (a[i] == b[i] && a[i] != 0){
         ++i;
@@ -442,7 +520,10 @@ compare(char *a, char *b)/* DOC() */{
 }
 
 FSTRING_LINK int32_t
-compare(String a, char *b)/* DOC() */{
+compare(String a, char *b)/*
+DOC(This call returns zero if a and b are equivalent,
+it returns negative if a sorts before b alphabetically,
+and positive if a sorts after b alphabetically.) */{
     int32_t i = 0;
     while (i < a.size && a.str[i] == b[i]){
         ++i;
@@ -461,12 +542,18 @@ compare(String a, char *b)/* DOC() */{
 }
 
 FSTRING_INLINE int32_t
-compare(char *a, String b)/* DOC() */{
+compare(char *a, String b)/*
+DOC(This call returns zero if a and b are equivalent,
+it returns negative if a sorts before b alphabetically,
+and positive if a sorts after b alphabetically.) */{
     return -compare(b,a);
 }
 
 FSTRING_LINK int32_t
-compare(String a, String b)/* DOC() */{
+compare(String a, String b)/*
+DOC(This call returns zero if a and b are equivalent,
+it returns negative if a sorts before b alphabetically,
+and positive if a sorts after b alphabetically.) */{
     int32_t i = 0;
     while (i < a.size && i < b.size && a.str[i] == b.str[i]){
         ++i;
@@ -484,21 +571,36 @@ compare(String a, String b)/* DOC() */{
 //
 
 FSTRING_LINK int32_t
-find(char *str, int32_t start, char character)/* DOC() */{
+find(char *str, int32_t start, char character)/*
+DOC_PARAM(str, The str parameter provides a null terminated string to search.)
+DOC_PARAM(start, The start parameter provides the index of the first character in str to search.)
+DOC_PARAM(character, The character parameter provides the character for which to search.)
+DOC(This call returns the index of the first occurance of character, or the size of the string
+if the character is not found.) */{
     int32_t i = start;
     while (str[i] != character && str[i] != 0) ++i;
     return i;
 }
 
 FSTRING_LINK int32_t
-find(String str, int32_t start, char character)/* DOC() */{
+find(String str, int32_t start, char character)/*
+DOC_PARAM(str, The str parameter provides a string to search.)
+DOC_PARAM(start, The start parameter provides the index of the first character in str to search.)
+DOC_PARAM(character, The character parameter provides the character for which to search.)
+DOC(This call returns the index of the first occurance of character, or the size of the string
+if the character is not found.) */{
     int32_t i = start;
     while (i < str.size && str.str[i] != character) ++i;
     return i;
 }
 
 FSTRING_LINK int32_t
-find(char *str, int32_t start, char *characters)/* DOC() */{
+find(char *str, int32_t start, char *characters)/*
+DOC_PARAM(str, The str parameter provides a null terminated string to search.)
+DOC_PARAM(start, The start parameter provides the index of the first character in str to search.)
+DOC_PARAM(character, The characters parameter provides a null terminated array of characters for which to search.)
+DOC(This call returns the index of the first occurance of a character in the characters array,
+or the size of the string if no such character is not found.) */{
     int32_t i = start, j;
     while (str[i] != 0){
         for (j = 0; characters[j]; ++j){
@@ -512,7 +614,12 @@ find(char *str, int32_t start, char *characters)/* DOC() */{
 }
 
 FSTRING_LINK int32_t
-find(String str, int32_t start, char *characters)/* DOC() */{
+find(String str, int32_t start, char *characters)/*
+DOC_PARAM(str, The str parameter provides a string to search.)
+DOC_PARAM(start, The start parameter provides the index of the first character in str to search.)
+DOC_PARAM(character, The characters parameter provides a null terminated array of characters for which to search.)
+DOC(This call returns the index of the first occurance of a character in the characters array,
+or the size of the string if no such character is not found.) */{
     int32_t i = start, j;
     while (i < str.size){
         for (j = 0; characters[j]; ++j){
@@ -526,7 +633,12 @@ find(String str, int32_t start, char *characters)/* DOC() */{
 }
 
 FSTRING_LINK int32_t
-find_substr(char *str, int32_t start, String seek)/* DOC() */{
+find_substr(char *str, int32_t start, String seek)/*
+DOC_PARAM(str, The str parameter provides a null terminated string to search.)
+DOC_PARAM(start, The start parameter provides the index of the first character in str to search.)
+DOC_PARAM(seek, The seek parameter provides a string to find in str.)
+DOC(This call returns the index of the first occurance of the seek substring in str or the
+size of str if no such substring in str is found.) */{
     int32_t i, j, k;
     fstr_bool hit;
     
@@ -551,7 +663,12 @@ find_substr(char *str, int32_t start, String seek)/* DOC() */{
 }
 
 FSTRING_LINK int32_t
-find_substr(String str, int32_t start, String seek)/* DOC() */{
+find_substr(String str, int32_t start, String seek)/*
+DOC_PARAM(str, The str parameter provides a string to search.)
+DOC_PARAM(start, The start parameter provides the index of the first character in str to search.)
+DOC_PARAM(seek, The seek parameter provides a string to find in str.)
+DOC(This call returns the index of the first occurance of the seek substring in str or the
+size of str if no such substring in str is found.) */{
     int32_t stop_at, i, j, k;
     fstr_bool hit;
     
@@ -577,7 +694,12 @@ find_substr(String str, int32_t start, String seek)/* DOC() */{
 }
 
 FSTRING_LINK int32_t
-rfind_substr(String str, int32_t start, String seek)/* DOC() */{
+rfind_substr(String str, int32_t start, String seek)/*
+DOC_PARAM(str, The str parameter provides a string to search.)
+DOC_PARAM(start, The start parameter provides the index of the first character in str to search.)
+DOC_PARAM(seek, The seek parameter provides a string to find in str.)
+DOC(This call returns the index of the last occurance of the seek substring in str
+or -1 if no such substring in str is found.) */{
     int32_t i, j, k;
     fstr_bool hit;
     
@@ -605,7 +727,12 @@ rfind_substr(String str, int32_t start, String seek)/* DOC() */{
 }
 
 FSTRING_LINK int32_t
-find_substr_insensitive(char *str, int32_t start, String seek)/* DOC() */{
+find_substr_insensitive(char *str, int32_t start, String seek)/*
+DOC_PARAM(str, The str parameter provides a null terminated string to search.)
+DOC_PARAM(start, The start parameter provides the index of the first character in str to search.)
+DOC_PARAM(seek, The seek parameter provides a string to find in str.)
+DOC(This call acts as find_substr under case insensitive comparison.)
+DOC_SEE(find_substr)*/{
     int32_t i, j, k;
     fstr_bool hit;
     char a_upper, b_upper;
@@ -633,7 +760,12 @@ find_substr_insensitive(char *str, int32_t start, String seek)/* DOC() */{
 }
 
 FSTRING_LINK int32_t
-find_substr_insensitive(String str, int32_t start, String seek)/* DOC() */{
+find_substr_insensitive(String str, int32_t start, String seek)/*
+DOC_PARAM(str, The str parameter provides a string to search.)
+DOC_PARAM(start, The start parameter provides the index of the first character in str to search.)
+DOC_PARAM(seek, The seek parameter provides a string to find in str.)
+DOC(This call acts as find_substr under case insensitive comparison.)
+DOC_SEE(find_substr)*/{
     int32_t i, j, k;
     int32_t stop_at;
     fstr_bool hit;
@@ -663,22 +795,28 @@ find_substr_insensitive(String str, int32_t start, String seek)/* DOC() */{
 }
 
 FSTRING_INLINE fstr_bool
-has_substr(char *s, String seek)/* DOC() */{
+has_substr(char *s, String seek)/*
+DOC(This call returns non-zero if the string s contains a substring equivalent to seek.) */{
     return (s[find_substr(s, 0, seek)] != 0);
 }
 
 FSTRING_INLINE fstr_bool
-has_substr(String s, String seek)/* DOC() */{
+has_substr(String s, String seek)/*
+DOC(This call returns non-zero if the string s contains a substring equivalent to seek.) */{
     return (find_substr(s, 0, seek) < s.size);
 }
 
 FSTRING_INLINE fstr_bool
-has_substr_insensitive(char *s, String seek)/* DOC() */{
+has_substr_insensitive(char *s, String seek)/*
+DOC(This call returns non-zero if the string s contains a substring equivalent to seek
+under case insensitive comparison.) */{
     return (s[find_substr_insensitive(s, 0, seek)] != 0);
 }
 
 FSTRING_INLINE fstr_bool
-has_substr_insensitive(String s, String seek)/* DOC() */{
+has_substr_insensitive(String s, String seek)/*
+DOC(This call returns non-zero if the string s contains a substring equivalent to seek
+under case insensitive comparison.) */{
     return (find_substr_insensitive(s, 0, seek) < s.size);
 }
 
@@ -687,27 +825,41 @@ has_substr_insensitive(String s, String seek)/* DOC() */{
 //
 
 FSTRING_LINK int32_t
-copy_fast_unsafe(char *dest, char *src)/* DOC() */{
+copy_fast_unsafe(char *dest, char *src)/*
+DOC(This call performs a copy from the src buffer to the dest buffer.
+The copy does not stop until a null terminator is found in src.  There
+is no safety against overrun so dest must be large enough to contain src.
+The null terminator is not written to dest. This call returns the number
+of bytes coppied to dest.) */{
     char *start = dest;
     while (*src != 0){
         *dest = *src;
         ++dest;
         ++src;
     }
-    return (int)(dest - start);
+    return (int32_t)(dest - start);
 }
 
-FSTRING_LINK void
-copy_fast_unsafe(char *dest, String src)/* DOC() */{
+FSTRING_LINK int32_t
+copy_fast_unsafe(char *dest, String src)/*
+DOC(This call performs a copy from the src string to the dest buffer.
+The copy does not stop until src.size characters are coppied.  There
+is no safety against overrun so dest must be large enough to contain src.
+The null terminator is not written to dest. This call returns the number
+of bytes coppied to dest.) */{
     int32_t i = 0;
     while (i != src.size){
         dest[i] = src.str[i];
         ++i;
     }
+    return(src.size);
 }
 
 FSTRING_LINK fstr_bool
-copy_checked(String *dest, String src)/* DOC() */{
+copy_checked(String *dest, String src)/*
+DOC(This call performs a copy from the src string to the dest string.
+The memory_size of dest is checked before any coppying is done.
+This call returns non-zero on a successful copy.) */{
     char *dest_str;
     int32_t i;
     if (dest->memory_size < src.size){
@@ -722,7 +874,11 @@ copy_checked(String *dest, String src)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-copy_partial(String *dest, char *src)/* DOC() */{
+copy_partial(String *dest, char *src)/*
+DOC(This call performs a copy from the src buffer to the dest string.
+The memory_size of dest is checked if the entire copy cannot be performed,
+as many bytes as possible are coppied to dest. This call returns non-zero
+if the entire string is coppied to dest.) */{
     int32_t i = 0;
     int32_t memory_size = dest->memory_size;
     char *dest_str = dest->str;
@@ -738,44 +894,50 @@ copy_partial(String *dest, char *src)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-copy_partial(String *dest, String src)/* DOC() */{
-    fstr_bool result;
-    int32_t memory_size = dest->memory_size;
+copy_partial(String *dest, String src)/*
+DOC(This call performs a copy from the src string to the dest string.
+The memory_size of dest is checked if the entire copy cannot be performed,
+as many bytes as possible are coppied to dest. This call returns non-zero
+if the entire string is coppied to dest.) */{
     char *dest_str = dest->str;
-    if (memory_size < src.size){
-        result = 0;
-        for (int32_t i = 0; i < memory_size; ++i){
-            dest_str[i] = src.str[i];
-        }
-        dest->size = memory_size;
+    int32_t memory_size = dest->memory_size;
+    fstr_bool result = false;
+    if (memory_size >= src.size){
+        result = true;
+        memory_size = src.size;
     }
-    else{
-        result = 1;
-        for (int32_t i = 0; i < src.size; ++i){
-            dest_str[i] = src.str[i];
-        }
-        dest->size = src.size;
+    for (int32_t i = 0; i < memory_size; ++i){
+        dest_str[i] = src.str[i];
     }
+    dest->size = memory_size;
     return result;
 }
 
 FSTRING_INLINE int32_t
-copy(char *dest, char *src)/* DOC() */{
+copy(char *dest, char *src)/*
+DOC(This call performs a copy from src to dest equivalent to copy_fast_unsafe.)
+DOC_SEE(copy_fast_unsafe) */{
     return copy_fast_unsafe(dest, src);
 }
 
 FSTRING_INLINE void
-copy(String *dest, String src)/* DOC() */{
+copy(String *dest, String src)/*
+DOC(This call performs a copy from src to dest equivalent to copy_checked.)
+DOC_SEE(copy_checked) */{
     copy_checked(dest, src);
 }
 
 FSTRING_INLINE void
-copy(String *dest, char *src)/* DOC() */{
+copy(String *dest, char *src)/*
+DOC(This call performs a copy from src to dest equivalent to copy_partial.)
+DOC_SEE(copy_partial) */{
     copy_partial(dest, src);
 }
 
 FSTRING_LINK fstr_bool
-append_checked(String *dest, String src)/* DOC() */{
+append_checked(String *dest, String src)/*
+DOC(This call checks if there is enough space in dest's underlying memory
+to append src onto dest. If there is src is appended and the call returns non-zero.) */{
     String end;
     end = tailstr(*dest);
     fstr_bool result = copy_checked(&end, src);
@@ -786,7 +948,9 @@ append_checked(String *dest, String src)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-append_partial(String *dest, char *src)/* DOC() */{
+append_partial(String *dest, char *src)/*
+DOC(This call attemps to append as much of src into the space in dest's underlying memory
+as possible.  If the entire string is appended the call returns non-zero.) */{
     String end = tailstr(*dest);
     fstr_bool result = copy_partial(&end, src);
     dest->size += end.size;
@@ -794,7 +958,9 @@ append_partial(String *dest, char *src)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-append_partial(String *dest, String src)/* DOC() */{
+append_partial(String *dest, String src)/*
+DOC(This call attemps to append as much of src into the space in dest's underlying memory
+as possible.  If the entire string is appended the call returns non-zero.) */{
     String end = tailstr(*dest);
     fstr_bool result = copy_partial(&end, src);
     dest->size += end.size;
@@ -802,7 +968,9 @@ append_partial(String *dest, String src)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-append(String *dest, char c)/* DOC() */{
+append(String *dest, char c)/*
+DOC(This call attemps to append c onto dest.  If there is space left in dest's underlying
+memory the character is appended and the call returns non-zero.) */{
     fstr_bool result = 0;
     if (dest->size < dest->memory_size){
         dest->str[dest->size++] = c;
@@ -812,16 +980,23 @@ append(String *dest, char c)/* DOC() */{
 }
 
 FSTRING_INLINE fstr_bool
-append(String *dest, String src)/* DOC() */{
+append(String *dest, String src)/*
+DOC(This call is equivalent to append_partial.) DOC_SEE(append_partial) */{
     return append_partial(dest, src);
 }
 
 FSTRING_INLINE fstr_bool
-append(String *dest, char *src)/* DOC() */{
+append(String *dest, char *src)/*
+DOC(This call is equivalent to append_partial.) DOC_SEE(append_partial) */{
     return append_partial(dest, src);
 }
 
-FSTRING_LINK fstr_bool terminate_with_null(String *str)/* DOC() */{
+FSTRING_LINK fstr_bool
+terminate_with_null(String *str)/*
+DOC(This call attemps to append a null terminator onto str without effecting the
+size of str. This is usually called when the time comes to pass the the string to an
+API that requires a null terminator.  This call returns non-zero if there was a spare
+byte in the strings underlying memory.) */{
     fstr_bool result = 0;
     if (str->size < str->memory_size){
         str->str[str->size] = 0;
@@ -831,10 +1006,13 @@ FSTRING_LINK fstr_bool terminate_with_null(String *str)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-append_padding(String *dest, char c, int32_t target_size)/* DOC() */{
+append_padding(String *dest, char c, int32_t target_size)/*
+DOC(This call pads out dest so that it has a size of target_size by appending
+the padding character c until the target size is achieved.  This call returns
+non-zero if dest does not run out of space in the underlying memory.) */{
     fstr_bool result = 1;
     int32_t offset = target_size - dest->size;
-    int32_t r;
+    int32_t r = 0;
     if (offset > 0){
         for (r = 0; r < offset; ++r){
             if (append(dest, c) == 0){
@@ -852,10 +1030,13 @@ append_padding(String *dest, char c, int32_t target_size)/* DOC() */{
 //
 
 FSTRING_LINK void
-replace_char(String *str, char replace, char with){
+replace_char(String *str, char replace, char with)/*
+DOC_PARAM(str, The str parameter provides the string in which replacement shall be performed.)
+DOC_PARAM(replace, The replace character specifies which character should be replaced.)
+DOC_PARAM(with, The with character specifies what to write into the positions where replacement occurs.)
+DOC(This call replaces all occurances of character in str with another character.) */{
     char *s = str->str;
-    int32_t i;
-    
+    int32_t i = 0;
     for (i = 0; i < str->size; ++i, ++s){
         if (*s == replace) *s = with;
     }
@@ -866,7 +1047,8 @@ replace_char(String *str, char replace, char with){
 //
 
 FSTRING_LINK int32_t
-int_to_str_size(int32_t x)/* DOC() */{
+int_to_str_size(int32_t x)/*
+DOC(This call returns the number of bytes required to represent x as a string.) */{
     int32_t size = 1;
     if (x < 0){
         size = 2;
@@ -880,7 +1062,9 @@ int_to_str_size(int32_t x)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-int_to_str(String *dest, int32_t x)/* DOC() */{
+int_to_str(String *dest, int32_t x)/*
+DOC(This call writes a string representation of x into dest. If there is enough
+space in dest this call returns non-zero.) */{
     fstr_bool result = 1;
     char *str = dest->str;
     int32_t memory_size = dest->memory_size;
@@ -926,7 +1110,9 @@ int_to_str(String *dest, int32_t x)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-append_int_to_str(String *dest, int32_t x)/* DOC() */{
+append_int_to_str(String *dest, int32_t x)/*
+DOC(This call appends a string representation of x onto dest. If there is enough
+space in dest this call returns non-zero.) */{
     String last_part = tailstr(*dest);
     fstr_bool result = int_to_str(&last_part, x);
     if (result){
@@ -936,7 +1122,8 @@ append_int_to_str(String *dest, int32_t x)/* DOC() */{
 }
 
 FSTRING_LINK int32_t
-u64_to_str_size(uint64_t x)/* DOC() */{
+u64_to_str_size(uint64_t x)/*
+DOC(This call returns the number of bytes required to represent x as a string.) */{
     int32_t size;
     if (x < 0){
         size = 0;
@@ -953,7 +1140,9 @@ u64_to_str_size(uint64_t x)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-u64_to_str(String *dest, uint64_t x)/* DOC() */{
+u64_to_str(String *dest, uint64_t x)/*
+DOC(This call writes a string representation of x into dest. If there is enough
+space in dest this call returns non-zero.) */{
     fstr_bool result = 1;
     char *str = dest->str;
     int32_t memory_size = dest->memory_size;
@@ -990,7 +1179,9 @@ u64_to_str(String *dest, uint64_t x)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-append_u64_to_str(String *dest, uint64_t x)/* DOC() */{
+append_u64_to_str(String *dest, uint64_t x)/*
+DOC(This call appends a string representation of x onto dest. If there is enough
+space in dest this call returns non-zero.) */{
     String last_part = tailstr(*dest);
     fstr_bool result = u64_to_str(&last_part, x);
     if (result){
@@ -1023,7 +1214,8 @@ get_float_vars(float x){
 #endif
 
 FSTRING_LINK int32_t
-float_to_str_size(float x)/* DOC() */{
+float_to_str_size(float x)/*
+DOC(This call returns the number of bytes required to represent x as a string.) */{
     Float_To_Str_Variables vars = get_float_vars(x);
     int32_t size =
         vars.negative + int_to_str_size(vars.int_part) + 1 + int_to_str_size(vars.dec_part);
@@ -1031,7 +1223,9 @@ float_to_str_size(float x)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-append_float_to_str(String *dest, float x)/* DOC() */{
+append_float_to_str(String *dest, float x)/*
+DOC(This call writes a string representation of x into dest. If there is enough
+space in dest this call returns non-zero.) */{
     fstr_bool result = 1;
     Float_To_Str_Variables vars = get_float_vars(x);
     
@@ -1047,7 +1241,9 @@ append_float_to_str(String *dest, float x)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-float_to_str(String *dest, float x)/* DOC() */{
+float_to_str(String *dest, float x)/*
+DOC(This call appends a string representation of x onto dest. If there is enough
+space in dest this call returns non-zero.) */{
     fstr_bool result = 1;
     dest->size = 0;
     append_float_to_str(dest, x);
@@ -1055,7 +1251,9 @@ float_to_str(String *dest, float x)/* DOC() */{
 }
 
 FSTRING_LINK int32_t
-str_to_int(char *str)/* DOC() */{
+str_to_int(char *str)/*
+DOC(If str represents a valid string representation of an integer, this call will return
+the integer represented by the string.  Otherwise this call returns zero.) */{
     int32_t x = 0;
     for (; *str; ++str){
         if (*str >= '0' || *str <= '9'){
@@ -1071,7 +1269,9 @@ str_to_int(char *str)/* DOC() */{
 }
 
 FSTRING_LINK int32_t
-str_to_int(String str)/* DOC() */{
+str_to_int(String str)/*
+DOC(If str represents a valid string representation of an integer, this call will return
+the integer represented by the string.  Otherwise this call returns zero.) */{
     int32_t x, i;
     if (str.size == 0){
         x = 0;
@@ -1087,8 +1287,10 @@ str_to_int(String str)/* DOC() */{
 }
 
 FSTRING_LINK int32_t
-hexchar_to_int(char c)/* DOC() */{
-    int32_t x;
+hexchar_to_int(char c)/*
+DOC(If c is a valid hexadecimal digit [0-9a-fA-F] this call returns the value of
+the integer value of the digit. Otherwise the return is some nonsense value.) */{
+    int32_t x = 0;
     if (c >= '0' && c <= '9'){
         x = c-'0';
     }
@@ -1102,12 +1304,16 @@ hexchar_to_int(char c)/* DOC() */{
 }
 
 FSTRING_LINK char
-int_to_hexchar(int32_t x)/* DOC() */{
+int_to_hexchar(int32_t x)/*
+DOC(If x is in the range [0,15] this call returns the equivalent lowercase hexadecimal digit.
+Otherwise the return is some nonsense value.) */{
     return (x<10)?((char)x+'0'):((char)x+'a'-10);
 }
 
 FSTRING_LINK uint32_t
-hexstr_to_int(String str)/* DOC() */{
+hexstr_to_int(String str)/*
+DOC(This call interprets str has a hexadecimal representation of an integer and returns
+the represented integer value.) */{
     uint32_t x;
     int32_t i;
     if (str.size == 0){
@@ -1124,7 +1330,9 @@ hexstr_to_int(String str)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-color_to_hexstr(String *s, uint32_t color)/* DOC() */{
+color_to_hexstr(String *s, uint32_t color)/*
+DOC(This call fills s with the hexadecimal representation of the color.
+If there is enough memory in s to represent the color this call returns non-zero.) */{
     fstr_bool result = 0;
     int32_t i;
     
@@ -1151,7 +1359,8 @@ color_to_hexstr(String *s, uint32_t color)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-hexstr_to_color(String s, uint32_t *out)/* DOC() */{
+hexstr_to_color(String s, uint32_t *out)/*
+DOC(This call interprets s as a color and writes the 32-bit integer representation into out.) */{
     fstr_bool result = 0;
     uint32_t color = 0;
     if (s.size == 6){
@@ -1173,31 +1382,43 @@ hexstr_to_color(String s, uint32_t *out)/* DOC() */{
 //
 
 FSTRING_LINK int32_t
-reverse_seek_slash(String str, int32_t pos)/* DOC() */{
+reverse_seek_slash(String str, int32_t pos)/*
+DOC(This call searches for a slash in str by starting pos bytes from the end and going backwards.) */{
     int32_t i = str.size - 1 - pos;
-    while (i >= 0 && char_not_slash(str.str[i])){
+    while (i >= 0 && !char_is_slash(str.str[i])){
         --i;
     }
     return i;
 }
 
 FSTRING_INLINE int32_t
-reverse_seek_slash(String str)/* DOC() */{
+reverse_seek_slash(String str)/*
+DOC(This call searches for a slash in str by starting at the end and going backwards.) */{
     return(reverse_seek_slash(str, 0));
 }
 
 FSTRING_INLINE String
-front_of_directory(String dir)/* DOC() */{
+front_of_directory(String dir)/*
+DOC(This call returns a substring of dir containing only the file name or
+folder name furthest to the right in the directory.) DOC_SEE(substr) */{
     return substr(dir, reverse_seek_slash(dir) + 1);
 }
 
 FSTRING_INLINE String
-path_of_directory(String dir)/* DOC() */{
+path_of_directory(String dir)/*
+DOC(This call returns a substring of dir containing the whole path except
+for the final file or folder name.) DOC_SEE(substr) */{
     return substr(dir, 0, reverse_seek_slash(dir) + 1);
 }
 
 FSTRING_LINK fstr_bool
-set_last_folder(String *dir, char *folder_name, char slash)/* DOC() */{
+set_last_folder(String *dir, char *folder_name, char slash)/*
+DOC_PARAM(dir, The dir parameter is the directory string in which to set the last folder in the directory.)
+DOC_PARAM(folder_name, The folder_name parameter is a null terminated string specifying the name to set
+at the end of the directory.)
+DOC_PARAM(slash, The slash parameter specifies what slash to use between names in the directory.)
+DOC(This call deletes the last file name or folder name in the dir string and appends the new provided one.
+If there is enough memory in dir this call returns non-zero.) */{
     char str[2];
     fstr_bool result = 0;
     int32_t size = reverse_seek_slash(*dir) + 1;
@@ -1216,7 +1437,12 @@ set_last_folder(String *dir, char *folder_name, char slash)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-set_last_folder(String *dir, String folder_name, char slash)/* DOC() */{
+set_last_folder(String *dir, String folder_name, char slash)/*
+DOC_PARAM(dir, The dir parameter is the directory string in which to set the last folder in the directory.)
+DOC_PARAM(folder_name, The folder_name parameter is a string specifying the name to set at the end of the directory.)
+DOC_PARAM(slash, The slash parameter specifies what slash to use between names in the directory.)
+DOC(This call deletes the last file name or folder name in the dir string and appends the new provided one.
+If there is enough memory in dir this call returns non-zero.) */{
     char str[2];
     fstr_bool result = 0;
     int32_t size = reverse_seek_slash(*dir) + 1;
@@ -1235,7 +1461,9 @@ set_last_folder(String *dir, String folder_name, char slash)/* DOC() */{
 }
 
 FSTRING_LINK String
-file_extension(String str)/* DOC() */{
+file_extension(String str)/*
+DOC(This call returns a substring containing only the file extension of the provided filename.)
+DOC_SEE(substr) */{
     int32_t i;
     for (i = str.size - 1; i >= 0; --i){
         if (str.str[i] == '.') break;
@@ -1245,7 +1473,9 @@ file_extension(String str)/* DOC() */{
 }
 
 FSTRING_LINK fstr_bool
-remove_last_folder(String *str)/* DOC() */{
+remove_last_folder(String *str)/*
+DOC(This call attemps to delete a folder or filename off the end of a path string.
+This call returns non-zero on success.) */{
     fstr_bool result = 0;
     int32_t end = reverse_seek_slash(*str, 1);
     if (end >= 0){
@@ -1257,7 +1487,14 @@ remove_last_folder(String *str)/* DOC() */{
 
 // TODO(allen): Add hash-table extension to string sets.
 FSTRING_LINK fstr_bool
-string_set_match(String *str_set, int32_t count, String str, int32_t *match_index)/* DOC() */{
+string_set_match(String *str_set, int32_t count, String str, int32_t *match_index)/*
+DOC_PARAM(str_set, The str_set parameter is an array of String structs specifying matchable strings.)
+DOC_PARAM(count, The count parameter specifies the number of String structs in the str_set array.)
+DOC_PARAM(str, The str parameter specifies the string to match against the str_set.)
+DOC_PARAM(match_index, If this call succeeds match_index is filled with the index into str_set where the match occurred.)
+DOC(This call tries to see if str matches any of the strings in str_set.  If there is a match the call
+succeeds and returns non-zero.  The matching rule is equivalent to the matching rule for match.)
+DOC_SEE(match) */{
     fstr_bool result = false;
     int32_t i = 0;
     for (; i < count; ++i, ++str_set){