diff --git a/forms/FormField.php b/forms/FormField.php
index 4325036c0..f656b2024 100644
--- a/forms/FormField.php
+++ b/forms/FormField.php
@@ -1103,7 +1103,7 @@ class FormField extends RequestHandler {
*
* The field type is the class name with the word Field dropped off the end, all lowercase.
*
- * It's handy for assigning HTML classes. Doesn't signify the attribute.
+ * It's handy for assigning HTML classes. Doesn't signify the input type attribute.
*
* @see {link getAttributes()}.
*
@@ -1145,7 +1145,7 @@ class FormField extends RequestHandler {
/**
* Describe this field, provide help text for it.
*
- * By default, renders as a underneath the form field.
+ * By default, renders as a span class="description" underneath the form field.
*
* @param string $description
*
diff --git a/forms/GroupedDropdownField.php b/forms/GroupedDropdownField.php
index 2d30956e5..8bd0d986d 100644
--- a/forms/GroupedDropdownField.php
+++ b/forms/GroupedDropdownField.php
@@ -1,13 +1,13 @@
tags.
+ * Grouped dropdown, using optgroup tags.
*
* $source parameter (from DropdownField) must be a two dimensional array.
- * The first level of the array is used for the