summaryrefslogtreecommitdiff
path: root/modules/block/block.admin.inc
diff options
context:
space:
mode:
Diffstat (limited to 'modules/block/block.admin.inc')
-rw-r--r--modules/block/block.admin.inc25
1 files changed, 12 insertions, 13 deletions
diff --git a/modules/block/block.admin.inc b/modules/block/block.admin.inc
index f86fe96b9..bd6179063 100644
--- a/modules/block/block.admin.inc
+++ b/modules/block/block.admin.inc
@@ -57,7 +57,7 @@ function block_admin_display_prepare_blocks($theme) {
}
/**
- * Form builder for the main blocks administration form.
+ * Form constructor for the main block administration form.
*
* @param $blocks
* An array of blocks, as returned by block_admin_display_prepare_blocks().
@@ -165,7 +165,7 @@ function block_admin_display_form($form, &$form_state, $blocks, $theme, $block_r
}
/**
- * Form submission handler for the main blocks administration form.
+ * Form submission handler for block_admin_display_form().
*
* @see block_admin_display_form()
*/
@@ -197,10 +197,9 @@ function block_admin_display_form_submit($form, &$form_state) {
}
/**
- * Helper function for sorting blocks on admin/structure/block.
+ * Sorts active blocks by region, then by weight; sorts inactive blocks by name.
*
- * Active blocks are sorted by region, then by weight.
- * Disabled blocks are sorted by name.
+ * Callback for usort() in block_admin_display_prepare_blocks().
*/
function _block_compare($a, $b) {
global $theme_key;
@@ -240,7 +239,7 @@ function _block_compare($a, $b) {
}
/**
- * Form builder for the block configuration form.
+ * Form constructor for the block configuration form.
*
* Also used by block_add_block_form() for adding a new custom block.
*
@@ -441,7 +440,7 @@ function block_admin_configure($form, &$form_state, $module, $delta) {
}
/**
- * Form validation handler for the block configuration form.
+ * Form validation handler for block_admin_configure().
*
* @see block_admin_configure()
* @see block_admin_configure_submit()
@@ -459,7 +458,7 @@ function block_admin_configure_validate($form, &$form_state) {
}
/**
- * Form submission handler for the block configuration form.
+ * Form submission handler for block_admin_configure().
*
* @see block_admin_configure()
* @see block_admin_configure_validate()
@@ -519,7 +518,7 @@ function block_admin_configure_submit($form, &$form_state) {
}
/**
- * Form builder for the add block form.
+ * Form constructor for the add block form.
*
* @see block_add_block_form_validate()
* @see block_add_block_form_submit()
@@ -530,7 +529,7 @@ function block_add_block_form($form, &$form_state) {
}
/**
- * Form validation handler for the add block form.
+ * Form validation handler for block_add_block_form().
*
* @see block_add_block_form()
* @see block_add_block_form_submit()
@@ -544,7 +543,7 @@ function block_add_block_form_validate($form, &$form_state) {
}
/**
- * Form submission handler for the add block form.
+ * Form submission handler for block_add_block_form().
*
* Saves the new custom block.
*
@@ -609,7 +608,7 @@ function block_add_block_form_submit($form, &$form_state) {
}
/**
- * Form builder for the custom block deletion form.
+ * Form constructor for the custom block deletion form.
*
* @param $module
* The name of the module that implements the block to be deleted. This should
@@ -629,7 +628,7 @@ function block_custom_block_delete($form, &$form_state, $module, $delta) {
}
/**
- * Form submission handler for the custom block deletion form.
+ * Form submission handler for block_custom_block_delete().
*
* @see block_custom_block_delete()
*/