API Documentation is wrong

The API http://drupal.org/node/369399 says privatemsg_new_thread is as follows:

boolean|array privatemsg_new_thread (string $subject, string $body, array $recipients, [object $author = NULL])
    * string $subject: The subject of the new message
    * string $body: The body text of the new message
    * array $recipients: Array of recipients (user objects)
    * object $author: The author (user object, defaults to the current user)

    * return: Either true or an array with validation errors

But in the latest code it is as follows:

function privatemsg_new_thread($recipients, $subject, $body = NULL, $options = array()) {

The API doc is a bit self-preserving and says features listed may not yet be implemented, so I didn't want to mess with it yet. Besides, other aspects I'm not dealing with may be wrong too. This was relevant because I am helping Jose with messaging and this issue came up http://drupal.org/node/464002 . The messaging_privatemsg module had been based on the incorrect API which apparently gave users errors. I've posted a potential patch there, so as long as the code remains the same and the API is updated it should be fine...