summaryrefslogtreecommitdiff
path: root/includes
diff options
context:
space:
mode:
Diffstat (limited to 'includes')
-rw-r--r--includes/batch.inc2
-rw-r--r--includes/form.inc18
2 files changed, 10 insertions, 10 deletions
diff --git a/includes/batch.inc b/includes/batch.inc
index 3622c0cb4..1e506abaa 100644
--- a/includes/batch.inc
+++ b/includes/batch.inc
@@ -213,7 +213,7 @@ function _batch_process() {
$set_changed = TRUE;
// If this batch was marked for progressive execution (e.g. forms submitted by
- // drupal_execute()), initialize a timer to determine whether we need to
+ // drupal_form_submit()), initialize a timer to determine whether we need to
// proceed with the same batch phase when a processing time of 1 second has
// been exceeded.
if ($batch['progressive']) {
diff --git a/includes/form.inc b/includes/form.inc
index cf2c36468..7131227b9 100644
--- a/includes/form.inc
+++ b/includes/form.inc
@@ -38,7 +38,7 @@
* @endcode
*
* Forms can also be built and submitted programmatically without any user input
- * using the drupal_execute() function.
+ * using the drupal_form_submit() function.
*
* For information on the format of the structured arrays used to define forms,
* and more detailed explanations of the Form API workflow, see the
@@ -347,7 +347,7 @@ function form_set_cache($form_build_id, $form, $form_state) {
* form submission.
* @param ...
* Any additional arguments are passed on to the functions called by
- * drupal_execute(), including the unique form constructor function.
+ * drupal_form_submit(), including the unique form constructor function.
* For example, the node_edit form requires that a node object be passed
* in here when it is called.
* For example:
@@ -358,7 +358,7 @@ function form_set_cache($form_build_id, $form, $form_state) {
* $form_state['values']['mail'] = 'robouser@example.com';
* $form_state['values']['pass'] = 'password';
* $form_state['values']['op'] = t('Create new account');
- * drupal_execute('user_register', $form_state);
+ * drupal_form_submit('user_register', $form_state);
*
* // Create a new node
* $form_state = array();
@@ -368,9 +368,9 @@ function form_set_cache($form_build_id, $form, $form_state) {
* $form_state['values']['body'] = 'This is the body text!';
* $form_state['values']['name'] = 'robo-user';
* $form_state['values']['op'] = t('Save');
- * drupal_execute('story_node_form', $form_state, (object)$node);
+ * drupal_form_submit('story_node_form', $form_state, (object)$node);
*/
-function drupal_execute($form_id, &$form_state) {
+function drupal_form_submit($form_id, &$form_state) {
if (!isset($form_state['args'])) {
$args = func_get_args();
array_shift($args);
@@ -402,7 +402,7 @@ function drupal_execute($form_id, &$form_state) {
* @param ...
* Any additional arguments needed by the unique form constructor
* function. Generally, these are any arguments passed into the
- * drupal_get_form() or drupal_execute() functions after the first
+ * drupal_get_form() or drupal_form_submit() functions after the first
* argument. If a module implements hook_forms(), it can examine
* these additional arguments and conditionally return different
* builder functions as well.
@@ -511,7 +511,7 @@ function drupal_process_form($form_id, &$form, &$form_state) {
// If batches were set in the submit handlers, we process them now,
// possibly ending execution. We make sure we do not react to the batch
// that is already being processed (if a batch operation performs a
- // drupal_execute).
+ // drupal_form_submit).
if ($batch =& batch_get() && !isset($batch['current_set'])) {
// The batch uses its own copies of $form and $form_state for
// late execution of submit handlers and post-batch redirection.
@@ -529,7 +529,7 @@ function drupal_process_form($form_id, &$form, &$form_state) {
// bundle, and the $form_state['rebuild'] flag has not been set,
// we're finished and should redirect to a new destination page
// if one has been set (and a fresh, unpopulated copy of the form
- // if one hasn't). If the form was called by drupal_execute(),
+ // if one hasn't). If the form was called by drupal_form_submit(),
// however, we'll skip this and let the calling function examine
// the resulting $form_state bundle itself.
if (!$form_state['programmed'] && empty($form_state['rebuild']) && empty($form_state['storage'])) {
@@ -862,7 +862,7 @@ function form_execute_handlers($type, &$form, &$form_state) {
if (drupal_function_exists($function)) {
// Check to see if a previous _submit handler has set a batch, but
// make sure we do not react to a batch that is already being processed
- // (for instance if a batch operation performs a drupal_execute()).
+ // (for instance if a batch operation performs a drupal_form_submit()).
if ($type == 'submit' && ($batch =& batch_get()) && !isset($batch['current_set'])) {
// Some previous _submit handler has set a batch. We store the call
// in a special 'control' batch set, for execution at the correct