Index: payment/uc_payment/uc_payment.module
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/ubercart/payment/uc_payment/uc_payment.module,v
retrieving revision 1.5.2.10
diff -u -p -r1.5.2.10 uc_payment.module
--- payment/uc_payment/uc_payment.module	18 Apr 2009 07:29:16 -0000	1.5.2.10
+++ payment/uc_payment/uc_payment.module	4 Aug 2009 22:24:30 -0000
@@ -653,7 +653,14 @@ function uc_payment_load($receipt_id) {
 }
 
 /**
- * Load an array of all the payments for order $order_id.
+ * Load an array of all the payments for an order.
+ *
+ * @param $order_id
+ *   The order's id.
+ * @param $action
+ *   Unused...
+ * @return
+ *   Array of payment objects or FALSE if there are none.
  */
 function uc_payment_load_payments($order_id, $action = NULL) {
   $payments = array();
Index: uc_order/uc_order.module
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/ubercart/uc_order/uc_order.module,v
retrieving revision 1.12.2.24
diff -u -p -r1.12.2.24 uc_order.module
--- uc_order/uc_order.module	7 May 2009 20:52:30 -0000	1.12.2.24
+++ uc_order/uc_order.module	4 Aug 2009 22:24:31 -0000
@@ -1302,9 +1302,12 @@ function uc_order_update_status($order_i
  * @param $order_id
  *   The ID of the order that was changed.
  * @param $changes
- *   An array of changes with the keys being the name of the field changed and
- *     the values being associative arrays with the keys 'old' and 'new' to
- *     represent the old and new values of the field.
+ *   An array of changes. Two formats are allowed:
+ *   - Keys being the name of the field changed and the values being associative
+ *     arrays with the keys 'old' and 'new' to represent the old and new values
+ *     of the field. These will be converted into a changed message.
+ *   - A pre-formatted string describing the change. This is useful for
+ *     logging details like payments.
  * @return
  *   TRUE or FALSE depending on whether or not changes were logged.
  */
@@ -1333,7 +1336,10 @@ function uc_order_log_changes($order_id,
 /**
  * Return an address from an order object.
  *
- * $type = delivery | billing
+ * @param $order
+ *   An order object.
+ * @param $type
+ *   Either 'delivery' or 'billing'.
  */
 function uc_order_address($order, $type) {
   $name = $order->{$type .'_first_name'} .' '. $order->{$type .'_last_name'};