Add comments to source.

-# rivets.js
-# version : 0.1.2
-# author : Michael Richards
-# license : MIT
+#     rivets.js
+#     version : 0.1.2
+#     author : Michael Richards
+#     license : MIT
 
 
+# Registers a specific binding routine between a model object and a DOM element.
+# All information for that routine is passed in when calling this function; the
+# specific element to bind to, an adapter interface for the model object, the
+# type of binding, the context object and the keypath at which to subscribe to
+# on the model object.
 registerBinding = (el, adapter, type, context, keypath) ->
 registerBinding = (el, adapter, type, context, keypath) ->
   bind = bindings[type] || attributeBinding type
   bind = bindings[type] || attributeBinding type
   bind el, adapter.read context, keypath
   bind el, adapter.read context, keypath
@@ -14,17 +19,24 @@ registerBinding = (el, adapter, type, context, keypath) ->
     el.addEventListener 'change', ->
     el.addEventListener 'change', ->
       adapter.publish context, keypath, getInputValue this
       adapter.publish context, keypath, getInputValue this
 
 
+# Returns the current input value for the specified element.
 getInputValue = (el) ->
 getInputValue = (el) ->
   switch el.type
   switch el.type
     when 'text', 'textarea', 'password', 'select-one' then el.value
     when 'text', 'textarea', 'password', 'select-one' then el.value
     when 'checkbox', 'radio' then el.checked
     when 'checkbox', 'radio' then el.checked
 
 
+# Returns an attribute binding routine for the specified attribute. This is what
+# `registerBinding` falls back to when there is no routine for the binding type.
 attributeBinding = (attr) -> (el, value) ->
 attributeBinding = (attr) -> (el, value) ->
   if value then el.setAttribute attr, value else el.removeAttribute attr
   if value then el.setAttribute attr, value else el.removeAttribute attr
 
 
+# Returns a state binding routine for the specified attribute. Can optionally be
+# negatively evaluated. This is used to build a lot of the core state binding
+# routines.
 stateBinding = (attr, inverse = false) -> (el, value) ->
 stateBinding = (attr, inverse = false) -> (el, value) ->
   attributeBinding(attr) el, if inverse is !value then attr else false
   attributeBinding(attr) el, if inverse is !value then attr else false
 
 
+# Core binding routines.
 bindings =
 bindings =
   checked:
   checked:
     stateBinding 'checked'
     stateBinding 'checked'
@@ -49,8 +61,11 @@ bindings =
   hide: (el, value) ->
   hide: (el, value) ->
     el.style.display = if value then 'none' else ''
     el.style.display = if value then 'none' else ''
 
 
+# Bindings that should also be observed for changes on the DOM element in order
+# to propogate those changes back to the model object.
 bidirectionals = ['value', 'checked', 'unchecked', 'selected', 'unselected']
 bidirectionals = ['value', 'checked', 'unchecked', 'selected', 'unselected']
 
 
+# The rivets module. Exposes a single `bind` function.
 rivets =
 rivets =
   bind: (el, adapter, contexts = {}) ->
   bind: (el, adapter, contexts = {}) ->
     for node in el.getElementsByTagName '*'
     for node in el.getElementsByTagName '*'
@@ -62,6 +77,7 @@ rivets =
           keypath = path.join '.'
           keypath = path.join '.'
           registerBinding node, adapter, type, contexts[context], keypath
           registerBinding node, adapter, type, contexts[context], keypath
 
 
+# Exports rivets for both CommonJS and the browser.
 if module?
 if module?
   module.exports = rivets
   module.exports = rivets
 else
 else