diff --git modules/field/field.crud.inc modules/field/field.crud.inc
index 9bbd644..eb37409 100644
--- modules/field/field.crud.inc
+++ modules/field/field.crud.inc
@@ -31,9 +31,8 @@
  * field_attach_load() then loads the 'subtitle' and 'photo' fields
  * because they are both attached to the 'node' bundle 'article'.
  *
- * Field definitions are represented as an array of key/value pairs.
- *
- * @param array $field:
+ * Field definitions are represented as an array of key/value pairs:
+ * @code
  * - id (integer, read-only)
  *     The primary identifier of the field. It is assigned automatically
  *     by field_create_field().
@@ -101,10 +100,11 @@
  *     - settings (array)
  *         A sub-array of key/value pairs of settings. Each storage backend
  *         defines and documents its own settings.
+ * @endcode
  *
- * Field instance definitions are represented as an array of key/value pairs.
+ * Field instance definitions are represented as an array of key/value pairs:
  *
- * @param array $instance:
+ * @code
  * - id (integer, read-only)
  *     The primary identifier of this field instance. It is assigned
  *     automatically by field_create_instance().
@@ -194,6 +194,7 @@
  *         - ...
  *     - other_mode
  *        - ...
+ * @endcode
  *
  * Bundles are represented by two strings, an entity type and a bundle name.
  */