From 16b69a2ebf7597e6ad444a6adae881f14902d8f2 Mon Sep 17 00:00:00 2001
From: Andrew Dupont <prototype@andrewdupont.net>
Date: Sat, 13 Jun 2009 19:27:22 -0500
Subject: [PATCH] Update inline documentation.

---
 src/ajax.js        | 4 ++--
 src/lang/string.js | 8 ++++++++
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/src/ajax.js b/src/ajax.js
index 96cd928..3102025 100644
--- a/src/ajax.js
+++ b/src/ajax.js
@@ -31,8 +31,8 @@
  *
  *  * `asynchronous` ([[Boolean]]; default `true`): Determines whether
  *    `XMLHttpRequest` is used asynchronously or not. Synchronous usage is
- *    seriously discouraged &mdash; it halts all script execution for the duration of
- *    the request _and_ blocks the browser UI.
+ *    **strongly discouraged** &mdash; it halts all script execution for the 
+ *    duration of the request _and_ blocks the browser UI.
  *  * `contentType` ([[String]]; default `application/x-www-form-urlencoded`):
  *    The `Content-type` header for your request. Change this header if you
  *    want to send data in another format (like XML).
diff --git a/src/lang/string.js b/src/lang/string.js
index 4b125dd..5066d0d 100644
--- a/src/lang/string.js
+++ b/src/lang/string.js
@@ -254,6 +254,14 @@ Object.extend(String.prototype, (function() {
    *
    *  Converts a string separated by dashes into a camelCase equivalent.
    *  For instance, 'foo-bar' would be converted to 'fooBar'.
+   *  
+   *  <h4>Examples</h4>
+   *  
+   *      'background-color'.camelize();
+   *      // -> 'backgroundColor'
+   *      
+   *      '-moz-binding'.camelize();
+   *      // -> 'MozBinding'
   **/
   function camelize() {
     var parts = this.split('-'), len = parts.length;