Index: privatemsg.module
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/privatemsg/privatemsg.module,v
retrieving revision 1.70.2.30.2.91.2.44
diff -u -r1.70.2.30.2.91.2.44 privatemsg.module
--- privatemsg.module	26 Apr 2009 22:16:08 -0000	1.70.2.30.2.91.2.44
+++ privatemsg.module	13 May 2009 20:08:50 -0000
@@ -1125,7 +1125,7 @@
  * This functions does send a message in a new thread.
  * Example:
  * @code
- * privatemsg_new_thread('The subject', 'The body text', array(user_load(5)));
+ * privatemsg_new_thread(array(user_load(5)), 'The subject', 'The body text');
  * @endcode
  *
  * @param $recipients
@@ -1153,11 +1153,11 @@
   $message['body'] = $body;
   $message['recipients'] = $recipients;
 
-  // set custom options, if any
+  // Set custom options, if any.
   if (!empty($options)) {
     $message += $options;
   }
-  // apply defaults
+  // Apply defaults - this will not overwrite existing keys.
   $message += array(
     'author' => $author,
     'timestamp' => time(),