user_is_blocked returns True for listed and blocked, else false

Thanks for reporting this! Actually, it doesn't look like user_is_blocked() returns a Boolean value at all, in most cases. It returns a stdClass object if the query succeeds, and FALSE (at least in MySQL) if the query fails. This is incorrectly documented in Drupal 7 and 8 also.

By the way, please read the tagging guidelines (below the Tags field when reporting/commenting on an issue), and please don't make up your own tags.

Probably a good Novice project

attached is patch that changes the documentation for the API of user_blocked

Looks good to go

My mistake, wrong issue.

See comment #1 above - this documentation is not accurate.

Also, it doesn't follow our documentation formatting standards:
http://drupal.org/node/1354#functions

Better description which follows formatting standards.

For test bot.

SumeetSingh: Thanks for the patch... A few thoughts:

a) mjonesdinero had assigned the issue to himself, and it had only been a few hours since I reviewed his patch. It would be a bit more polite in the future to ask first "Are you still working on this?" and wait for a few days, before taking over an issue that someone is already working on. Thanks!

b) The formatting in this patch is not correct. Indentation is 2 spaces extra in @param/@return. It looks like you used tabs.

c) In documentation text, we don't normally say "stdClass", and we like to use complete sentences. So instead of this for the @return:

stdClass with the name field of a blocked user, FALSE for active user.

it should probably say:
Object with property 'name' (the user name), if the user is blocked; FALSE if the user is not blocked.

My apologies did not realize, will keep that in mind for future reference.

updated from what jhodgdon commented

sorry for the wrong format earlier

Thanks! One more fix though: Documentation needs to be wrapped into 80-character lines. See
http://drupal.org/node/1354#general
So that @return documentation needs wrapping.

here it is, updated the patch

Almost there... @param and @return descriptions should end with ".":

+ * @param $name
+ *   A string containing a name of the user

here it is...

Thanks! I'll get this committed shortly.

I committed the above patch to 8.x and 7.x. Time to backport to 6.x. :)

here is the patch for drupal 6

That looks correct for Drupal 6.x. Thanks!

Removing novice tag since this just needs a commit now.

Thanks again! Finally got this committed to 6.x.