Index: modules/system/system.api.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/system/system.api.php,v
retrieving revision 1.228
diff -u -r1.228 system.api.php
--- modules/system/system.api.php	9 Feb 2011 02:26:04 -0000	1.228
+++ modules/system/system.api.php	9 Feb 2011 23:06:22 -0000
@@ -76,6 +76,7 @@
  *     Leave blank to use the DrupalDefaultEntityController implementation.
  *   - base table: (used by DrupalDefaultEntityController) The name of the
  *     entity type's base table.
+ *   - revision table: The name of the entity type's revision table (if any).
  *   - static cache: (used by DrupalDefaultEntityController) FALSE to disable
  *     static caching of entities during a page request. Defaults to TRUE.
  *   - field cache: (used by Field API loading and saving of field data) FALSE
@@ -97,7 +98,8 @@
  *     specify a callback function here, which will be called to determine the
  *     entity label. See also the entity_label() function, which implements this
  *     logic.
- *   - fieldable: Set to TRUE if you want your entity type to be fieldable.
+ *   - fieldable: Set to TRUE if you want your entity type to accept fields
+ *     being attached to it.
  *   - translation: An associative array of modules registered as field
  *     translation handlers. Array keys are the module names, array values
  *     can be any data structure the module uses to provide field translation.