Issue #1393234 by dww: Fixed API docs for field_access() are confusing.

core/modules/field/field.module

@@ -975,18 +975,20 @@ function field_has_data($field) {
 /**
  * Determine whether the user has access to a given field.
  *
- * @param $op
+ * @param string $op
  *   The operation to be performed. Possible values:
- *   - "edit"
- *   - "view"
- * @param $field
- *   The field on which the operation is to be performed.
- * @param $entity_type
+ *   - 'edit'
+ *   - 'view'
+ * @param array $field
+ *   The full field structure array for the field on which the operation is to
+ *   be performed. See field_info_field().
+ * @param string $entity_type
  *   The type of $entity; e.g., 'node' or 'user'.
  * @param $entity
  *   (optional) The entity for the operation.
  * @param $account
  *   (optional) The account to check, if not given use currently logged in user.
+ *
  * @return
  *   TRUE if the operation is allowed;
  *   FALSE if the operation is denied.