Index: includes/webform.submissions.inc
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/webform/includes/webform.submissions.inc,v
retrieving revision 1.18.2.15
diff -u -r1.18.2.15 webform.submissions.inc
--- includes/webform.submissions.inc	7 Feb 2011 03:51:19 -0000	1.18.2.15
+++ includes/webform.submissions.inc	16 Feb 2011 23:45:28 -0000
@@ -11,6 +11,13 @@
 
 /**
  * Given an array of submitted values, flatten it into data for a submission.
+ *
+ * @param $node
+ *   The node object containing the current webform.
+ * @param $submitted
+ *   The submitted user values from the webform.
+ * @return
+ *   An array suitable for use in the 'data' property of a $submission object.
  */
 function webform_submission_data($node, $submitted) {
   $data = array();
@@ -32,6 +39,16 @@
   return $data;
 }
 
+/**
+ * Update a webform submission entry in the database.
+ *
+ * @param $node
+ *   The node object containing the current webform.
+ * @param $submission
+ *   The webform submission object to be saved into the database.
+ * @return
+ *   The existing submission SID.
+ */
 function webform_submission_update($node, $submission) {
   // Allow other modules to modify the submission before saving.
   foreach (module_implements('webform_submission_presave') as $module) {
@@ -65,6 +82,16 @@
   return $submission->sid;
 }
 
+/**
+ * Insert a webform submission entry in the database.
+ *
+ * @param $node
+ *   The node object containing the current webform.
+ * @param $submission
+ *   The webform submission object to be saved into the database.
+ * @return
+ *   The new submission SID.
+ */
 function webform_submission_insert($node, $submission) {
   // The submission ID may already be set if being called as an update.
   if (!isset($submission->sid) && (!isset($submission->is_new) || $submission->is_new == FALSE)) {