sproutcore 0.9.9 → 0.9.10

data/History.txt

@@ -1,3 +1,12 @@
+
+* The build tools can now generate bundles with relative paths. Fixes #19
+
+* Fixed minor typos in the generated template files closed #17
+
+* Renamed generators to sc_generators.  This avoids a conflict with Rails 2.1.
+
+* [FIX] Applied bug fixes suggested by typo_pl to make the build tool run on windows.
+
 * [FIX] Changed default language mapping for Japanese from jp to ja.
 
 == SproutCore 0.9.8

data/Manifest.txt

@@ -219,38 +219,6 @@ frameworks/sproutcore/views/split_divider.js
 frameworks/sproutcore/views/tab.js
 frameworks/sproutcore/views/toolbar.js
 frameworks/sproutcore/views/view.js
-generators/client/client_generator.rb
-generators/client/README
-generators/client/templates/core.js
-generators/client/templates/english.lproj/body.css
-generators/client/templates/english.lproj/body.rhtml
-generators/client/templates/english.lproj/strings.js
-generators/client/templates/main.js
-generators/client/USAGE
-generators/controller/controller_generator.rb
-generators/controller/templates/controller.js
-generators/controller/templates/test.rhtml
-generators/controller/USAGE
-generators/framework/framework_generator.rb
-generators/framework/README
-generators/framework/templates/core.js
-generators/framework/templates/english.lproj/strings.js
-generators/framework/USAGE
-generators/language/language_generator.rb
-generators/language/templates/strings.js
-generators/language/USAGE
-generators/model/model_generator.rb
-generators/model/templates/fixture.js
-generators/model/templates/model.js
-generators/model/templates/test.rhtml
-generators/model/USAGE
-generators/test/templates/test.rhtml
-generators/test/test_generator.rb
-generators/test/USAGE
-generators/view/templates/test.rhtml
-generators/view/templates/view.js
-generators/view/USAGE
-generators/view/view_generator.rb
 History.txt
 jsdoc/app/DocFile.js
 jsdoc/app/Doclet.js
@@ -303,6 +271,38 @@ Manifest.txt
 Rakefile
 README.txt
 sc-config.rb
+sc_generators/client/client_generator.rb
+sc_generators/client/README
+sc_generators/client/templates/core.js
+sc_generators/client/templates/english.lproj/body.css
+sc_generators/client/templates/english.lproj/body.rhtml
+sc_generators/client/templates/english.lproj/strings.js
+sc_generators/client/templates/main.js
+sc_generators/client/USAGE
+sc_generators/controller/controller_generator.rb
+sc_generators/controller/templates/controller.js
+sc_generators/controller/templates/test.rhtml
+sc_generators/controller/USAGE
+sc_generators/framework/framework_generator.rb
+sc_generators/framework/README
+sc_generators/framework/templates/core.js
+sc_generators/framework/templates/english.lproj/strings.js
+sc_generators/framework/USAGE
+sc_generators/language/language_generator.rb
+sc_generators/language/templates/strings.js
+sc_generators/language/USAGE
+sc_generators/model/model_generator.rb
+sc_generators/model/templates/fixture.js
+sc_generators/model/templates/model.js
+sc_generators/model/templates/test.rhtml
+sc_generators/model/USAGE
+sc_generators/test/templates/test.rhtml
+sc_generators/test/test_generator.rb
+sc_generators/test/USAGE
+sc_generators/view/templates/test.rhtml
+sc_generators/view/templates/view.js
+sc_generators/view/USAGE
+sc_generators/view/view_generator.rb
 script/destroy
 script/generate
 script/txt2html

data/app_generators/sproutcore/sproutcore_generator.rb

@@ -1,3 +1,5 @@
+require 'sproutcore/generator_helper'
+
 class SproutcoreGenerator < RubiGen::Base
   
   DEFAULT_SHEBANG = File.join(Config::CONFIG['bindir'],

data/app_generators/sproutcore/templates/README

@@ -6,7 +6,7 @@ already created one for you.)
 
 Then, start the SproutCore Dev Server by running from this directory:
 
-sc_server 
+sc-server 
 
 This takes all the same arguments as mongrel.  You can now visit your app
 by going to:
@@ -53,13 +53,13 @@ you require them.
 
 == Deploying your SproutCore App
 
-Normally you will use the sc_server to host your application while you are 
+Normally you will use the sc-server to host your application while you are 
 developing your code.  Once you are ready to deploy, however, there are two
 ways you can do it:
 
-==== 1. Use sc_server in production.  
+==== 1. Use sc-server in production.  
 
-The SproutCore server can be run in a production mode that will simply generate and cache web-optimized versions of all of your resources upon request.  For a low-traffic or newer site, this approach is an easy way to get your code into production.  You just replace your directory with your latest files and the sc_server will start serving the new resources.
+The SproutCore server can be run in a production mode that will simply generate and cache web-optimized versions of all of your resources upon request.  For a low-traffic or newer site, this approach is an easy way to get your code into production.  You just replace your directory with your latest files and the sc-server will start serving the new resources.
 
 ==== 2. Do a static build
 
@@ -68,7 +68,7 @@ In general, however, loading all of your resources through a Ruby-app is not the
 If you want real speed, do a static build of your content and serve it through
 lighttpd or apache.  Do the static build, just run:
 
-sc_build all
+sc-build all
 
 This will place a directory in tmp/build that contains all of your resources 
 pre-compiled and ready for static serving.

data/bin/sc-gen

@@ -22,6 +22,6 @@ require 'sproutcore'
 
 ARGV.shift if ['--help', '-h'].include?(ARGV[0])
 
-RubiGen::Base.use_component_sources! [:sproutcore]
+RubiGen::Base.use_component_sources! [:sc]
 RubiGen::Scripts::Generate.new.run(ARGV, :destination => File.expand_path(Dir.pwd))
 

data/bin/sproutcore

@@ -35,4 +35,5 @@ source = RubiGen::PathSource.new(:application,
   File.join(File.dirname(__FILE__), "../app_generators"))
 RubiGen::Base.reset_sources
 RubiGen::Base.append_sources source
+RubiGen::Base.use_component_sources! [:sc, :app]
 RubiGen::Scripts::Generate.new.run(ARGV, :generator => 'sproutcore')

data/frameworks/sproutcore/Core.js

@@ -245,13 +245,17 @@ Object.extend(SC,{
     
     /** The current Firefox major version number or 0 if not Firefox */
     Firefox: function() {
+      var ret = 0;
       if (Prototype.Browser.Gecko) {
-        var ret = parseFloat((navigator.userAgent.match(/Firefox\/(.)/)[1]) || 0);
-        if (ret < 1) ret = 1;
-        return ret ;
-      } else return 0 ;
-    }(),
-    
+        if(navigator.userAgent.indexOf("Firefox") != -1)
+        {
+          ret = parseFloat((navigator.userAgent.match(/Firefox\/(.)/)[1]) || 0);
+        }
+        if (ret < 1) ret = 2; // default to version 2 if it is a Gecko browser.
+      } 
+      return ret ;
+    }(),    
+      
     isWindows: function() {
       return !!(navigator.appVersion.match(/(Windows)/)) ;
     }(),
@@ -365,11 +369,22 @@ Object.extend(Object,{
 // treat it like a bool setting.  Simplifies the common case where you need
 // to make a class name match a bool.
 Element.setClassName = function(element,className,flag) {
-  if (flag) { 
-    element.addClassName(className); 
-  } else {
-    element.removeClassName(className) ;
-  }
+  if(SC.isIE())
+  {
+    if (flag) { 
+      Element.addClassName(element,className); 
+    } else {
+      Element.removeClassName(element,className) ;
+    }
+  } 
+  else
+  {
+    if (flag) { 
+      element.addClassName(className); 
+    } else {
+      element.removeClassName(className) ;
+    }
+  } 
 } ;
 
 // ........................................

data/frameworks/sproutcore/HISTORY

@@ -1,5 +1,11 @@
 == GIT HEAD
 
+
+* SC.Platform.Firefox now returns 2 for any gecko browser that is not Firefox.
+
+* set() and a variety of other methods now returns this instead of the set
+value.  This makes it possible to do method chaining.
+
 == 0.9.8
 
 * [FIX] collection views now update group views appropriately.

data/frameworks/sproutcore/controllers/array.js

@@ -146,7 +146,7 @@ SC.ArrayController = SC.Controller.extend(SC.Array, SC.SelectionSupport,
     // create clone of content array if needed
     var contentClone = this.get('contentClone') ;
     if (!contentClone) {
-      contentClone = this.set('contentClone', content.clone());
+      this.set('contentClone', contentClone = content.clone()) ;
     }
 
     // now, record the removed objects.  This may be used later.

data/frameworks/sproutcore/drag/drag.js

@@ -501,8 +501,8 @@ SC.Drag = SC.Object.extend(
     return null ;
   },
   
-  // Search the parent nodes of the target to find another view matching the drop
-  // target.  Returns null if no matching target is found.
+  // Search the parent nodes of the target to find another view matching the 
+  // drop target.  Returns null if no matching target is found.
   _findNextDropTarget: function(target) {
     while ((target = target.parentNode) && (target != SC.window)) {
       if (SC.Drag._dropTargets[target._guid]) return target ;

data/frameworks/sproutcore/english.lproj/panes.css

@@ -34,7 +34,7 @@
 .sc-theme .pane .shadow {
 	position: relative ;
 	border: none ;
-	background: #e8e8e8 url('/static/sproutcore/_src/english.lproj/panels/background-thin.png') repeat-x left -1px; 
+	background: #e8e8e8 static_url('panels/background-thin.png') repeat-x left -1px; 
 	border-top: 1px #ddd solid;
 }
 

data/frameworks/sproutcore/english.lproj/theme.css

@@ -389,7 +389,7 @@ input.show-hint {
 	vertical-align: middle ;
 	position: relative ;
 	padding-left: 48px;
-	background: url('/static/sproutcore/_src/english.lproj/images/sc-theme-sprite.png') no-repeat ;
+	background: static_url('images/sc-theme-sprite.png') no-repeat ;
 }
 
 .sc-theme.blur .sc-slider-view,
@@ -404,7 +404,7 @@ input.show-hint {
 .sc-theme .sc-slider-view .outer {
 	display: block;
 	height: 18px;
-	background: url('/static/sproutcore/_src/english.lproj/images/sc-theme-sprite.png') no-repeat ;
+	background: static_url('images/sc-theme-sprite.png') no-repeat ;
 	padding-right: 48px;
 	position: relative ;
 }
@@ -421,7 +421,7 @@ input.show-hint {
 .sc-theme .sc-slider-view .inner {
 	display: block;
 	height: 18px;
-	background: url('/static/sproutcore/_src/english.lproj/images/sc-theme-sprite.png') repeat-x ;
+	background: static_url('images/sc-theme-sprite.png') repeat-x ;
 	width: 98px;
 	position: relative ;
 }
@@ -443,7 +443,7 @@ input.show-hint {
 	margin-left: -9px;
 	left:  50%;
 	top: 0;
-	background: url('/static/sproutcore/_src/english.lproj/images/sc-theme-sprite.png') no-repeat
+	background: static_url('images/sc-theme-sprite.png') no-repeat
 }
 
 .sc-theme.focus .sc-slider-view .sc-handle {

data/frameworks/sproutcore/foundation/binding.js

@@ -162,7 +162,8 @@ SC.Binding = SC.Object.extend({
       this._lastFromValue = value ;
       
       // send along to the 'from' source.
-      var result = tuple[0].set(tuple[1],value) ;
+      tuple[0].set(tuple[1],value) ;
+      var result = tuple[0].get(tuple[1]);
       if (result) this._lastFromPropertyRevision = result.propertyRevision ;
       
       // now that it has been set, the FROM object might not allow some 

data/frameworks/sproutcore/foundation/input_manager.js

@@ -50,7 +50,8 @@ SC.InputManager = SC.Object.extend(
         return responder[methodName]( event );
       }
     } 
-    if (chr && responder.respondsTo('insertText'))
+    // if(cmd == "space") chr = " ";
+    if ( chr && responder.respondsTo('insertText'))
     {
       // if we haven't returned yet and there is plain text, then do an insert of the text.
       return responder.insertText(chr);
@@ -132,7 +133,7 @@ SC.MODIFIER_KEYS = {
 
 SC.FUNCTION_KEYS = {
   8: 'backspace',  9: 'tab',  13: 'return',  19: 'pause',  27: 'escape',  
-  32: 'space',  33: 'pageup', 34: 'pagedown', 35: 'end', 36: 'home', 
+  33: 'pageup', 34: 'pagedown', 35: 'end', 36: 'home', 
   37: 'left', 38: 'up', 39: 'right', 40: 'down', 44: 'printscreen', 
   45: 'insert', 46: 'delete', 112: 'f1', 113: 'f2', 114: 'f3', 115: 'f4', 
   116: 'f5', 117: 'f7', 119: 'f8', 120: 'f9', 121: 'f10', 122: 'f11', 
@@ -140,12 +141,12 @@ SC.FUNCTION_KEYS = {
 } ;
 
 SC.PRINTABLE_KEYS = {
-  48:"0", 49:"1", 50:"2", 51:"3", 52:"4", 53:"5", 54:"6", 55:"7", 56:"8",
-  57:"9", 59:";", 61:"=", 65:"a", 66:"b", 67:"c", 68:"d", 69:"e", 70:"f",
-  71:"g", 72:"h", 73:"i", 74:"j", 75:"k", 76:"l", 77:"m", 78:"n", 79:"o",
-  80:"p", 81:"q", 82:"r", 83:"s", 84:"t", 85:"u", 86:"v", 87:"w", 88:"x",
-  89:"y", 90:"z", 107:"+", 109:"-", 110:".", 188:",", 190:".", 191:"/",
-  192:"`", 219:"[", 220:"\\", 221:"]", 222:"\""
+  32: ' ', 48:"0", 49:"1", 50:"2", 51:"3", 52:"4", 53:"5", 54:"6", 55:"7",
+  56:"8", 57:"9", 59:";", 61:"=", 65:"a", 66:"b", 67:"c", 68:"d", 69:"e",
+  70:"f", 71:"g", 72:"h", 73:"i", 74:"j", 75:"k", 76:"l", 77:"m", 78:"n",
+  79:"o", 80:"p", 81:"q", 82:"r", 83:"s", 84:"t", 85:"u", 86:"v", 87:"w",
+  88:"x", 89:"y", 90:"z", 107:"+", 109:"-", 110:".", 188:",", 190:".",
+  191:"/", 192:"`", 219:"[", 220:"\\", 221:"]", 222:"\""
 } ;
 
 // make reverse keycode lookup for using in unit tests...

data/frameworks/sproutcore/foundation/path_module.js

@@ -313,7 +313,7 @@ SC._PathModule = {
 
   // find first node with an attribute matching then named value.
   $P: function(el, attr, value, levels) {
-    var ret = SC._PathModule.$$A(el, attr, value,levels,1,false) ;
+    var ret = SC._PathModule.$$P(el, attr, value,levels,1,false) ;
     return (ret.length>0) ? ret[0] : null ;
   },
 

data/frameworks/sproutcore/lib/core_views.rb

@@ -114,7 +114,7 @@ view_helper :view do
   end
 
   # render the basic content
-  content { (@tag == 'img') ? ot : %(#{ot}#{@inner_html}#{ct}) }
+  content { (@tag == 'img') ? %(<#{@tag} #{attributes} />) : %(#{ot}#{@inner_html}#{ct}) }
   
 end
 
@@ -194,6 +194,8 @@ view_helper :image_view do
   property :content
   property :value
   
+  attribute :src, static_url('blank')
+  
   var :tag, 'img'
   css_class_names << 'sc-image-view'
 end

data/frameworks/sproutcore/lib/index.rhtml

@@ -8,8 +8,8 @@
    # See the comments in this file for more information on what you can
    # change.
 -%>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 <html>
   <head>
     <meta http-equiv="Content-type" content="text/html; charset=utf-8" />

data/frameworks/sproutcore/lib/menu_views.rb

@@ -39,6 +39,10 @@ end
 #   The icon for the menu item.  No icon will show if this is not set.
 #   
 # :shortcut =>
+#   You must pass the actualy bit of HTML you want to display as a keyboard
+#   shortcut
+#
+#   THE FOLLOWING PREVIOUS BEHAVIOR IS CURRENTLY DISABLED
 #   The shortcut key for this menu item.  Shortcuts are only active when
 #   the anchorview the popup menu is attached to is part of the in-focus
 #   pane.  Shortcuts should be named in the standard input manager
@@ -68,7 +72,8 @@ view_helper :menu_item_view, :extends => :button_view do
 
   # HTML
   var :tag, 'li'
-  var(:shortcut) { |sc| sc.split('_').map { |x| x.capitalize } * '-' }
+  var :shortcut
+  # var(:shortcut) { |sc| sc.split('_').map { |x| x.capitalize } * '-' }
   css_class_names << 'menu-item'
   
   @my_href = @href || 'javascript:;'

data/frameworks/sproutcore/mixins/observable.js

@@ -159,7 +159,38 @@ SC.Observable = {
   // used as properties.
 
   /**  
-    Use this to get a property value instead of obj.key.
+    Retrieves the value of key from the object.
+    
+    This method is generally very similar to using object[key] or object.key,
+    however it supports both computed properties and the unknownProperty
+    handler.
+    
+    *Computed Properties*
+    
+    Computed properties are methods defined with the property() modifier
+    declared at the end, such as:
+    
+    {{{
+      fullName: function() {
+        return this.getEach('firstName', 'lastName').compact().join(' ');
+      }.property('firstName', 'lastName')
+    }}}
+    
+    When you call get() on a computed property, the property function will be
+    called and the return value will be returned instead of the function
+    itself.
+    
+    *Unknown Properties*
+    
+    Likewise, if you try to call get() on a property whose values is
+    undefined, the unknownProperty() method will be called on the object.
+    If this method reutrns any value other than undefined, it will be returned
+    instead.  This allows you to implement "virtual" properties that are 
+    not defined upfront.
+    
+    @param key {String} the property to retrieve
+    @returns {Object} the property value or undefined.
+    
   */
   get: function(key) {
     var ret = this[key] ;
@@ -171,7 +202,51 @@ SC.Observable = {
   },
 
   /**  
-    use this to set a property value instead of obj.key = value.
+    Sets the key equal to value.
+    
+    This method is generally very similar to calling object[key] = value or
+    object.key = value, except that it provides support for computed 
+    properties, the unknownProperty() method and property observers.
+    
+    *Computed Properties*
+    
+    If you try to set a value on a key that has a computed property handler
+    defined (see the get() method for an example), then set() will call
+    that method, passing both the value and key instead of simply changing 
+    the value itself.  This is useful for those times when you need to 
+    implement a property that is composed of one or more member
+    properties.
+    
+    *Unknown Properties*
+    
+    If you try to set a value on a key that is undefined in the target 
+    object, then the unknownProperty() handler will be called instead.  This
+    gives you an opportunity to implement complex "virtual" properties that
+    are not predefined on the obejct.  If unknownProperty() returns 
+    undefined, then set() will simply set the value on the object.
+    
+    *Property Observers*
+    
+    In addition to changing the property, set() will also register a 
+    property change with the object.  Unless you have placed this call 
+    inside of a beginPropertyChanges() and endPropertyChanges(), any "local"
+    observers (i.e. observer methods declared on the same object), will be
+    called immediately.  Any "remote" observers (i.e. observer methods 
+    declared on another object) will be placed in a queue and called at a
+    later time in a coelesced manner.
+    
+    *Chaining*
+    
+    In addition to property changes, set() returns the value of the object
+    itself so you can do chaining like this:
+    
+    {{{
+      record.set('firstName', 'Charles').set('lastName', 'Jolley');
+    }}}
+    
+    @param key {String} the property to set
+    @param value {Object} the value to set or null.
+    @returns {this}
   */
   set: function(key, value) {
     var func = this[key] ;
@@ -188,31 +263,45 @@ SC.Observable = {
 
     // post out notifications.
     this.propertyDidChange(key, ret) ;
-    return ret ;
+    return this ;
   },  
 
   /**
-    sets the property only if the passed value is different from the
+    Sets the property only if the passed value is different from the
     current value.  Depending on how expensive a get() is on this property,
     this may be more efficient.
+    
+    @param key {String} the key to change
+    @param value {Object} the value to change
+    @returns {this}
   */
   setIfChanged: function(key, value) {
-    return (this.get(key) !== value) ? this.set(key, value) : value ;
+    return (this.get(key) !== value) ? this.set(key, value) : this ;
   },
   
   /**  
-    use this to automatically navigate a property path.
+    Navigates the property path, returning the value at that point.
+    
+    If any object in the path is undefined, returns undefined.
   */
   getPath: function(path) {
     var tuple = SC.Object.tupleForPropertyPath(path, this) ;
-    if (tuple[0] == null) return null ;
+    if (tuple[0] === null) return undefined ;
     return tuple[0].get(tuple[1]) ;
   },
   
+  /**
+    Navigates the property path, finally setting the value.
+    
+    @param path {String} the property path to set
+    @param value {Object} the value to set
+    @returns {this}
+  */
   setPath: function(path, value) {
     var tuple = SC.Object.tupleForPropertyPath(path, this) ;
     if (tuple[0] == null) return null ;
-    return tuple[0].set(tuple[1], value) ;
+    tuple[0].set(tuple[1], value) ;
+    return this;
   },
 
   
@@ -241,7 +330,8 @@ SC.Observable = {
     @returns {Number} new value of property
   */
   incrementProperty: function(key) { 
-    return this.set(key,(this.get(key) || 0)+1); 
+    this.set(key,(this.get(key) || 0)+1); 
+    return this.get(key) ;
   },
 
   /**  
@@ -251,7 +341,8 @@ SC.Observable = {
     @returns {Number} new value of property
   */
   decrementProperty: function(key) {
-    return this.set(key,(this.get(key) || 0) - 1 ) ;
+    this.set(key,(this.get(key) || 0) - 1 ) ;
+    return this.get(key) ;
   },
 
   /**  
@@ -266,7 +357,8 @@ SC.Observable = {
     if (value === undefined) value = true ;
     if (alt == undefined) alt = false ;
     value = (this.get(key) == value) ? alt : value ;
-    return this.set(key,value);
+    this.set(key,value);
+    return this.get(key) ;
   },
 
   /**  
@@ -275,6 +367,10 @@ SC.Observable = {
     This is a generic property handler.  If you define it, it will be called
     when the named property is not yet set in the object.  The default does
     nothing.
+    
+    @param key {String} the key that was requested
+    @param value {Object} The value if called as a setter, undefined if called as a getter.
+    @returns {Object} The new value for key.
   */
   unknownProperty: function(key,value) {
     if (!(value === undefined)) { this[key] = value; }
@@ -313,10 +409,11 @@ SC.Observable = {
     When you are done making changes, all endPropertyChanges() to allow 
     notification to resume.
     
-    @returns {void}
+    @returns {this}
   */
   beginPropertyChanges: function() {
     this._kvo().changes++ ;
+    return this;
   },
 
   /**  
@@ -329,11 +426,12 @@ SC.Observable = {
     notifications. When you are done making changes, call this method to allow 
     notification to resume.
     
-    @returns {void}
+    @returns {this}
   */
   endPropertyChanges: function() {
     var kvo = this._kvo() ;  kvo.changes--;
     if (kvo.changes <= 0) this._notifyPropertyObservers() ;
+    return this ;
   },
 
   /**  
@@ -350,10 +448,11 @@ SC.Observable = {
     and cause notifications to be delivered more often than you would like.
     
     @param key {String} The property key that is about to change.
-    @returns {void}
+    @returns {this}
   */
   propertyWillChange: function(key) {
     this._kvo().changes++ ;
+    return this ;
   },
 
   /**  
@@ -371,12 +470,13 @@ SC.Observable = {
     
     @param key {String} The property key that has just changed.
     @param value {Object} The new value of the key.  May be null.
-    @returns {void}
+    @returns {this}
   */
   propertyDidChange: function(key,value) {
     this._kvo().changed[key] = value ;
     var kvo = this._kvo() ;  kvo.changes--; kvo.revision++ ;
     if (kvo.changes <= 0) this._notifyPropertyObservers() ;
+    return this ;
   },
 
   /**
@@ -389,11 +489,12 @@ SC.Observable = {
     
     @param key {String} The property key that has just changed.
     @param value {Object} The new value of the key.  May be null.
-    @returns {void}
+    @returns {this}
   */
   notifyPropertyChange: function(key, value) {
     this.propertyWillChange(key) ;
     this.propertyDidChange(key, value) ;
+    return this; 
   },
   
   /**  
@@ -406,10 +507,11 @@ SC.Observable = {
     In those cases, you can simply call this method to notify all property
     observers immediately.  Note that this ignores property groups.
     
-    @returns {void}
+    @returns {this}
   */
   allPropertiesDidChange: function() {
     this._notifyPropertyObservers(true) ;
+    return this ;
   },
 
   /**