Documentation for user_load() doesn't report the function accepts also a user ID as argument

That's true - and it's a Drupal 6 issue only. Thanks for the report.

This is a good project for a novice Drupal contributor...

Here's a small patch.

That looks good, thanks!

Is it still good then to name the argument $array?

Well, that's a good point. I agree, we should change the argument name to something else besides $array. Perhaps $info or $attributes? That would still constitute a doc patch, as long as only the argument name is changed.

Good point indeed. Here's a new version with a search and replace on $array with $user_info. Credits for the name: jhodgdon ;)

Improved with better wording and a list describing the different possibilities on how to use $user_info.

One of the documentation lines needs to be wrapped at 80 characters.

Otherwise it looks OK.

Fixed.

What's wrong with that phrase?

I'm ready to mark #13 as RTBC, but not until I hear what kiamlaluno has to say about why that line needs changing. :)

@kiamlaluno: tried that before, but would that be valid Doxygen? If the line is needed, what do you suggest that would be a sentence in your view?

@jhodgdon: is this line really necessary? Can't find anything about it at https://drupal.org/node/1354#lists (or I might be blind).

Typically we don't just put a list in without a line (ending in :) right before it, explaining what the list means. In this case, I think the line needs to explain that it's either/or. You could shorten it to "One of these alternatives:" or something like that.

The D6 test bot is choking on every patch. This patch is still fine.

Thanks, committed.