` with the `selected`
+attribute and an empty `value` attribute. If not present the element will pass
+validation even while being required.
+
+```html
+
+ Select
+
+ Choose an Item
+ 1
+ 2
+ 3
+
+
+```
+
+### Password Fields
+
+When an `` element will have their values set to
+`password-confirm`.
+
+This functionality can be disabled by settting [`passConfirm`](#passConfirm) to `false`.
+
+A *Password* field with the markup of
+
+```html
+
+ Password
+
+```
+
+will generate a *Password Confirm* field with the markup of
+
+```html
+
+ Password Confirm*
+
+```
+
+> The *Password* field is tested that it matches its corresponding
+*Password Confirm* field when the *Password Confirm* field contains a non-blank
+value.
+
` wrapper of the
+invalid field.
+
+### messageClass
+
+**Default:** `invalid__message`
+
+The class assigned output message of the invalid field.
+
+### onlyOnSubmit
+
+**Default:** `false`
+
+Only validate the form on submission. A setting of `true` will disable
+individual field validation. Regardless of this setting fields will always
+validate on the [`valFieldsOn`](#valFieldsOn) value while they are invalid.
+
+### onSuccess
+
+**Default:** `null`
+
+Run a script when the form is submited and all fields pass validation. A non
+truthy value will cancel the form's default action.
+
+```html
+
+```
+
+### passConfirm
+
+**Default:** `true`
+
+Automatically create a confirm password field. The markup from the user created
+field with a `type="password"` attribute will be duplicated and modifed, then
+inserted after the original field.
+
+```html
+
+```
+
+### reqAll
+
+**Default:** `true`
+
+Automatically add a `required` attribute to all ``, and
+`