Documentation incorrect for get_metadata_byname

[dannyl]

It seems that under some conditions the metadata does not update.
See the below code - when we initially increment the metadata it's good. Then when we increment a counter and reset the metadata the update does not happen.

$n = get_metadata_byname($user_guid, 'unread');
$user = get_entity($user_guid);

$user->unread = n =

if (!$n) {

$user->unread = 0;
$n = 0;

$user->unread = 0 n = 0

}
$n += 1;

$user->unread = $n;

$user->unread = 0 n = 1

[dannyl]

I apologize for the crummy formatting of the ticket - my bad. I've attached the sample code

[cash]

(In [svn:7272]) Fixes #2632 - documentation was incorrect for get_metadata_byname - it does not return a metadata value

[cash]

(In [svn:7273]) Refs #2632 - cleaned up documentation on metadata

[dannyl]

Thanks