sproutcore 1.9.2 → 1.10.0.rc.1

data/lib/frameworks/sproutcore/apps/welcome/english.lproj/main_page.js

@@ -2,66 +2,63 @@
 // Project:   Welcome - mainPage
 // Copyright: ©2011 Apple Inc.
 // ==========================================================================
-/*globals Welcome */
+/*global Welcome */
 
-// This page describes the main user interface for your application.  
+// This page describes the main user interface for your application.
 Welcome.mainPage = SC.Page.design({
 
   // The main pane is made visible on screen as soon as your app is loaded.
-  // Add childViews to this pane for views to display immediately on page 
+  // Add childViews to this pane for views to display immediately on page
   // load.
   mainPane: SC.MainPane.design({
     childViews: 'contentView'.w(),
-    
+
     contentView: SC.View.design({
       layout: { width: 280, height: 340, centerX: 0, centerY: 0 },
-      childViews: 'heading appSelector launchApplication'.w(),
-      
-      heading: SC.View.design({
+      childViews: ['heading', 'appSelector', 'launchApplication'],
+
+      heading: SC.ImageView.design({
         layout: { width: 271, centerX: 0, top: 0, height: 60 },
-        tagName: 'img',
-        render: function(context, firstTime) {
-          context.attr('src', sc_static('images/sproutcore'));
-        }
+        value: sc_static('images/sproutcore.png')
       }),
-      
+
       appSelector: SC.View.design({
-        layout: {top:80, left:0, right:0, bottom:46},
+        layout: { top: 80, left: 0, right: 0, bottom: 46 },
         childViews: 'scrollView'.w(),
         classNames: 'app-selector',
-        
+
         scrollView: SC.ScrollView.design({
           layout: { left: 0, top: 0, right: 0, bottom: 0 },
           hasHorizontalScroller: NO,
-        
-          contentView: SC.ListView.design({  
+
+          contentView: SC.ListView.design({
             rowHeight: 40,
 
-            contentBinding: "Welcome.targetsController.appsOnly",
+            contentBinding: SC.Binding.oneWay("Welcome.targetsController.appsOnly"),
             selectionBinding: "Welcome.targetsController.selection",
-            isEnabledBinding: "Welcome.targetsController.canLoadApp",
-          
+            isEnabledBinding: SC.Binding.oneWay("Welcome.targetsController.canLoadApp"),
+
             contentValueKey: "displayName",
             contentIconKey: "targetIcon",
             hasContentIcon: YES,
-          
+
             target: "Welcome.targetsController",
             action: "loadApplication"
           })
         })
       }),
-      
+
       launchApplication: SC.ButtonView.design({
-        layout: {bottom:0, height:30, width:160, centerX:0},
-        isEnabledBinding: "Welcome.targetsController.launchEnabled",
+        layout: { bottom: 0, height: 30, width: 160, centerX: 0 },
+        isEnabledBinding: SC.Binding.oneWay("Welcome.targetsController.launchEnabled"),
         controlSize: SC.HUGE_CONTROL_SIZE,
         title: "Launch Application",
         isDefault: YES,
         target: "Welcome.targetsController",
         action: "loadApplication"
       })
-      
-    }) 
+
+    })
   })
 
 });

data/lib/frameworks/sproutcore/apps/welcome/main.js

@@ -2,7 +2,7 @@
 // Project:   Welcome
 // Copyright: ©2011 Apple Inc.
 // ==========================================================================
-/*globals Welcome */
+/*global Welcome */
 
 // This is the function that will start your app running.  The default
 // implementation will load any fixtures you have created then instantiate
@@ -12,8 +12,8 @@
 // See comments for some pointers on what to do next.
 //
 Welcome.main = function main() {
-  Welcome.getPath('mainPage.mainPane').append() ;
+  Welcome.getPath('mainPage.mainPane').append();
   Welcome.targetsController.reload();
-} ;
+};
 
 function main() { Welcome.main(); }

data/lib/frameworks/sproutcore/frameworks/ajax/system/request.js

@@ -389,9 +389,9 @@ SC.Request = SC.Object.extend(SC.Copyable, SC.Freezable,
     // is synchronous (because it wouldn't work).
     var timeout = this.get('timeout');
     if (timeout && !this.get('isAsynchronous')) {
-      throw "Timeout values cannot be used with synchronous requests";
+      throw new Error("Timeout values cannot be used with synchronous requests");
     } else if (timeout === 0) {
-      throw "The timeout value must either not be specified or must be greater than 0";
+      throw new Error("The timeout value must either not be specified or must be greater than 0");
     }
 
     if (body) { this.set('body', body); }
@@ -669,13 +669,27 @@ SC.Request.manager = SC.Object.create(
     @returns {Boolean} YES if any items were cancelled.
   */
   cancelAll: function() {
-    if (this.get('pending').length || this.get('inflight').length) {
-      this.set('pending', []);
-      this.get('inflight').forEach(function(r) { r.cancel(); });
-      this.set('inflight', []);
+    var pendingLen = this.getPath('pending.length'),
+      inflightLen = this.getPath('inflight.length'),
+      inflight = this.get('inflight'),
+      pending = this.get('pending');
+
+    if(pendingLen || inflightLen) {
+      // Iterate backwards.
+      for( var i = inflightLen - 1; i >= 0; i--) {
+        // This will 'eventually' try to remove the request from
+        // inflight, but it's not fast enough for us.
+        var r = inflight.objectAt(i);
+        r.cancel();
+      }
+      
+      // Manually scrub the arrays without screwing up memory pointers.
+      pending.replace(0, pendingLen);
+      inflight.replace(0, inflightLen);
+      
       return YES;
+      
     }
-
     return NO;
   },
 

data/lib/frameworks/sproutcore/frameworks/ajax/tests/system/request.js

@@ -264,7 +264,7 @@ test("Timeouts - SC.Request didReceive callback", function() {
   try {
     SC.Request.getUrl(url).set('timeout', 0).send();
   } catch (e) {
-    message = e;
+    message = e.message;
   }
   ok(message && message.indexOf("The timeout value must either not be specified or must be greater than 0") !== -1, 'An error should be thrown when the timeout value is 0 ms');
 
@@ -273,7 +273,7 @@ test("Timeouts - SC.Request didReceive callback", function() {
     SC.Request.getUrl(url).set('isAsynchronous', NO).set('timeout', 10).send();
   }
   catch (e2) {
-    message = e2;
+    message = e2.message;
   }
   ok(message && message.indexOf("Timeout values cannot be used with synchronous requests") !== -1, 'An error should be thrown when trying to use a timeout with a synchronous request');
 
@@ -569,3 +569,36 @@ test("Test upload event listeners on successful request.", function() {
 
   stop(2500); // stops the test runner - wait for response
 });
+
+
+test("Test manager.cancelAll.", function() {
+  var manager = SC.Request.manager, max = manager.get('maxRequests');
+  // Make sure we're clear.
+  SC.Request.manager.cancelAll();
+  
+  // Get a copy of the previous arrays, since they're overwritten on clear.
+  var inflight = manager.get('inflight');
+  var pending = manager.get('pending');
+  
+  // Generate > 6 requests
+  for( var i = 0; i < max * 2; i++) {
+    SC.Request.getUrl('/').send();
+  }
+  
+  equals(inflight.get('length'), max, "There must be %@ inflight requests".fmt(max));
+  equals(pending.get('length'), max, "There must be %@ pending requests".fmt(max));
+  
+  SC.Request.manager.cancelAll();
+
+  // Demonstrates memory pointer matches
+  equals(inflight, manager.getPath('inflight'), "Arrays must be identical");
+  equals(pending, manager.getPath('pending'), "Arrays must be identical");
+  
+  // Demonstrates that all previous requests have been cleared.
+  equals(inflight.get('length'), 0, "There must be 0 inflight requests in the old array".fmt(max));
+  equals(pending.get('length'), 0, "There must be 0 pending requests in the old array".fmt(max));
+  
+  // Demonstrates that the manager doesn't know about any requests.
+  equals(manager.getPath('inflight.length'), 0, "There must be 0 inflight requests".fmt(max));
+  equals(manager.getPath('pending.length'), 0, "There must be 0 pending requests".fmt(max));
+});

data/lib/frameworks/sproutcore/frameworks/bootstrap/system/browser.js

@@ -11,8 +11,8 @@ window.SC = window.SC || { MODULE_INFO: {}, LAZY_INSTANTIATION: {} };
 /**
   The list of browsers that are automatically identified.
 
-  @static
-  @constant
+  @readonly
+  @enum
 */
 SC.BROWSER = {
   android: 'android',
@@ -25,11 +25,41 @@ SC.BROWSER = {
   unknown: 'unknown'
 };
 
+/**
+  The list of browser specific object prefixes, these are matched to the
+  browser engine.
+
+  @readonly
+  @enum
+*/
+SC.CLASS_PREFIX = {
+  gecko: 'Moz',
+  opera: 'O',
+  presto: 'O',
+  trident: 'Ms', // Note the uppercase 'M'
+  webkit: 'WebKit' // Note the uppercase 'K'
+};
+
+/**
+  The list of browser specific CSS prefixes, these are matched to the
+  browser engine.
+
+  @readonly
+  @enum
+*/
+SC.CSS_PREFIX = {
+  gecko: '-moz-',
+  opera: '-o-',
+  presto: '-o-',
+  trident: '-ms-',
+  webkit: '-webkit-'
+};
+
 /**
   The list of devices that are automatically identified.
 
-  @static
-  @constant
+  @readonly
+  @enum
 */
 SC.DEVICE = {
   android: 'android',
@@ -41,11 +71,26 @@ SC.DEVICE = {
   mobile: 'mobile'
 };
 
+/**
+  The list of browser specific DOM prefixes, these are matched to the
+  browser engine.
+
+  @readonly
+  @enum
+*/
+SC.DOM_PREFIX = {
+  gecko: 'Moz',
+  opera: 'O',
+  presto: 'O',
+  trident: 'ms',
+  webkit: 'Webkit'
+};
+
 /**
   The list of browser engines that are automatically identified.
 
-  @static
-  @constant
+  @readonly
+  @enum
 */
 SC.ENGINE = {
   gecko: 'gecko',
@@ -58,8 +103,8 @@ SC.ENGINE = {
 /**
   The list of operating systems that are automatically identified.
 
-  @static
-  @constant
+  @readonly
+  @enum
 */
 SC.OS = {
   android: 'android',
@@ -76,7 +121,7 @@ SC.OS = {
 
   @private
 */
-SC.detectBrowser = function(userAgent, language) {
+SC.detectBrowser = function (userAgent, language) {
   var browser = {},
       device,
       engineAndVersion,
@@ -93,13 +138,13 @@ SC.detectBrowser = function(userAgent, language) {
 
   // Calculations to determine the device.  See SC.DEVICE.
   device =
-    userAgent.match( new RegExp('(android|ipad|iphone|ipod|blackberry)') ) ||
-    userAgent.match( new RegExp('(mobile)') ) ||
+    userAgent.match(new RegExp('(android|ipad|iphone|ipod|blackberry)')) ||
+    userAgent.match(new RegExp('(mobile)')) ||
     ['', SC.DEVICE.desktop];
 
   /**
     @name SC.browser.device
-    @type {SC.DEVICE}
+    @type SC.DEVICE|SC.BROWSER.unknown
   */
   browser.device = device[1];
 
@@ -115,24 +160,30 @@ SC.detectBrowser = function(userAgent, language) {
 
   nameAndVersion =
     // Match the specific names first, avoiding commonly spoofed browsers.
-    userAgent.match( new RegExp('(opera|chrome|firefox|android|blackberry)' + conExp + numExp) ) ||
-    userAgent.match( new RegExp('(ie|safari)' + conExp + numExp) ) ||
+    userAgent.match(new RegExp('(opera|chrome|firefox|android|blackberry)' + conExp + numExp)) ||
+    userAgent.match(new RegExp('(ie|safari)' + conExp + numExp)) ||
+    userAgent.match(new RegExp('(trident)')) ||
     ['', SC.BROWSER.unknown, '0'];
 
   // If the device is an iOS device, use SC.BROWSER.safari for browser.name.
   if (isIOSDevice) { nameAndVersion[1] = SC.BROWSER.safari; }
 
   // If a `Version` number is found, use that over the `Name` number
-  override = userAgent.match( new RegExp('(version)' + conExp + numExp) );
+  override = userAgent.match(new RegExp('(version)' + conExp + numExp));
   if (override) { nameAndVersion[2] = override[2]; }
   // If there is no `Version` in Safari, don't use the Safari number since it is
   // the Webkit number.
   else if (nameAndVersion[1] === SC.BROWSER.safari) { nameAndVersion[2] = '0'; }
-
+  else if (nameAndVersion[1] === SC.ENGINE.trident) {
+    // Special handling for IE11 (no 'ie' component, only 'trident' + 'rv')
+    nameAndVersion[1] = SC.BROWSER.ie;
+    this._ieVersion = nameAndVersion[2];
+    nameAndVersion[2] = userAgent.match(new RegExp('(rv)' + conExp + numExp))[2];
+  }
 
   /**
     @name SC.browser.name
-    @type {SC.BROWSER}
+    @type SC.BROWSER|SC.BROWSER.unknown
   */
   browser.name = nameAndVersion[1];
 
@@ -146,8 +197,8 @@ SC.detectBrowser = function(userAgent, language) {
   // Calculations to determine the engine and version.  See SC.ENGINE.
   engineAndVersion =
     // Match the specific engines first, avoiding commonly spoofed browsers.
-    userAgent.match( new RegExp('(presto)' + conExp + numExp) ) ||
-    userAgent.match( new RegExp('(opera|trident|webkit|gecko)' + conExp + numExp) ) ||
+    userAgent.match(new RegExp('(presto)' + conExp + numExp)) ||
+    userAgent.match(new RegExp('(opera|trident|webkit|gecko)' + conExp + numExp)) ||
     ['', SC.BROWSER.unknown, '0'];
 
   // If the browser is SC.BROWSER.ie, use SC.ENGINE.trident.
@@ -159,15 +210,14 @@ SC.detectBrowser = function(userAgent, language) {
   override = browser.name === SC.BROWSER.ie && engineAndVersion[2] === '0';
   if (override) { engineAndVersion[2] = browser.version; }
 
-  // If a `rv` number is found, use that over the engine number.
-  override = userAgent.match( new RegExp('(rv)' + conExp + numExp) );
-  if (override) { engineAndVersion[2] = override[2]; }
+  // If a `rv` number is found, use that over the engine number (except for IE11+ where 'rv' now indicates the browser version).
+  override = userAgent.match(new RegExp('(rv)' + conExp + numExp));
+  if (override && engineAndVersion[1] !== SC.ENGINE.trident) { engineAndVersion[2] = override[2]; }
 
 
   /**
     @name SC.browser.engine
-    @type {SC.ENGINE}
-    @type {SC.BROWSER.unknown}
+    @type SC.ENGINE|SC.BROWSER.unknown
   */
   browser.engine = engineAndVersion[1];
 
@@ -177,6 +227,30 @@ SC.detectBrowser = function(userAgent, language) {
   */
   browser.engineVersion = engineAndVersion[2];
 
+  /**
+    The prefix of browser specific methods on this platform.
+
+    @name SC.browser.domPrefix
+    @type String
+  */
+  browser.domPrefix = SC.DOM_PREFIX[browser.engine];
+
+  /**
+    The prefix of browser specific properties on this platform.
+
+    @name SC.browser.classPrefix
+    @type String
+  */
+  browser.classPrefix = SC.CLASS_PREFIX[browser.engine];
+
+  /**
+    The prefix of browser specific CSS properties on this platform.
+
+    @name SC.browser.cssPrefix
+    @type String
+  */
+  browser.cssPrefix = SC.CSS_PREFIX[browser.engine];
+
 
   // If we don't know the name of the browser, use the name of the engine.
   if (browser.name === SC.BROWSER.unknown) { browser.name = browser.engine; }
@@ -184,10 +258,10 @@ SC.detectBrowser = function(userAgent, language) {
   // Calculations to determine the os and version.  See SC.OS.
   osAndVersion =
     // Match the specific names first, avoiding commonly spoofed os's.
-    userAgent.match( new RegExp('(blackberry)') ) ||
-    userAgent.match( new RegExp('(android|iphone(?: os)|windows(?: nt))' + conExp + numExp) ) ||
-    userAgent.match( new RegExp('(os|mac(?: os)(?: x))' + conExp + numExp) ) ||
-    userAgent.match( new RegExp('(linux)') ) ||
+    userAgent.match(new RegExp('(blackberry)')) ||
+    userAgent.match(new RegExp('(android|iphone(?: os)|windows(?: nt))' + conExp + numExp)) ||
+    userAgent.match(new RegExp('(os|mac(?: os)(?: x))' + conExp + numExp)) ||
+    userAgent.match(new RegExp('(linux)')) ||
     [null, SC.BROWSER.unknown, '0'];
 
   // Normalize the os name.
@@ -201,8 +275,7 @@ SC.detectBrowser = function(userAgent, language) {
 
   /**
     @name SC.browser.os
-    @type {SC.OS}
-    @type {SC.BROWSER.unknown}
+    @type SC.OS|SC.BROWSER.unknown
   */
   browser.os = osAndVersion[1];
 
@@ -221,185 +294,185 @@ SC.detectBrowser = function(userAgent, language) {
   // only maintain the 7 identifiable properties listed above:  device, name,
   // version, os, osVersion, engine and engineVersion.
 
-  /** @deprecated Since version 1.7. Use browser.os === SC.OS.windows.
+  /** @deprecated Version 1.7. Use browser.os === SC.OS.win.
     @name SC.browser.isWindows
     @type Boolean
   */
-  browser.windows = browser.isWindows = browser.os === SC.OS.windows;
+  browser.windows = browser.isWindows = browser.os === SC.OS.win;
 
-  /** @deprecated Since version 1.7. Use browser.os === SC.OS.mac.
+  /** @deprecated Version 1.7. Use browser.os === SC.OS.mac.
     @name SC.browser.isMac
     @type Boolean
   */
   browser.mac = browser.isMac = browser.os === SC.OS.mac;
 
-  /** @deprecated Since version 1.7. Use browser.os === SC.OS.mac && browser.compare(browser.osVersion, '10.7') == 0
+  /** @deprecated Version 1.7. Use browser.os === SC.OS.mac && browser.compare(browser.osVersion, '10.7') == 0
     @name SC.browser.isLion
     @type Boolean
   */
   browser.lion = browser.isLion = !!(/mac os x 10_7/.test(userAgent) && !/like mac os x 10_7/.test(userAgent));
 
-  /** @deprecated Since version 1.7. Use browser.device === SC.DEVICE.iphone.
+  /** @deprecated Version 1.7. Use browser.device === SC.DEVICE.iphone.
     @name SC.browser.isiPhone
     @type Boolean
   */
   browser.iPhone = browser.isiPhone = browser.device === SC.DEVICE.iphone;
 
-  /** @deprecated Since version 1.7. Use browser.device === SC.DEVICE.ipod.
+  /** @deprecated Version 1.7. Use browser.device === SC.DEVICE.ipod.
     @name SC.browser.isiPod
     @type Boolean
   */
   browser.iPod = browser.isiPod = browser.device === SC.DEVICE.ipod;
 
-  /** @deprecated Since version 1.7. Use browser.device === SC.DEVICE.ipad.
+  /** @deprecated Version 1.7. Use browser.device === SC.DEVICE.ipad.
     @name SC.browser.isiPad
     @type Boolean
   */
   browser.iPad = browser.isiPad = browser.device === SC.DEVICE.ipad;
 
-  /** @deprecated Since version 1.7. Use browser.os === SC.OS.ios.
+  /** @deprecated Version 1.7. Use browser.os === SC.OS.ios.
     @name SC.browser.isiOS
     @type Boolean
   */
   browser.iOS = browser.isiOS = browser.os === SC.OS.ios;
 
-  /** @deprecated Since version 1.7. Use browser.os === SC.OS.android or browser.name === SC.BROWSER.android or browser.device === SC.DEVICE.android.
+  /** @deprecated Version 1.7. Use browser.os === SC.OS.android or browser.name === SC.BROWSER.android or browser.device === SC.DEVICE.android.
     @name SC.browser.isAndroid
     @type Boolean
   */
   browser.android = browser.isAndroid = browser.os === SC.OS.android;
 
-  /** @deprecated Since version 1.7. Use browser.version or browser.engineVersion.
+  /** @deprecated Version 1.7. Use browser.version or browser.engineVersion.
     @name SC.browser.opera
     @type String
   */
   browser.opera = browser.name === SC.BROWSER.opera ? browser.version : '0';
 
-  /** @deprecated Since version 1.7. Use browser.name === SC.BROWSER.opera.
+  /** @deprecated Version 1.7. Use browser.name === SC.BROWSER.opera.
     @name SC.browser.isOpera
     @type Boolean
   */
   browser.isOpera = browser.name === SC.BROWSER.opera;
 
-  /** @deprecated Since version 1.7. Use browser.version or browser.engineVersion.
+  /** @deprecated Version 1.7. Use browser.version or browser.engineVersion.
     @name SC.browser.msie
     @type String
   */
   browser.msie = browser.name === SC.BROWSER.ie ? browser.version : '0';
 
-  /** @deprecated Since version 1.7. Use browser.engine === SC.ENGINE.trident.
+  /** @deprecated Version 1.7. Use browser.engine === SC.ENGINE.trident.
     @name SC.browser.isIE
     @type Boolean
   */
   browser.isIE = browser.engine === SC.ENGINE.trident;
 
-  /** @deprecated Since version 1.7. Use browser.compare(browser.version, '8') <= 0.
+  /** @deprecated Version 1.7. Use browser.compare(browser.version, '8') <= 0.
     @name SC.browser.isIE8OrLower
     @type Boolean
   */
   browser.isIE8OrLower = browser.name === SC.BROWSER.ie && browser.version <= 8;
 
-  /** @deprecated Since version 1.7. Use browser.version or browser.engineVersion.
+  /** @deprecated Version 1.7. Use browser.version or browser.engineVersion.
     @name SC.browser.mozilla
     @type String
   */
   browser.mozilla = browser.engine === SC.ENGINE.gecko ? browser.version : '0';
 
-  /** @deprecated Since version 1.7. Use browser.name === SC.BROWSER.firefox or browser.engine === SC.ENGINE.gecko.
+  /** @deprecated Version 1.7. Use browser.name === SC.BROWSER.firefox or browser.engine === SC.ENGINE.gecko.
     @name SC.browser.isMozilla
     @type Boolean
   */
   browser.isMozilla = browser.engine === SC.ENGINE.gecko;
 
-  /** @deprecated Since version 1.7. Use browser.engineVersion.
+  /** @deprecated Version 1.7. Use browser.engineVersion.
     @name SC.browser.webkit
     @type String
   */
   browser.webkit = browser.engine === SC.ENGINE.webkit ? browser.engineVersion : '0';
 
-  /** @deprecated Since version 1.7. Use browser.engine === SC.ENGINE.webkit.
+  /** @deprecated Version 1.7. Use browser.engine === SC.ENGINE.webkit.
     @name SC.browser.isWebkit
     @type Boolean
   */
   browser.isWebkit = browser.engine === SC.ENGINE.webkit;
 
-  /** @deprecated Since version 1.7. Use browser.version.
+  /** @deprecated Version 1.7. Use browser.version.
     @name SC.browser.chrome
     @type String
   */
   browser.chrome = browser.name === SC.BROWSER.chrome ? browser.version : '0';
 
-  /** @deprecated Since version 1.7. Use browser.name === SC.BROWSER.chrome.
+  /** @deprecated Version 1.7. Use browser.name === SC.BROWSER.chrome.
     @name SC.browser.isChrome
     @type Boolean
   */
   browser.isChrome = browser.name === SC.BROWSER.chrome;
 
-  /** @deprecated Since version 1.7. Use browser.version.
+  /** @deprecated Version 1.7. Use browser.version.
     @name SC.browser.mobileSafari
     @type String
   */
   browser.mobileSafari = browser.os === SC.OS.ios ? browser.version : '0';
 
-  /** @deprecated Since version 1.7. Use browser.name === SC.BROWSER.safari && browser.os === SC.OS.ios
+  /** @deprecated Version 1.7. Use browser.name === SC.BROWSER.safari && browser.os === SC.OS.ios
     @name SC.browser.isMobileSafari
     @type Boolean
   */
   browser.isMobileSafari = browser.name === SC.BROWSER.safari && browser.os === SC.OS.ios;
 
-  /** @deprecated Since version 1.7. Use browser.version.
+  /** @deprecated Version 1.7. Use browser.version.
     @name SC.browser.iPadSafari
     @type String
   */
   browser.iPadSafari = browser.device === SC.DEVICE.ipad && browser.name === SC.BROWSER.safari ?
     browser.version : 0;
 
-  /** @deprecated Since version 1.7. Use browser.device === SC.DEVICE.ipad && browser.name === SC.BROWSER.safari
+  /** @deprecated Version 1.7. Use browser.device === SC.DEVICE.ipad && browser.name === SC.BROWSER.safari
     @name SC.browser.isiPadSafari
     @type Boolean
   */
   browser.isiPadSafari = browser.device === SC.DEVICE.ipad && browser.name === SC.BROWSER.safari;
 
-  /** @deprecated Since version 1.7. Use browser.version.
+  /** @deprecated Version 1.7. Use browser.version.
     @name SC.browser.iPhoneSafari
     @type String
   */
   browser.iPhoneSafari = browser.device === SC.DEVICE.iphone && browser.name === SC.BROWSER.safari ?
     browser.version : 0;
 
-  /** @deprecated Since version 1.7. Use browser.device === SC.DEVICE.iphone && browser.name === SC.BROWSER.safari
+  /** @deprecated Version 1.7. Use browser.device === SC.DEVICE.iphone && browser.name === SC.BROWSER.safari
     @name SC.browser.isiPhoneSafari
     @type Boolean
   */
   browser.isiPhoneSafari = browser.device === SC.DEVICE.iphone && browser.name === SC.BROWSER.safari;
 
-  /** @deprecated Since version 1.7. Use browser.version.
+  /** @deprecated Version 1.7. Use browser.version.
     @name SC.browser.iPodSafari
     @type String
   */
   browser.iPodSafari = browser.device === SC.DEVICE.ipod && browser.name === SC.BROWSER.safari ?
     browser.version : 0;
 
-  /** @deprecated Since version 1.7. Use browser.device === SC.DEVICE.ipod && browser.name === SC.BROWSER.safari
+  /** @deprecated Version 1.7. Use browser.device === SC.DEVICE.ipod && browser.name === SC.BROWSER.safari
     @name SC.browser.isiPodSafari
     @type Boolean
   */
   browser.isiPodSafari = browser.device === SC.DEVICE.ipod && browser.name === SC.BROWSER.safari;
 
-  /** @deprecated Since version 1.7. Use SC.platform.standalone.
+  /** @deprecated Version 1.7. Use SC.platform.standalone.
     @name SC.browser.isiOSHomeScreen
     @type Boolean
   */
   browser.isiOSHomeScreen = browser.isMobileSafari && !(/apple.*mobile.*safari/.test(userAgent));
 
-  /** @deprecated Since version 1.7. Use browser.version.
+  /** @deprecated Version 1.7. Use browser.version.
     @name SC.browser.safari
     @type String
   */
   browser.safari = browser.name === SC.BROWSER.safari && browser.os === SC.OS.mac ?
     browser.version : 0;
 
-  /** @deprecated Since version 1.7. Use browser.name === SC.BROWSER.safari && browser.os === SC.OS.mac.
+  /** @deprecated Version 1.7. Use browser.name === SC.BROWSER.safari && browser.os === SC.OS.mac.
     @name SC.browser.isSafari
     @type Boolean
   */
@@ -417,20 +490,9 @@ SC.detectBrowser = function(userAgent, language) {
   */
   browser.countryCode = language.split('-')[1] ? language.split('-')[1].toLowerCase() : undefined;
 
-  /** @deprecated Since version 1.7. Use browser.name.  See SC.BROWSER for possible values.
-    Possible values:
-
-      - 'ie'
-      - 'mozilla'
-      - 'chrome'
-      - 'safari'
-      - 'opera'
-      - 'mobile-safari'
-      - 'unknown'
-
+  /** @deprecated Version 1.7. Use browser.name.  See SC.BROWSER for possible values.
     @name SC.browser.current
     @type String
-    @default 'unknown'
   */
   browser.current = browser.name;
 
@@ -450,14 +512,19 @@ SC.detectBrowser = function(userAgent, language) {
     - browser.osVersion               ex. '10.6'
     - browser.engine                  ex. SC.ENGINE.webkit
     - browser.engineVersion           ex. '533.29'
+    - browser.cssPrefix               ex. '-webkit-'
+    - browser.classPrefix            ex. 'WebKit'
+    - browser.domPrefix               ex. 'webkit'
 
   Note: User agent sniffing does not provide guaranteed results and spoofing may
   affect the accuracy.  Therefore, as a general rule, it is much better
-  to rely on the browser's verified capabilities in SC.platform.
+  to rely on the browser's verified capabilities in SC.platform. But if you must
+  write browser specific code, understand that SC.browser does an exceptional
+  job at identifying the current browser.
 
   Based on the unit test samples, the most stable browser properties appear to
   be `engine` and `engineVersion`.
 
-  @since SproutCore 1.0
+  @since Version 1.0
 */
 SC.browser = SC.detectBrowser();