You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@shindig.apache.org by li...@apache.org on 2010/11/10 10:59:36 UTC

svn commit: r1033405 - /shindig/trunk/features/src/main/javascript/features/opensocial-reference/

Author: lindner
Date: Wed Nov 10 09:59:35 2010
New Revision: 1033405

URL: http://svn.apache.org/viewvc?rev=1033405&view=rev
Log:
add opensocial 1.0 deprecations

Modified:
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/activity.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/address.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/album.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/bodytype.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/collection.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/datarequest.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/dataresponse.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/email.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/enum.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/idspec.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/mediaitem.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/message.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/messagecollection.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/name.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/opensocial.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/organization.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/person.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/phone.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/responseitem.js
    shindig/trunk/features/src/main/javascript/features/opensocial-reference/url.js

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/activity.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/activity.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/activity.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/activity.js Wed Nov 10 09:59:35 2010
@@ -149,6 +149,7 @@
  * @param {Object.<opensocial.Activity.Field, Object>} params Parameters defining the activity.
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.2
  */
 opensocial.Activity = function(params) {
   this.fields_ = params;
@@ -179,6 +180,7 @@ opensocial.Activity = function(params) {
  *
  * @name opensocial.Activity.Field
  * @enum {string}
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.3
  */
 opensocial.Activity.Field = {
   /**
@@ -340,6 +342,7 @@ opensocial.Activity.Field = {
  *
  * @return {string} The ID.
  * @member opensocial.Activity
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.2.1.2
  */
 opensocial.Activity.prototype.getId = function() {
   return this.getField(opensocial.Activity.Field.ID);
@@ -358,6 +361,7 @@ opensocial.Activity.prototype.getId = fu
  *    to pass to the request.
  * @return {string} The data.
  * @member opensocial.Activity
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.2.1.1
  */
 opensocial.Activity.prototype.getField = function(key, opt_params) {
   return opensocial.Container.getField(this.fields_, key, opt_params);
@@ -369,6 +373,7 @@ opensocial.Activity.prototype.getField =
  *
  * @param {string} key The key to set data for.
  * @param {string} data The data to set.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.2.1.3
  */
 opensocial.Activity.prototype.setField = function(key, data) {
   return (this.fields_[key] = data);

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/address.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/address.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/address.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/address.js Wed Nov 10 09:59:35 2010
@@ -37,6 +37,7 @@
  *
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.4
  */
 opensocial.Address = function(opt_params) {
   this.fields_ = opt_params || {};
@@ -50,6 +51,7 @@ opensocial.Address = function(opt_params
  * <a href="opensocial.Address.html#getField">Address.getField()</a> method.
  *
  * @name opensocial.Address.Field
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.5
  */
 opensocial.Address.Field = {
   /**
@@ -146,6 +148,7 @@ opensocial.Address.Field = {
  *    <a href="opensocial.DataRequest.DataRequestFields.html">params</a>
  *    to pass to the request.
  * @return {string} The data.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.4.1.1
  */
 opensocial.Address.prototype.getField = function(key, opt_params) {
   return opensocial.Container.getField(this.fields_, key, opt_params);

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/album.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/album.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/album.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/album.js Wed Nov 10 09:59:35 2010
@@ -40,6 +40,7 @@
  *    All of the defined Fields are supported.
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.6
  */
 opensocial.Album = function(opt_params) {
   this.fields_ = opt_params || {};
@@ -51,6 +52,7 @@ opensocial.Album = function(opt_params) 
  * All of the fields that an Album can have.
  *
  * @name opensocial.Album.Field
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.7
  */
 opensocial.Album.Field = {
   /**
@@ -132,6 +134,7 @@ opensocial.Album.Field = {
  *    to pass to the request.
  * @return {string} The data.
  * @member opensocial.Album
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.6.1.1
  */
 opensocial.Album.prototype.getField = function(key, opt_params) {
   return opensocial.Container.getField(this.fields_, key, opt_params);
@@ -143,6 +146,7 @@ opensocial.Album.prototype.getField = fu
  *
  * @param {string} key The key to set data for.
  * @param {string} data The data to set.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.6.1.2
  */
 opensocial.Album.prototype.setField = function(key, data) {
   return this.fields_[key] = data;

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/bodytype.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/bodytype.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/bodytype.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/bodytype.js Wed Nov 10 09:59:35 2010
@@ -37,6 +37,7 @@
  *
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.8
  */
 opensocial.BodyType = function(opt_params) {
   this.fields_ = opt_params || {};
@@ -51,6 +52,7 @@ opensocial.BodyType = function(opt_param
  * method.
  *
  * @name opensocial.BodyType.Field
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.9
  */
 opensocial.BodyType.Field = {
   /**
@@ -101,6 +103,7 @@ opensocial.BodyType.Field = {
  *    <a href="opensocial.DataRequest.DataRequestFields.html">params</a>
  *    to pass to the request.
  * @return {string} The data.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.8.1.1
  */
 opensocial.BodyType.prototype.getField = function(key, opt_params) {
   return opensocial.Container.getField(this.fields_, key, opt_params);

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/collection.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/collection.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/collection.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/collection.js Wed Nov 10 09:59:35 2010
@@ -46,6 +46,7 @@
  * @param {Array} array
  * @param {number=} opt_offset
  * @param {number=} opt_totalSize
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.10
  */
 opensocial.Collection = function(array, opt_offset, opt_totalSize) {
   this.array_ = array || [];
@@ -58,6 +59,7 @@ opensocial.Collection = function(array, 
  * Finds the entry with the given ID value, or returns null if none is found.
  * @param {string} id The ID to look for.
  * @return {?Object} The data.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.10.1.3
  */
 opensocial.Collection.prototype.getById = function(id) {
   // TODO(doll): A non-linear search would be better
@@ -78,6 +80,7 @@ opensocial.Collection.prototype.getById 
  * total size of the result.
  *
  * @return {number} The size of this collection.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.10.1.6
  */
 opensocial.Collection.prototype.size = function() {
   return this.array_.length;
@@ -90,6 +93,7 @@ opensocial.Collection.prototype.size = f
  * parameter to the function.
  *
  * @param {function(Object)} fn The function to call with each collection entry.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.10.1.2
  */
 opensocial.Collection.prototype.each = function(fn) {
   for (var i = 0; i < this.size(); i++) {
@@ -101,6 +105,7 @@ opensocial.Collection.prototype.each = f
 /**
  * Returns an array of all the objects in this collection.
  * @return {Array.<Object>} The values in this collection.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.10.1.1
  */
 opensocial.Collection.prototype.asArray = function() {
   return this.array_;
@@ -111,6 +116,7 @@ opensocial.Collection.prototype.asArray 
  * Gets the total size of the larger result set
  * that this collection belongs to.
  * @return {number} The total size of the result.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.10.1.5
  */
 opensocial.Collection.prototype.getTotalSize = function() {
   return this.totalSize_;
@@ -120,6 +126,7 @@ opensocial.Collection.prototype.getTotal
 /**
  * Gets the offset of this collection within a larger result set.
  * @return {number} The offset into the total collection.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.10.1.4
  */
 opensocial.Collection.prototype.getOffset = function() {
   return this.offset_;

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/datarequest.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/datarequest.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/datarequest.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/datarequest.js Wed Nov 10 09:59:35 2010
@@ -75,6 +75,7 @@ function handleRequestMe(data) {
  *
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12
  */
 opensocial.DataRequest = function() {
   this.requestObjects_ = [];
@@ -112,6 +113,7 @@ opensocial.DataRequest.prototype.getRequ
  *
  * @param {Object} request Specifies which data to fetch or update.
  * @param {string} opt_key A key to map the generated response data to.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12.1.1
  */
 opensocial.DataRequest.prototype.add = function(request, opt_key) {
   return this.requestObjects_.push({'key': opt_key, 'request': request});
@@ -127,6 +129,7 @@ opensocial.DataRequest.prototype.add = f
  * @param {function(opensocial.ResponseItem)=} opt_callback The function to call with the
  *   <a href="opensocial.DataResponse.html">data response</a>
  *    generated by the server.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12.1.2
  */
 opensocial.DataRequest.prototype.send = function(opt_callback) {
   var callback = opt_callback || function() {};
@@ -140,6 +143,7 @@ opensocial.DataRequest.prototype.send = 
  * The sort orders available for ordering person objects.
  *
  * @name opensocial.DataRequest.SortOrder
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.19
  */
 opensocial.DataRequest.SortOrder = {
   /**
@@ -162,6 +166,7 @@ opensocial.DataRequest.SortOrder = {
  * The filters available for limiting person requests.
  *
  * @name opensocial.DataRequest.FilterType
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.16
  */
 opensocial.DataRequest.FilterType = {
   /**
@@ -198,6 +203,7 @@ opensocial.DataRequest.FilterType = {
  * @class
  * @name opensocial.DataRequest.PeopleRequestFields
  * @enum {string}
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.18
  */
 opensocial.DataRequest.PeopleRequestFields = {
   /**
@@ -326,6 +332,7 @@ opensocial.DataRequest.prototype.asArray
  *   to create an album for.
  * @param {opensocial.Album} album The album to create.
  * @return {Object} A request object.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12.1.2
  */
 opensocial.DataRequest.prototype.newCreateAlbumRequest = function(idSpec, album) {
   return opensocial.Container.get().newCreateAlbumRequest(idSpec, album);
@@ -339,6 +346,7 @@ opensocial.DataRequest.prototype.newCrea
  * @param {string} albumId The ID of album to add the media item to.
  * @param {openSocial.MediaItem} mediaItem The MediaItem to add to the album.
  * @return {Object} A request object.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12.1.3
  */
 opensocial.DataRequest.prototype.newCreateMediaItemRequest = function(idSpec, albumId,
     mediaItem) {
@@ -352,6 +360,7 @@ opensocial.DataRequest.prototype.newCrea
  *   to create an album for.
  * @param {string} albumId The ID of the album to create.
  * @return {Object} A request object.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12.1.4
  */
 opensocial.DataRequest.prototype.newDeleteAlbumRequest = function(idSpec, albumId) {
   return opensocial.Container.get().newDeleteAlbumRequest(idSpec, albumId);
@@ -370,6 +379,7 @@ opensocial.DataRequest.prototype.newDele
  *    <a href="opensocial.DataRequest.PeopleRequestFields.html">parameters</a>
  *    to pass to the request; this request supports PROFILE_DETAILS.
  * @return {Object} A request object.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12.1.10
  */
 opensocial.DataRequest.prototype.newFetchPersonRequest = function(id,
     opt_params) {
@@ -392,6 +402,7 @@ opensocial.DataRequest.prototype.newFetc
  *    <a href="opensocial.DataRequest.PeopleRequestFields.html">params</a>
  *    to pass to the request.
  * @return {Object} A request object.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12.1.8
  */
 opensocial.DataRequest.prototype.newFetchPeopleRequest = function(idSpec,
     opt_params) {
@@ -419,6 +430,7 @@ opensocial.DataRequest.prototype.newFetc
  * @class
  * @name opensocial.DataRequest.AlbumRequestFields
  * @enum {string}
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.14
  */
 opensocial.DataRequest.AlbumRequestFields = {
   /**
@@ -443,6 +455,7 @@ opensocial.DataRequest.AlbumRequestField
  * @class
  * @name opensocial.DataRequest.MediaItemRequestFields
  * @enum {string}
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.17
  */
 opensocial.DataRequest.MediaItemRequestFields = {
   /**
@@ -467,6 +480,7 @@ opensocial.DataRequest.MediaItemRequestF
  * @class
  * @name opensocial.DataRequest.DataRequestFields
  * @enum {string}
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.15
  */
 opensocial.DataRequest.DataRequestFields = {
   /**
@@ -505,6 +519,7 @@ opensocial.DataRequest.DataRequestFields
  *    <a href="opensocial.DataRequest.DataRequestFields.html">params</a>
  *    to pass to the request.
  * @return {Object} A request object.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12.1.9
  */
 opensocial.DataRequest.prototype.newFetchPersonAppDataRequest = function(idSpec,
     keys, opt_params) {
@@ -521,6 +536,7 @@ opensocial.DataRequest.prototype.newFetc
  * @param {string} albumId The ID of album to update.
  * @param {Object.<opensocial.Album.Field, Object>=} opt_params The Album Fields to update.
  * @return {Object} A request object.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12.1.12
  */
 opensocial.DataRequest.prototype.newUpdateAlbumRequest = function(idSpec, albumId,
     opt_params) {
@@ -537,6 +553,7 @@ opensocial.DataRequest.prototype.newUpda
  * @param {string} mediaItemId ID of media item to update.
  * @param {Object.<opensocial.MediaItem.Field, Object>=} opt_params The Album Fields to update.
  * @return {Object} A request object.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12.1.12
  */
 opensocial.DataRequest.prototype.newUpdateMediaItemRequest = function(idSpec, albumId,
     mediaItemId, opt_params) {
@@ -554,6 +571,7 @@ opensocial.DataRequest.prototype.newUpda
  *     (A-Za-z0-9) characters, underscore(_), dot(.) or dash(-).
  * @param {string} value The value, must be valid json.
  * @return {Object} A request object.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12.1.14
  */
 opensocial.DataRequest.prototype.newUpdatePersonAppDataRequest = function(
     key, value) {
@@ -570,6 +588,7 @@ opensocial.DataRequest.prototype.newUpda
  *     the datastore; this can be an array of key names, a single key name,
  *     or "*" to mean "all keys".
  * @return {Object} A request object.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12.1.11
  */
 opensocial.DataRequest.prototype.newRemovePersonAppDataRequest = function(keys) {
   return opensocial.Container.get().newRemovePersonAppDataRequest(keys);
@@ -585,6 +604,7 @@ opensocial.DataRequest.prototype.newRemo
  * @name opensocial.DataRequest.ActivityRequestFields
  * @private
  * @enum {string}
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.13
  */
 opensocial.DataRequest.ActivityRequestFields = {
   /**
@@ -625,6 +645,7 @@ opensocial.DataRequest.ActivityRequestFi
  *    Additional parameters
  *    to pass to the request; not currently used.
  * @return {Object} A request object.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12.1.5
  */
 opensocial.DataRequest.prototype.newFetchActivitiesRequest = function(idSpec,
     opt_params) {
@@ -645,6 +666,7 @@ opensocial.DataRequest.prototype.newFetc
  * @param {opensocial.IdSpec} idSpec An IdSpec used to specify which albums to fetch.
  * @param {Object.<Object, Object>=} opt_params Additional parameters to pass to the request.
  * @return {Object} A request object.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12.1.6
  */
 opensocial.DataRequest.prototype.newFetchAlbumsRequest = function(idSpec, opt_params) {
   opt_params = opt_params || {};
@@ -666,6 +688,7 @@ opensocial.DataRequest.prototype.newFetc
  *          albumId The id of the album to fetch media items from.
  * @param {Object.<Object, Object>=} opt_params Additional parameters to pass to the request.
  * @return {Object} A request object.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.12.1.7
  */
 opensocial.DataRequest.prototype.newFetchMediaItemsRequest = function(idSpec, albumId, opt_params) {
   opt_params = opt_params || {};

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/dataresponse.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/dataresponse.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/dataresponse.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/dataresponse.js Wed Nov 10 09:59:35 2010
@@ -53,6 +53,7 @@
  *
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.20
  */
 opensocial.DataResponse = function(responseItems, opt_globalError,
     opt_errorMessage) {
@@ -67,6 +68,7 @@ opensocial.DataResponse = function(respo
  *
  * @return {boolean} True if there was an error; otherwise, false.
  * @member opensocial.DataResponse
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.20.1.3
  */
 opensocial.DataResponse.prototype.hadError = function() {
   return !!this.globalError_;
@@ -77,6 +79,7 @@ opensocial.DataResponse.prototype.hadErr
  * If the entire request had a batch level error, returns the error message.
  *
  * @return {string} A human-readable description of the error that occurred.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.20.1.2
  */
 opensocial.DataResponse.prototype.getErrorMessage = function() {
   return this.errorMessage_;
@@ -90,6 +93,7 @@ opensocial.DataResponse.prototype.getErr
  *    <a href="opensocial.ResponseItem.html">response</a> calculated by the
  *    server.
  * @member opensocial.DataResponse
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.20.1.1
  */
 opensocial.DataResponse.prototype.get = function(key) {
   return this.responseItems_[key];

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/email.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/email.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/email.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/email.js Wed Nov 10 09:59:35 2010
@@ -37,6 +37,7 @@
  *
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.21
  */
 opensocial.Email = function(opt_params) {
   this.fields_ = opt_params || {};
@@ -50,6 +51,7 @@ opensocial.Email = function(opt_params) 
  * <a href="opensocial.Email.html#getField">Email.getField()</a> method.
  *
  * @name opensocial.Email.Field
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.22
  */
 opensocial.Email.Field = {
   /**
@@ -80,6 +82,7 @@ opensocial.Email.Field = {
  *    <a href="opensocial.DataRequest.DataRequestFields.html">params</a>
  *    to pass to the request.
  * @return {string} The data.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.21.1.1
  */
 opensocial.Email.prototype.getField = function(key, opt_params) {
   return opensocial.Container.getField(this.fields_, key, opt_params);

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/enum.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/enum.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/enum.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/enum.js Wed Nov 10 09:59:35 2010
@@ -67,6 +67,7 @@
  *
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.23
  */
 opensocial.Enum = function(key, displayValue) {
   this.key = key;
@@ -80,6 +81,7 @@ opensocial.Enum = function(key, displayV
  *
  * @return {string} The enum's key. This should be one of the defined enums
  *     below.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.23.1.2
  */
 opensocial.Enum.prototype.getKey = function() {
   return gadgets.util.escape(this.key);
@@ -91,6 +93,7 @@ opensocial.Enum.prototype.getKey = funct
  * container supports localization, the string will be localized.
  *
  * @return {string} The enum's value.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.23.1.1
  */
 opensocial.Enum.prototype.getDisplayValue = function() {
   return gadgets.util.escape(this.displayValue);
@@ -107,6 +110,7 @@ opensocial.Enum.prototype.getDisplayValu
  * </p>
  *
  * @name opensocial.Enum.Smoker
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.28
  */
 opensocial.Enum.Smoker = {
   /** @member opensocial.Enum.Smoker */
@@ -138,6 +142,7 @@ opensocial.Enum.Smoker = {
  * </p>
  *
  * @name opensocial.Enum.Drinker
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.24
  */
 opensocial.Enum.Drinker = {
   /** @member opensocial.Enum.Drinker */
@@ -169,6 +174,7 @@ opensocial.Enum.Drinker = {
  * </p>
  *
  * @name opensocial.Enum.Gender
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.25
  */
 opensocial.Enum.Gender = {
   /** @member opensocial.Enum.Gender */
@@ -188,6 +194,7 @@ opensocial.Enum.Gender = {
  * </p>
  *
  * @name opensocial.Enum.LookingFor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.26
  */
 opensocial.Enum.LookingFor = {
   /** @member opensocial.Enum.LookingFor */
@@ -215,6 +222,7 @@ opensocial.Enum.LookingFor = {
  * </p>
  *
  * @name opensocial.Enum.Presence
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.27
  */
 opensocial.Enum.Presence = {
   /** @member opensocial.Enum.Presence */

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/idspec.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/idspec.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/idspec.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/idspec.js Wed Nov 10 09:59:35 2010
@@ -48,6 +48,7 @@
  *
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.30
  */
 opensocial.IdSpec = function(opt_params) {
   this.fields_ = opt_params || {};
@@ -66,6 +67,7 @@ opensocial.IdSpec = function(opt_params)
  * </p>
  *
  * @name opensocial.IdSpec.Field
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.31
  */
 opensocial.IdSpec.Field = {
   /**
@@ -103,6 +105,7 @@ opensocial.IdSpec.Field = {
  * Constant person IDs available when fetching person information.
  *
  * @name opensocial.IdSpec.PersonId
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.33
  */
 opensocial.IdSpec.PersonId = {
   /**
@@ -122,6 +125,7 @@ opensocial.IdSpec.PersonId = {
  * Constant group IDs available when fetching collections of people.
  *
  * @name opensocial.IdSpec.GroupId
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.32
  */
 opensocial.IdSpec.GroupId = {
   /**
@@ -151,6 +155,7 @@ opensocial.IdSpec.GroupId = {
  *    to pass to the request.
  * @return {string} The data.
  * @member opensocial.IdSpec
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.30.1.1
  */
 opensocial.IdSpec.prototype.getField = function(key, opt_params) {
   return opensocial.Container.getField(this.fields_, key, opt_params);
@@ -162,6 +167,7 @@ opensocial.IdSpec.prototype.getField = f
  *
  * @param {string} key The key to set data for.
  * @param {string} data The data to set.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.30.1.2
  */
 opensocial.IdSpec.prototype.setField = function(key, data) {
   return (this.fields_[key] = data);

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/mediaitem.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/mediaitem.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/mediaitem.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/mediaitem.js Wed Nov 10 09:59:35 2010
@@ -39,6 +39,7 @@
  *    All of the defined Fields are supported.
  * @constructor
  * @private
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.34
  */
 opensocial.MediaItem = function(mimeType, url, opt_params) {
   this.fields_ = {};
@@ -68,6 +69,7 @@ opensocial.MediaItem = function(mimeType
  * @name opensocial.MediaItem.Type
  * @enum {string}
  * @const
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.36
  */
 opensocial.MediaItem.Type = {
   /** @member opensocial.MediaItem.Type */
@@ -91,6 +93,7 @@ opensocial.MediaItem.Type = {
  * </p>
  *
  * @name opensocial.MediaItem.Field
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.35
  */
 opensocial.MediaItem.Field = {
 
@@ -232,6 +235,7 @@ opensocial.MediaItem.Field = {
  *   <a href="opensocial.MediaItem.Field.html">Field</a> class
  *   for possible values.
  * @return {string} The data.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.34.1.1
  */
 opensocial.MediaItem.prototype.getField = function(key, opt_params) {
   return opensocial.Container.getField(this.fields_, key, opt_params);
@@ -243,6 +247,7 @@ opensocial.MediaItem.prototype.getField 
  *
  * @param {string} key The key to set data for.
  * @param {string} data The data to set.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.34.1.2
  */
 opensocial.MediaItem.prototype.setField = function(key, data) {
   return (this.fields_[key] = data);

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/message.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/message.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/message.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/message.js Wed Nov 10 09:59:35 2010
@@ -47,6 +47,7 @@
  *    Fields are supported.
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.37
  */
 opensocial.Message = function(body_or_params, opt_params) {
   if (typeof body_or_params == 'string') {
@@ -73,6 +74,7 @@ opensocial.Message = function(body_or_pa
  * @name opensocial.Message.Field
  * @enum {string}
  * @const
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.38
  */
 opensocial.Message.Field = {
   /**
@@ -246,6 +248,7 @@ opensocial.Message.Status = {
  *    to pass to the request.
  * @return {string} The data.
  * @member opensocial.Message
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.37.1.1
  */
 opensocial.Message.prototype.getField = function(key, opt_params) {
   return opensocial.Container.getField(this.fields_, key, opt_params);
@@ -257,6 +260,7 @@ opensocial.Message.prototype.getField = 
  *
  * @param {string} key The key to set data for.
  * @param {string} data The data to set.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.37.1.2
  */
 opensocial.Message.prototype.setField = function(key, data) {
   return (this.fields_[key] = data);

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/messagecollection.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/messagecollection.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/messagecollection.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/messagecollection.js Wed Nov 10 09:59:35 2010
@@ -40,6 +40,7 @@
  *    Fields are supported.
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.39
  */
 opensocial.MessageCollection = function(opt_params) {
   this.fields_ = opt_params || {};
@@ -58,6 +59,7 @@ opensocial.MessageCollection = function(
  * </p>
  *
  * @name opensocial.MessageCollection.Field
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.40
  */
 opensocial.MessageCollection.Field = {
   /**
@@ -110,6 +112,7 @@ opensocial.MessageCollection.Field = {
  *    to pass to the request.
  * @return {string} The data.
  * @member opensocial.MessageCollection
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.39.1.1
  */
 opensocial.MessageCollection.prototype.getField = function(key, opt_params) {
   return opensocial.Container.getField(this.fields_, key, opt_params);
@@ -121,6 +124,7 @@ opensocial.MessageCollection.prototype.g
  *
  * @param {string} key The key to set data for.
  * @param {string} data The data to set.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.39.1.2
  */
 opensocial.MessageCollection.prototype.setField = function(key, data) {
   return this.fields_[key] = data;

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/name.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/name.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/name.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/name.js Wed Nov 10 09:59:35 2010
@@ -37,6 +37,7 @@
  *
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.41
  */
 opensocial.Name = function(opt_params) {
   this.fields_ = opt_params || {};
@@ -50,6 +51,7 @@ opensocial.Name = function(opt_params) {
  * <a href="opensocial.Name.html#getField">Name.getField()</a> method.
  *
  * @name opensocial.Name.Field
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.42
  */
 opensocial.Name.Field = {
   /**
@@ -107,6 +109,7 @@ opensocial.Name.Field = {
  *    <a href="opensocial.DataRequest.DataRequestFields.html">params</a>
  *    to pass to the request.
  * @return {string} The data.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.41.1.1
  */
 opensocial.Name.prototype.getField = function(key, opt_params) {
   return opensocial.Container.getField(this.fields_, key, opt_params);

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/opensocial.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/opensocial.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/opensocial.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/opensocial.js Wed Nov 10 09:59:35 2010
@@ -35,6 +35,7 @@
  *
  * @private
  * @constructor (note: a constructor for JsDoc purposes)
+ * @deprecated since 1.0 (see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.1)
  */
 var opensocial = opensocial || {};
 
@@ -73,6 +74,7 @@ var opensocial = opensocial || {};
  *     NavigationParameters.DestinationType.</a>
  *
  * @member opensocial
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.1.1.9
  */
 opensocial.requestSendMessage = function(recipients, message, opt_callback,
     opt_params) {
@@ -164,6 +166,7 @@ opensocial.requestShareApp = function(re
  *    processed.
  *
  * @member opensocial
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.1.1.8
  */
 opensocial.requestCreateActivity = function(activity, priority, opt_callback) {
   if (!activity || (!activity.getField(opensocial.Activity.Field.TITLE) && !activity.getField(opensocial.Activity.Field.TITLE_ID))) {
@@ -193,6 +196,7 @@ opensocial.requestCreateActivity = funct
  *
  * @name opensocial.CreateActivityPriority
  * @enum {string}
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.11
  */
 opensocial.CreateActivityPriority = {
   /**
@@ -309,6 +313,7 @@ opensocial.getEnvironment = function() {
  * @return {opensocial.DataRequest} The
  *    <a href="opensocial.DataRequest.html">request</a> object.
  * @member opensocial
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.1.1.4
  */
 opensocial.newDataRequest = function() {
   return opensocial.Container.get().newDataRequest();
@@ -342,6 +347,7 @@ opensocial.newDataRequest = function() {
  * @return {opensocial.Activity} The new
  *    <a href="opensocial.Activity.html">activity</a> object.
  * @member opensocial
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.1.1.2
  */
 opensocial.newActivity = function(params) {
   return opensocial.Container.get().newActivity(params);
@@ -361,6 +367,7 @@ opensocial.newActivity = function(params
  * @return {opensocial.Album} The new
  *    <a href="opensocial.Album.html">album</a> object.
  * @member opensocial
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.1.1.3
  */
 opensocial.newAlbum = function(opt_params) {
   return opensocial.Container.get().newAlbum(opt_params);
@@ -385,6 +392,7 @@ opensocial.newAlbum = function(opt_param
  * @return {opensocial.MediaItem} The new
  *    <a href="opensocial.MediaItem.html">media item</a> object.
  * @member opensocial
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.1.1.6
  */
 opensocial.newMediaItem = function(mimeType, url, opt_params) {
   return opensocial.Container.get().newMediaItem(mimeType, url, opt_params);
@@ -406,6 +414,7 @@ opensocial.newMediaItem = function(mimeT
  * @return {opensocial.Message} The new
  *    <a href="opensocial.Message.html">message</a> object.
  * @member opensocial
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.1.1.7
  */
 opensocial.newMessage = function(body, opt_params) {
   return opensocial.Container.get().newMessage(body, opt_params);
@@ -418,6 +427,7 @@ opensocial.newMessage = function(body, o
  * The types of escaping that can be applied to person data or fields.
  *
  * @name opensocial.EscapeType
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.29
  */
 opensocial.EscapeType = {
   /**
@@ -442,6 +452,7 @@ opensocial.EscapeType = {
  * @return {opensocial.IdSpec} The new
  *     <a href="opensocial.IdSpec.html">IdSpec</a> object.
  * @member opensocial
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.1.1.5
  */
 opensocial.newIdSpec = function(params) {
   return opensocial.Container.get().newIdSpec(params);
@@ -470,6 +481,7 @@ opensocial.newNavigationParameters = fun
 
 /**
  * Invalidates all resources cached for the current viewer.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.1.1.1
  */
 opensocial.invalidateCache = function() {
   opensocial.Container.get().invalidateCache();

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/organization.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/organization.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/organization.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/organization.js Wed Nov 10 09:59:35 2010
@@ -37,6 +37,7 @@
  *
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.43
  */
 opensocial.Organization = function(opt_params) {
   this.fields_ = opt_params || {};
@@ -51,6 +52,7 @@ opensocial.Organization = function(opt_p
  * Organization.getField()</a> method.
  *
  * @name opensocial.Organization.Field
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.44
  */
 opensocial.Organization.Field = {
   /**
@@ -144,6 +146,7 @@ opensocial.Organization.Field = {
  *    <a href="opensocial.DataRequest.DataRequestFields.html">params</a>
  *    to pass to the request.
  * @return {string} The data.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.43.1.1
  */
 opensocial.Organization.prototype.getField = function(key, opt_params) {
   return opensocial.Container.getField(this.fields_, key, opt_params);

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/person.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/person.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/person.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/person.js Wed Nov 10 09:59:35 2010
@@ -37,6 +37,7 @@
  *
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.45
  */
 opensocial.Person = function(opt_params, opt_isOwner, opt_isViewer) {
   this.fields_ = opt_params || {};
@@ -52,6 +53,7 @@ opensocial.Person = function(opt_params,
  * <a href="opensocial.Person.html#getField">Person.getField()</a> method.
  *
  * @name opensocial.Person.Field
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.46
  */
 opensocial.Person.Field = {
   /**
@@ -494,6 +496,7 @@ opensocial.Person.Field = {
  * Gets an ID that can be permanently associated with this person.
  *
  * @return {string} The ID.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.45.1.4
  */
 opensocial.Person.prototype.getId = function() {
   return this.getField(opensocial.Person.Field.ID);
@@ -512,6 +515,7 @@ var ORDERED_NAME_FIELDS_ = [
  * a useful string.
  *
  * @return {string} The display name.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.45.1.2
  */
 opensocial.Person.prototype.getDisplayName = function() {
   var name = this.getField(opensocial.Person.Field.NAME);
@@ -549,6 +553,7 @@ opensocial.Person.prototype.getDisplayNa
  *    <a href="opensocial.DataRequest.DataRequestFields.html">params</a>
  *    to pass to the request.
  * @return {string} The data.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.45.1.3
  */
 opensocial.Person.prototype.getField = function(key, opt_params) {
   return opensocial.Container.getField(this.fields_, key, opt_params);
@@ -561,6 +566,7 @@ opensocial.Person.prototype.getField = f
  *
  * @param {string} key The key to get app data for.
  * @return {string} The corresponding app data.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.45.1.1
  */
 opensocial.Person.prototype.getAppData = function(key) {
 };
@@ -571,6 +577,7 @@ opensocial.Person.prototype.getAppData =
  *
  * @return {boolean} True if this is the currently logged in user;
  *   otherwise, false.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.45.1.6
  */
 opensocial.Person.prototype.isViewer = function() {
   return !!this.isViewer_;
@@ -582,6 +589,7 @@ opensocial.Person.prototype.isViewer = f
  *
  * @return {boolean} True if this is the owner of the page;
  *   otherwise, false.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.45.1.5
  */
 opensocial.Person.prototype.isOwner = function() {
   return !!this.isOwner_;

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/phone.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/phone.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/phone.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/phone.js Wed Nov 10 09:59:35 2010
@@ -37,6 +37,7 @@
  *
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.47
  */
 opensocial.Phone = function(opt_params) {
   this.fields_ = opt_params || {};
@@ -52,6 +53,7 @@ opensocial.Phone = function(opt_params) 
  * @name opensocial.Phone.Field
  * @enum {string}
  * @const
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.48
  */
 opensocial.Phone.Field = {
   /**
@@ -82,6 +84,7 @@ opensocial.Phone.Field = {
  *    <a href="opensocial.DataRequest.DataRequestFields.html">params</a>
  *    to pass to the request.
  * @return {string} The data.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.47.1.1
  */
 opensocial.Phone.prototype.getField = function(key, opt_params) {
   return opensocial.Container.getField(this.fields_, key, opt_params);

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/responseitem.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/responseitem.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/responseitem.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/responseitem.js Wed Nov 10 09:59:35 2010
@@ -40,6 +40,7 @@
  *
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.49
  */
 opensocial.ResponseItem = function(originalDataRequest, data,
     opt_errorCode, opt_errorMessage) {
@@ -54,6 +55,7 @@ opensocial.ResponseItem = function(origi
  * Returns true if there was an error in fetching this data from the server.
  *
  * @return {boolean} True if there was an error; otherwise, false.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.49.1.5
  */
 opensocial.ResponseItem.prototype.hadError = function() {
   return !!this.errorCode_;
@@ -67,6 +69,7 @@ opensocial.ResponseItem.prototype.hadErr
  * Error codes that a response item can return.
  *
  * @name opensocial.ResponseItem.Error
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.50
  */
 opensocial.ResponseItem.Error = {
   /**
@@ -126,6 +129,7 @@ opensocial.ResponseItem.Error = {
  * <a href="opensocial.ResponseItem.Error.html"><code>Error</code></a>.
  *
  * @return {string} The error code, or null if no error occurred.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.49.1.2
  */
 opensocial.ResponseItem.prototype.getErrorCode = function() {
   return this.errorCode_;
@@ -137,6 +141,7 @@ opensocial.ResponseItem.prototype.getErr
  *
  * @return {string} A human-readable description of the error that occurred;
  *    can be null, even if an error occurred.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.49.1.3
  */
 opensocial.ResponseItem.prototype.getErrorMessage = function() {
   return this.errorMessage_;
@@ -148,6 +153,7 @@ opensocial.ResponseItem.prototype.getErr
  *
  * @return {opensocial.DataRequest} The data request used to fetch this data
  *    response.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.49.1.4
  */
 opensocial.ResponseItem.prototype.getOriginalDataRequest = function() {
   return this.originalDataRequest_;
@@ -159,6 +165,7 @@ opensocial.ResponseItem.prototype.getOri
  *
  * @return {Object} The requested value calculated by the server; the type of
  *    this value is defined by the type of request that was made.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.49.1.1
  */
 opensocial.ResponseItem.prototype.getData = function() {
   return this.data_;

Modified: shindig/trunk/features/src/main/javascript/features/opensocial-reference/url.js
URL: http://svn.apache.org/viewvc/shindig/trunk/features/src/main/javascript/features/opensocial-reference/url.js?rev=1033405&r1=1033404&r2=1033405&view=diff
==============================================================================
--- shindig/trunk/features/src/main/javascript/features/opensocial-reference/url.js (original)
+++ shindig/trunk/features/src/main/javascript/features/opensocial-reference/url.js Wed Nov 10 09:59:35 2010
@@ -37,6 +37,7 @@
  *
  * @private
  * @constructor
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.51
  */
 opensocial.Url = function(opt_params) {
   this.fields_ = opt_params || {};
@@ -50,6 +51,7 @@ opensocial.Url = function(opt_params) {
  * <a href="opensocial.Url.html#getField">Url.getField()</a> method.
  *
  * @name opensocial.Url.Field
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.52
  */
 opensocial.Url.Field = {
   /**
@@ -87,6 +89,7 @@ opensocial.Url.Field = {
  *    <a href="opensocial.DataRequest.DataRequestFields.html">params</a>
  *    to pass to the request.
  * @return {string} The data.
+ * @deprecated since 1.0 see http://opensocial-resources.googlecode.com/svn/spec/1.0/Social-Gadget.xml#rfc.section.A.51.1.1
  */
 opensocial.Url.prototype.getField = function(key, opt_params) {
   return opensocial.Container.getField(this.fields_, key, opt_params);