Message:
I've moved the redundant method into a new file "OpenSocial Deprecated
JavaScript API", and added links to the osapi methods that replace them.

I captured a few issues here:
http://wiki.opensocial.org/index.php?title=Deprecate_redundant_openso...

Still a fair amount of work to do on this patch, but wanted to get some
high-level input before going further.

Open Question:  Should I rename this new file to be the "OpenSocial
JavaScript API" and move the rest of the osapi.* and opensocial.*
methods under the same roof?

I'm leaning toward this because 1) the "OpenSocial Specification" file
can then be soley focused on defining compliance and extensions and 2)
IMO, xrefs are better than erefs (but I don't feel strongly).  Thoughts?

-Lane

Please review this at http://codereview.appspot.com/144082