Index: includes/actions.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/actions.inc,v
retrieving revision 1.29
diff -u -p -r1.29 actions.inc
--- includes/actions.inc	20 Jul 2009 18:51:31 -0000	1.29
+++ includes/actions.inc	5 Aug 2009 00:13:31 -0000
@@ -167,10 +167,13 @@ function actions_list($reset = FALSE) {
 /**
  * Retrieve all action instances from the database.
  *
- * Compare with actions_list() which gathers actions by invoking
- * hook_action_info(). The two are synchronized by visiting
- * /admin/structure/actions (when actions.module is enabled) which runs
- * actions_synchronize().
+ * The actions have two type configurable and non-configurable.
+ * The non-configurable action will get into the database when
+ * /admin/settings/actions is visited. This runs actions_synchronize().
+ * The configurable action will get into the database when user sets up
+ * ones. Each and every configuration creates a new row in the database.
+ * If you need all type of actions use actions_list() which gathers actions
+ * by invoking hook_action_info().
  *
  * @return
  *   Associative array keyed by action ID. Each value is an associative array