- Patch #1019596 by RoboPhred: field_read_instance() doc says it will not...

- Patch #1019596 by RoboPhred: field_read_instance() doc says it will not return deleted instance, but that is a parameter option.

modules/field/field.crud.inc

@@ -635,12 +635,11 @@ function _field_write_instance($instance, $update = FALSE) {
 }
 
 /**
- * Reads a single instance record directly from the database.
+ * Reads a single instance record from the database.
  *
- * Generally, you should use the field_info_instance() instead.
- *
- * This function will not return deleted instances. Use
- * field_read_instances() instead for this purpose.
+ * Generally, you should use field_info_instance() instead, as it
+ * provides caching and allows other modules the opportunity to
+ * append additional formatters, widgets, and other information.
  *
  * @param $entity_type
  *   The type of entity to which the field is bound.