Index: modules/block/block.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/block/block.module,v
retrieving revision 1.362
diff -u -p -r1.362 block.module
--- modules/block/block.module	23 Aug 2009 01:05:10 -0000	1.362
+++ modules/block/block.module	23 Aug 2009 09:55:28 -0000
@@ -369,6 +369,14 @@ function _block_rehash() {
   return $blocks;
 }
 
+/**
+ * Get a box with a certain ID.
+ *
+ * @param $bid
+ *   The ID of the box to return.
+ * @return
+ *   The box.
+ */
 function block_box_get($bid) {
   return db_query("SELECT * FROM {box} WHERE bid = :bid", array(':bid' => $bid))->fetchAssoc();
 }
@@ -406,6 +414,16 @@ function block_box_form($edit = array())
   return $form;
 }
 
+/**
+ * Save a box with a certain ID.
+ *
+ * @param $edit
+ *   Values of the fields body, info and body_format for this box.
+ * @param $delta
+ *   The ID (block delta) of the box to save.
+ * @return
+ *   TRUE.
+ */
 function block_box_save($edit, $delta) {
   db_update('box')
     ->fields(array(