id	summary	reporter	owner	description	type	status	priority	milestone	component	version	severity	resolution	keywords	cc
21864	PHPDoc incorrect with the return value of add_*_meta functions	mark8barnes		"The PHPDocs for `add_comment_meta`, `add_post_meta` and `add_user_meta` all say that they return `true` on success. In fact, each calls `add_metadata`, which returns the metadata_id on success. 

In addition, `update_metadata` currently returns the metadata_id on success if the metadata did not already exist, but true on success if the metadata did already exist (the PHPDoc says simply that it is true on success).

The patch corrects the documentation, and additionally ensures consistency with the return value for `update_metadata`."	defect (bug)	new	normal	Awaiting Review	Inline Docs	3.4.2	normal		has-patch needs-testing	mark@…