sproutcore 1.5.0-java → 1.6.0.beta.2-java

data/lib/frameworks/sproutcore/frameworks/experimental/frameworks/designer/ext/object.js

@@ -20,8 +20,9 @@ SC.Object.prototype.emitDesign = function() {
 
 
 /** 
-  Patch SC.Object to respond to encodeDesign().  This will proxy to the paired
-  designer, if there is one.  If there is no paired designer, returns NO.
+  Patch `SC.Object` to respond to `encodeDesign()`.  This will proxy to the
+  paired designer, if there is one.  If there is no paired designer, returns
+  `NO`.
 */
 SC.Object.prototype.encodeDesign = function(coder) {
   return this.designer ? this.designer.encodeDesign(coder) : NO ;

data/lib/frameworks/sproutcore/frameworks/experimental/frameworks/designer/ext/page.js

@@ -7,7 +7,7 @@
 
 
 /** 
-  Extend SC.Page to emit a design document for the entire page.
+  Extend `SC.Page` to emit a design document for the entire page.
 */
 SC.Page.prototype.emitDesign = function() {
 
@@ -30,7 +30,7 @@ SC.Page.prototype.emitDesign = function() {
 };
 
 /**
-  Extend SC.Page to create a PageDesignController on demand.
+  Extend `SC.Page` to create a `PageDesignController` on demand.
   
   @property {SC.PageDesignController}
 */

data/lib/frameworks/sproutcore/frameworks/experimental/frameworks/designer/ext/view.js

@@ -9,7 +9,7 @@
 /*jslint evil:true */
 
 /** 
-  Extend SC.View with emitDesign() which will encode the view and all of its
+  Extend `SC.View` with `emitDesign()` which will encode the view and all of its
   subviews then computes an empty element to attach to the design.
 */
 SC.View.prototype.emitDesign = function() {
@@ -21,8 +21,9 @@ SC.View.prototype.emitDesign = function() {
 };
 
 /** 
-  Patch SC.View to respond to encodeDesign().  This will proxy to the paired
-  designer, if there is one.  If there is no paired designer, returns NO.
+  Patch `SC.View` to respond to `encodeDesign()`.  This will proxy to the
+  paired designer, if there is one.  If there is no paired designer, returns
+  `NO`.
 */
 SC.View.prototype.encodeDesign = function(coder) {
   return this.designer ? this.designer.encodeDesign(coder) : NO ;

data/lib/frameworks/sproutcore/frameworks/experimental/frameworks/designer/mixins/snap_lines.js

@@ -39,8 +39,8 @@ SC.SnapLines = {
   
   /*
     This method will setup the datastructure required to draw snap lines
-    it should be called in dragStarted if using with an SC.Drag or on mouseDown
-    if using it with a move
+    it should be called in dragStarted if using with an `SC.Drag` or on
+    `mouseDown` if using it with a move
   
     @param {Array} ignoreViews array of views to not include
     sets up the data structure used for the line drawing
@@ -121,9 +121,9 @@ SC.SnapLines = {
   
   /**
     This method will check the passed views position with the other child views
-    and draw any lines.  It should be called in dragUpdated if using SC.Drag
-    or in mouseMoved if using a move.  it will also return a hash of the snapped coords
-    in local and global coodinates
+    and draw any lines.  It should be called in `dragUpdated` if using `SC.Drag`
+    or in `mouseMoved` if using a move.  it will also return a hash of the
+    snapped coords in local and global coodinates
     
   */
   drawLines: function(view, eventX, eventY, mouseDownX, mouseDownY){
@@ -200,7 +200,8 @@ SC.SnapLines = {
   
   /*
     called to cleanup the lines...
-    This method should be called in mouseUp if doing a move and in dragEnded if using a SC.Drag
+    This method should be called in `mouseUp` if doing a move and in
+    `dragEnded` if using a `SC.Drag`.
   */
   removeLines: function() {
     this._xPositions = null;

data/lib/frameworks/sproutcore/frameworks/experimental/frameworks/designer/views/designer_drop_target.js

@@ -92,12 +92,12 @@ SC.DesignerDropTarget = SC.ContainerView.extend(
     Called to actually perform the drag operation.
     
     Overide this method to actually perform the drag operation.  This method
-    is only called if you returned YES in acceptDragOperation(). 
+    is only called if you returned `YES` in `acceptDragOperation()`.
     
-    Return the operation that was actually performed or SC.DRAG_NONE if the 
+    Return the operation that was actually performed or `SC.DRAG_NONE` if the
     operation was aborted.
     
-    The default implementation returns SC.DRAG_NONE
+    The default implementation returns `SC.DRAG_NONE`
     
     @param {SC.Drag} drag The drag instance managing this drag
     @param {DragOp} op The proposed drag operation. A drag constant.

data/lib/frameworks/sproutcore/frameworks/experimental/frameworks/designer/views/drawing.js

@@ -3,55 +3,62 @@
   This is a Drawing View:
   If you want to draw a new shape you can pass in the information:
   For a Line:
-    {
-      +shape: SC.LINE,
-      +start: {x: 0, y: 0},
-      +end: {x: 100, y: 100},
-      ?style: {
-        ?width: 5,
-        ?color: 'orange' | '#FFA500' | 'rgb(255,165,0)' | 'rgba(255,165,0,1)'
-        ?transparency: 0.2
+
+      {
+        +shape: SC.LINE,
+        +start: {x: 0, y: 0},
+        +end: {x: 100, y: 100},
+        ?style: {
+          ?width: 5,
+          ?color: 'orange' | '#FFA500' | 'rgb(255,165,0)' | 'rgba(255,165,0,1)'
+          ?transparency: 0.2
+        }
       }
-    }
+
   For a Rectangle:
-    {
-      +shape: SC.RECT,
-      +start: {x: 0, y: 0},
-      +size: {width: 100, height: 100},
-      ?type: SC.FILL | SC.STROKE
-      ?style: {
-        ?width: 5,
-        ?color: 'orange' | '#FFA500' | 'rgb(255,165,0)' | 'rgba(255,165,0,1)'
-        ?transparency: 0.2
+
+      {
+        +shape: SC.RECT,
+        +start: {x: 0, y: 0},
+        +size: {width: 100, height: 100},
+        ?type: SC.FILL | SC.STROKE
+        ?style: {
+          ?width: 5,
+          ?color: 'orange' | '#FFA500' | 'rgb(255,165,0)' | 'rgba(255,165,0,1)'
+          ?transparency: 0.2
+        }
       }
-    }
+
   For a Circle:
-    {
-      +shape: SC.CIRCLE,
-      +center: {x: 0, y: 0},
-      +radius: 20,
-      ?type: SC.FILL | SC.STROKE
-      ?style: {
-        ?width: 5,
-        ?color: 'orange' | '#FFA500' | 'rgb(255,165,0)' | 'rgba(255,165,0,1)'
-        ?transparency: 0.2
+
+      {
+        +shape: SC.CIRCLE,
+        +center: {x: 0, y: 0},
+        +radius: 20,
+        ?type: SC.FILL | SC.STROKE
+        ?style: {
+          ?width: 5,
+          ?color: 'orange' | '#FFA500' | 'rgb(255,165,0)' | 'rgba(255,165,0,1)'
+          ?transparency: 0.2
+        }
       }
-    }
+
   For a Polygon:
-    {
-      +shape: SC.POLY
-      +path: [
-        +{x: 0, y: 0},
-        +{x: 10, y: 10},
-        ?{x: 0, y: 50}
-      ],
-      ?type: SC.FILL | SC.STROKE
-      ?style: {
-        ?width: 5,
-        ?color: 'orange' | '#FFA500' | 'rgb(255,165,0)' | 'rgba(255,165,0,1)'
-        ?transparency: 0.2
+
+      {
+        +shape: SC.POLY
+        +path: [
+          +{x: 0, y: 0},
+          +{x: 10, y: 10},
+          ?{x: 0, y: 50}
+        ],
+        ?type: SC.FILL | SC.STROKE
+        ?style: {
+          ?width: 5,
+          ?color: 'orange' | '#FFA500' | 'rgb(255,165,0)' | 'rgba(255,165,0,1)'
+          ?transparency: 0.2
+        }
       }
-    }
   
   @author Evin Grano 
   @extends SC.View

data/lib/frameworks/sproutcore/frameworks/experimental/frameworks/designer/views/high_light.js

@@ -4,7 +4,7 @@
 
 /**
   This View is used by Greenhouse when application is in design mode
-  It darkens the area around the rootDesigner
+  It darkens the area around the `rootDesigner`
 */
 SC.RootDesignerHighLightView = SC.View.extend(
 /** @scope SC.RootDesignerHighLight.prototype */ {

data/lib/frameworks/sproutcore/frameworks/experimental/frameworks/designer/views/page_item_view.js

@@ -5,7 +5,7 @@
 
 /** @class
   This View is used by Greenhouse when application is in design mode
-	Used for displaying page items
+  Used for displaying page items
 
   @extends SC.ListItemVIew
   @author Mike Ball
@@ -39,7 +39,7 @@ SC.pageItemView = SC.ListItemView.extend(
    droppable area, the drag will latch onto the deepest view that returns one 
    or more available operations.
 
-   The default implementation returns SC.DRAG_NONE
+   The default implementation returns `SC.DRAG_NONE`
 
    @param {SC.Drag} drag The current drag object
    @param {SC.Event} evt The most recent mouse move event.  Use to get 
@@ -62,7 +62,7 @@ SC.pageItemView = SC.ListItemView.extend(
    perform fine-grained checks on the drop location, for example.
    Return true to accept the drop operation.
 
-   The default implementation returns YES.
+   The default implementation returns `YES`.
 
    @param {SC.Drag} drag The drag instance managing this drag
    @param {DragOp} op The proposed drag operation. A drag constant
@@ -75,12 +75,12 @@ SC.pageItemView = SC.ListItemView.extend(
    Called to actually perform the drag operation.
 
    Overide this method to actually perform the drag operation.  This method
-   is only called if you returned YES in acceptDragOperation(). 
+   is only called if you returned `YES` in `acceptDragOperation()`.
 
-   Return the operation that was actually performed or SC.DRAG_NONE if the 
+   Return the operation that was actually performed or `SC.DRAG_NONE` if the
    operation was aborted.
 
-   The default implementation returns SC.DRAG_NONE
+   The default implementation returns `SC.DRAG_NONE`
 
    @param {SC.Drag} drag The drag instance managing this drag
    @param {DragOp} op The proposed drag operation. A drag constant.

data/lib/frameworks/sproutcore/frameworks/experimental/frameworks/device_motion/device.js

@@ -8,7 +8,7 @@
 sc_require('platform');
 
 /**
-  h1. Device Motion
+  ## Device Motion
   
   When a device is moved, some platforms will inform us of its movement
   (accelerometer) and angle (gyroscope). 

data/lib/frameworks/sproutcore/frameworks/{forms → experimental/frameworks/forms}/views/form.js

@@ -15,19 +15,18 @@ just children; they are explicity stated in the array fields, which works
 just like childViews, but marks fields to be laid out automatically.
 
 Usually, you will place rows into the FormView:
-{{{
-childViews: "fullName gender".w(),
-contentBinding: 'MyApp.personController',
 
-fullName: SC.FormView.row("Name:", SC.TextFieldView.extend({
-  layout: {height: 20, width: 150}
-})),
+    childViews: "fullName gender".w(),
+    contentBinding: 'MyApp.personController',
 
-gender: SC.FormView.row("Gender:", SC.RadioView.design({
-  layout: {width: 150, height: 40, centerY: 0},
-  items: ["male", "female"]
-}))
-}}}
+    fullName: SC.FormView.row("Name:", SC.TextFieldView.extend({
+      layout: {height: 20, width: 150}
+    })),
+
+    gender: SC.FormView.row("Gender:", SC.RadioView.design({
+      layout: {width: 150, height: 40, centerY: 0},
+      items: ["male", "female"]
+    }))
 
 The name of the row (ie. 'fullName'), is passed down to the *FieldView, and used as the key
 to bind the value property to the content. In this case it will bind content.fullName to the
@@ -39,7 +38,7 @@ view, including other FormViews or subclasses of FormView.
 This is important, because this is how you make nice rows that have a
 label and a field: these rows are actually subclasses of FormView itself.
 
-h2. Editing
+## Editing
 The form does not allow editing by default; editing must be started by calling
 beginEditing.
 
@@ -258,9 +257,9 @@ SC.mixin(SC.FormView, {
   /**
   Creates a form row.
 
-  Can be called in two ways: row(optionalClass, properties), which creates
+  Can be called in two ways: `row(optionalClass, properties)`, which creates
   a field with the properties, and puts it in a new row;
-  and row(properties), which creates a new row—and it is up to you to add
+  and `row(properties)`, which creates a new row—and it is up to you to add
   any fields you want in the row.
   
   You can also supply some properties to extend the row itself with.

data/lib/frameworks/sproutcore/frameworks/experimental/frameworks/polymorphism/models/record.js

@@ -19,13 +19,11 @@
       If YES, then searches for records of this type will return
       subclass instances. For example:
 
-      {{{
-        Person = SC.Record.extend();
-        Person.isPolymorphic = YES;
+          Person = SC.Record.extend();
+          Person.isPolymorphic = YES;
 
-        Male = Person.extend();
-        Female = Person.extend();
-      }}}
+          Male = Person.extend();
+          Female = Person.extend();
 
       Using SC.Store#find, or a toOne or toMany relationship on
       Person will then return records of type Male and Female.

data/lib/frameworks/sproutcore/frameworks/foundation/mixins/static_layout.js

@@ -7,7 +7,6 @@
 
 /**
   @namespace 
-  @deprecated
 
   SC.StaticLayout is now built in to SC.View.  You do not need to 
   apply this mixin to use static layout.  Just set useStaticLayout to YES.

data/lib/frameworks/sproutcore/frameworks/foundation/private/tree_item_observer.js

@@ -213,7 +213,7 @@ SC.TreeItemObserver = SC.Object.extend(SC.Array, SC.CollectionContent, {
     range you replace must lie entirely within the same parent item, otherwise
     this will raise an exception.
 
-    h3. The Operation Parameter
+    ### The Operation Parameter
 
     Note that this replace method accepts an additional parameter "operation"
     which is used when you try to insert an item on a boundary between
@@ -225,9 +225,7 @@ SC.TreeItemObserver = SC.Object.extend(SC.Array, SC.CollectionContent, {
     index where you expect the item to be inserted.  For example, if you want
     to insert AFTER the last index of an 3-item array, you would still call:
 
-    {{{
-      observer.replace(3, 0, [object1 .. objectN], SC.DROP_AFTER)
-    }}}
+        observer.replace(3, 0, [object1 .. objectN], SC.DROP_AFTER)
 
     The operation is simply used to disambiguate whether the insertion is
     intended to be AFTER the previous item or BEFORE the items you are

data/lib/frameworks/sproutcore/frameworks/foundation/system/image_queue.js

@@ -23,17 +23,15 @@ SC.IMAGE_FAILED_ERROR = SC.$error("SC.Image.FailedError", "Image", -101) ;
   Note that if you use the SC.ImageView class, it will use this image queue 
   for you automatically.
   
-  h1. Loading Images
+  ## Loading Images
   
   When you need to display an image, simply call the loadImage() method with 
   the URL of the image, along with a target/method callback. The signature of 
   your callback should be:
   
-  {{{
-    imageDidLoad: function(imageUrl, imageOrError) {
-      //...
-    }
-  }}}
+      imageDidLoad: function(imageUrl, imageOrError) {
+        //...
+      }
 
   The "imageOrError" parameter will contain either an image object or an error 
   object if the image could not be loaded for some reason.  If you receive an 
@@ -44,7 +42,7 @@ SC.IMAGE_FAILED_ERROR = SC.$error("SC.Image.FailedError", "Image", -101) ;
   background.  Background images are loaded with a lower priority than 
   foreground images.
   
-  h1. Aborting Image Loads
+  ## Aborting Image Loads
   
   If you request an image load but then no longer require the image for some 
   reason, you should notify the imageQueue by calling the releaseImage() 
@@ -59,7 +57,7 @@ SC.IMAGE_FAILED_ERROR = SC.$error("SC.Image.FailedError", "Image", -101) ;
   or it may abort an image load in progress to make room for other images.  If 
   the image is already loaded, this method will have no effect.
   
-  h1. Reloading an Image
+  ## Reloading an Image
   
   If you have already loaded an image, the imageQueue will avoid loading the 
   image again.  However, if you need to force the imageQueue to reload the 
@@ -95,10 +93,8 @@ SC.imageQueue = SC.Object.create(/** @scope SC.imageQueue.prototype */ {
     notified when the image has loaded.  Your callback should have a signature 
     like:
 
-    {{{
-      imageDidLoad: function(imageUrl, imageOrError) { .. }
-    }}}
-    
+        imageDidLoad: function(imageUrl, imageOrError) { .. }
+
     If you do pass a target/method you can optionally also choose to load the 
     image either in the foreground or in the background.  The imageQueue 
     prioritizes foreground images over background images.  This does not impact