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

data/lib/frameworks/sproutcore/frameworks/desktop/panes/modal.js

@@ -14,8 +14,8 @@
   panes.
   
   A modal pane is automatically appended when a pane with isModal set to
-  YES is made visible and removed when the same pane is hidden.  The only
-  purpose of the ModalPane is to absorb mouse events so that they cannot
+  `YES` is made visible and removed when the same pane is hidden.  The only
+  purpose of the `ModalPane` is to absorb mouse events so that they cannot
   filter through to the underlying content.
   
   @extends SC.Pane
@@ -50,7 +50,7 @@ SC.ModalPane = SC.Pane.extend(
   /** @private
     Called by a pane just after it removes itself.  The modal pane can remove
     itself if needed.   Modal panes only remove themselves when an equal 
-    number of paneWillAppend() and paneDidRemove() calls are received.
+    number of `paneWillAppend()` and `paneDidRemove()` calls are received.
   
     @param {SC.Pane} pane the pane
     @returns {SC.ModalPane} receiver

data/lib/frameworks/sproutcore/frameworks/desktop/panes/panel.js

@@ -124,7 +124,7 @@ SC.PanelPane = SC.Pane.extend(
   //
 
   /**
-    The name of the theme's SC.PanelPane render delegate.
+    The name of the theme's `SC.PanelPane` render delegate.
 
     @type String
     @default 'panelRenderDelegate'

data/lib/frameworks/sproutcore/frameworks/desktop/panes/select_button.js

@@ -10,7 +10,7 @@ sc_require('views/button');
 /**
   @class
 
-  SelectButtonView has a functionality similar to that of SelectField
+  SelectButtonView has a functionality similar to that of `SelectField`
 
   Clicking the SelectButtonView button displays a menu pane with a
   list of items. The selected item will be displayed on the button.
@@ -43,7 +43,7 @@ SC.SelectButtonView = SC.ButtonView.extend(
   /**
     If you set this to a non-null value, then the name shown for each
     menu item will be pulled from the object using the named property.
-    if this is null, the collection objects themselves will be used.
+    if this is `null`, the collection objects themselves will be used.
 
     @type String
     @default: null
@@ -52,7 +52,7 @@ SC.SelectButtonView = SC.ButtonView.extend(
 
   /**
     If you set this to a non-null value, then the value of this key will
-    be used to sort the objects.  If this is not set, then nameKey will
+    be used to sort the objects.  If this is not set, then `nameKey` will
     be used.
 
     @property String}
@@ -111,7 +111,7 @@ SC.SelectButtonView = SC.ButtonView.extend(
   classNames: ['select-button'],
 
   /**
-    Menu attached to the selectButton
+    Menu attached to the `selectButton`
     
     @type SC.View
     @default SC.MenuView
@@ -128,7 +128,7 @@ SC.SelectButtonView = SC.ButtonView.extend(
 
   /**
     Property to set the index of the selected menu item. This in turn
-    is used to calculate the preferMatrix.
+    is used to calculate the `preferMatrix`.
 
     @type Number
     @default null
@@ -144,7 +144,7 @@ SC.SelectButtonView = SC.ButtonView.extend(
   value: null,
 
   /**
-    if this property is set to 'YES', a checbox is shown next to the
+    if this property is set to `YES`, a checbox is shown next to the
     selected menu item.
 
     @type Boolean
@@ -161,19 +161,19 @@ SC.SelectButtonView = SC.ButtonView.extend(
 
   /** @private
     Default value of the select button.
-     This will be the first item from the menu item list.
+    This will be the first item from the menu item list.
   */
   _defaultVal: null,
 
   /** @private
     Default title of the select button.
-     This will be the title corresponding to the _defaultVal.
+    This will be the title corresponding to the _defaultVal.
   */
   _defaultTitle: null,
 
   /** @private
     Default icon of the select button.
-     This will be the icon corresponding to the _defaultVal.
+    This will be the icon corresponding to the _defaultVal.
   */
   _defaultIcon: null,
 
@@ -194,8 +194,8 @@ SC.SelectButtonView = SC.ButtonView.extend(
   /**
     Prefer matrix to position the select button menu such that the
     selected item for the menu item will appear aligned to the
-    the button. The value at the second index(0) changes based on the
-    postion(index) of the menu item in the menu pane.
+    the button. The value at the second `index(0)` changes based on the
+    `postion(index)` of the menu item in the menu pane.
 
     @type Array
     @default null
@@ -204,8 +204,8 @@ SC.SelectButtonView = SC.ButtonView.extend(
 
   /**
     Width of the sprite image that gets applied due to the theme.
-     This has to be accounted for while calculating the actual
-     width of the button
+    This has to be accounted for while calculating the actual
+    width of the button
 
     @type Number
     @default 28
@@ -218,7 +218,7 @@ SC.SelectButtonView = SC.ButtonView.extend(
   isActiveBinding: '*menu.isVisibleInWindow',
 
   /** @private
-    If this property is set to 'YES', the menu pane will be positioned
+    If this property is set to `YES`, the menu pane will be positioned
     below the anchor.
   */
   isDefaultPosition: NO,
@@ -270,7 +270,7 @@ SC.SelectButtonView = SC.ButtonView.extend(
 
   /**
     This is a property to enable/disable focus rings in buttons.
-    For select_button we are making it a default.
+    For `select_button` we are making it a default.
     
     @type Boolean
     @default YES
@@ -305,7 +305,7 @@ SC.SelectButtonView = SC.ButtonView.extend(
 
   /**
     override this method to implement your own sorting of the menu. By
-    default, menu items are sorted using the value shown or the sortKey
+    default, menu items are sorted using the value shown or the `sortKey`
 
     @param {SC.Array} objects the unsorted array of objects to display.
     @returns sorted array of objects
@@ -650,28 +650,28 @@ SC.SelectButtonView = SC.ButtonView.extend(
     switch (this.get('controlSize')) {
       case SC.TINY_CONTROL_SIZE:
         controlSizeTuning = SC.SelectButtonView.TINY_OFFSET_Y;
-        customMenuItemHeight = SC.MenuPane.TINY_MENU_ITEM_HEIGHT;
-        customSeparatorHeight = SC.MenuPane.TINY_MENU_ITEM_SEPARATOR_HEIGHT;
+        customMenuItemHeight = SC.SelectButtonView.TINY_OFFSET_Y;
+        customSeparatorHeight = SC.SelectButtonView.TINY_POPUP_MENU_WIDTH_OFFSET;
         break;
       case SC.SMALL_CONTROL_SIZE:
         controlSizeTuning = SC.SelectButtonView.SMALL_OFFSET_Y;
-        customMenuItemHeight = SC.MenuPane.SMALL_MENU_ITEM_HEIGHT;
-        customSeparatorHeight = SC.MenuPane.SMALL_MENU_ITEM_SEPARATOR_HEIGHT;
+        customMenuItemHeight = SC.SelectButtonView.SMALL_OFFSET_Y;
+        customSeparatorHeight = SC.SelectButtonView.SMALL_POPUP_MENU_WIDTH_OFFSET;
         break;
       case SC.REGULAR_CONTROL_SIZE:
         controlSizeTuning = SC.SelectButtonView.REGULAR_OFFSET_Y;
-        customMenuItemHeight = SC.MenuPane.REGULAR_MENU_ITEM_HEIGHT;
-        customSeparatorHeight = SC.MenuPane.REGULAR_MENU_ITEM_SEPARATOR_HEIGHT;
+        customMenuItemHeight = SC.SelectButtonView.REGULAR_OFFSET_Y;
+        customSeparatorHeight = SC.SelectButtonView.REGULAR_POPUP_MENU_WIDTH_OFFSET;
         break;
       case SC.LARGE_CONTROL_SIZE:
         controlSizeTuning = SC.SelectButtonView.LARGE_OFFSET_Y;
-        customMenuItemHeight = SC.MenuPane.LARGE_MENU_ITEM_HEIGHT;
-        customSeparatorHeight = SC.MenuPane.LARGE_MENU_ITEM_SEPARATOR_HEIGHT;
+        customMenuItemHeight = SC.SelectButtonView.LARGE_OFFSET_Y;
+        customSeparatorHeight = SC.SelectButtonView.LARGE_POPUP_MENU_WIDTH_OFFSET;
         break;
       case SC.HUGE_CONTROL_SIZE:
         controlSizeTuning = SC.SelectButtonView.HUGE_OFFSET_Y;
-        customMenuItemHeight = SC.MenuPane.HUGE_MENU_ITEM_HEIGHT;
-        customSeparatorHeight = SC.MenuPane.HUGE_MENU_ITEM_SEPARATOR_HEIGHT;
+        customMenuItemHeight = SC.SelectButtonView.HUGE_OFFSET_Y;
+        customSeparatorHeight = SC.SelectButtonView.HUGE_POPUP_MENU_WIDTH_OFFSET;
         break;
     }
 
@@ -735,8 +735,8 @@ SC.SelectButtonView = SC.ButtonView.extend(
   },
 
   /** @private
-    Because we responded YES to the mouseDown event, we have responsibility
-    for handling the corresponding mouseUp event.
+    Because we responded `YES` to the mouseDown event, we have responsibility
+    for handling the corresponding `mouseUp` event.
 
     However, the user may click on this button, then drag the mouse down to a
     menu item, and release the mouse over the menu item. We therefore need to
@@ -762,7 +762,7 @@ SC.SelectButtonView = SC.ButtonView.extend(
 
       if (targetMenuItem && targetMenuItem.get('mouseHasEntered')) {
         // Have the menu item perform its action.
-        // If the menu returns NO, it had no action to
+        // If the menu returns `NO`, it had no action to
         // perform, so we should close the menu immediately.
         if (!targetMenuItem.performAction()) menu.remove();
       } else if (!touch && (timestamp - previousTimestamp > SC.ButtonView.CLICK_AND_HOLD_DELAY)) {

data/lib/frameworks/sproutcore/frameworks/desktop/panes/sheet.js

@@ -104,7 +104,7 @@ SC.SheetPane = SC.PanelPane.extend(
     @returns {SC.SheetPane} receiver
   */
   remove: function() {
-    // We want the functionality of SC.PanelPane.remove(), but we only want it once the animation is complete.
+    // We want the functionality of `SC.PanelPane.remove()`, but we only want it once the animation is complete.
     // Store the reference to the superclass function, and it call it after the transition is complete.
     var that = this, args = arguments;
     this.invokeLater(function() { args.callee.base.apply(that, args) ;}, this.transitionDuration);

data/lib/frameworks/sproutcore/frameworks/desktop/protocols/drag_source.js

@@ -22,7 +22,7 @@ SC.DragSource = {
     specified target.  If you don't care about the target, just return a
     constant value.
     
-    The default implementation returns SC.DRAG_NONE
+    The default implementation returns `SC.DRAG_NONE`
     
     @param {SC.View} dropTarget The proposed target of the drop.
     @param {SC.Drag} drag The SC.Drag instance managing this drag.
@@ -32,7 +32,7 @@ SC.DragSource = {
   },
   
   /**
-    If this property is set to NO or is not implemented, then the user may
+    If this property is set to `NO` or is not implemented, then the user may
     modify the drag operation by changing the modifier keys they have 
     pressed.
     
@@ -55,7 +55,7 @@ SC.DragSource = {
   
   /**
     This method is called whenever the drag image is moved.  This is
-    similar to the dragUpdated() method called on drop targets.
+    similar to the `dragUpdated()` method called on drop targets.
     
     @param {SC.Drag} drag The Drag instance managing this drag.
     @param {Point} loc  The point in *window* coordinates where the drag 

data/lib/frameworks/sproutcore/frameworks/desktop/protocols/drop_target.js

@@ -67,7 +67,7 @@ SC.DropTarget = {
   
   /**
     Called when the drag first enters the droppable area, if it returns a
-    drag operations other than SC.DRAG_NONE.
+    drag operations other than `SC.DRAG_NONE`.
     
     The default implementation does nothing.
     
@@ -132,7 +132,7 @@ SC.DropTarget = {
     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 
@@ -153,7 +153,7 @@ SC.DropTarget = {
     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
@@ -168,12 +168,12 @@ SC.DropTarget = {
     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/desktop/protocols/responder.js

@@ -12,7 +12,7 @@
   specific responder method, and a method with the correct signature to your
   class.
   
-  DO NOT INCLUDE THIS MIXIN.
+  **DO NOT INCLUDE THIS MIXIN**.
   
   If you try and include this mixin, an error will be raised on startup.
   
@@ -26,7 +26,7 @@ SC.ResponderProtocol = {
   //
   
   /**
-    Called when the mouse is pressed. You must return YES to recieve 
+    Called when the mouse is pressed. You must return `YES` to recieve
     mouseDragged and mouseUp in the future.
     
     @param evt {SC.Event} the mousedown event
@@ -43,7 +43,7 @@ SC.ResponderProtocol = {
   mouseUp: function(evt) {},
   
   /**
-    Called when the mouse is dragged, after responding YES to a previous mouseDown:
+    Called when the mouse is dragged, after responding `YES` to a previous `mouseDown`:
     call.
     
     @param evt {SC.Event} the mousemove event
@@ -80,7 +80,7 @@ SC.ResponderProtocol = {
   
   
   /**
-    Called when a selectstart event in IE is triggered. ONLY IE
+    Called when a selectstart event in IE is triggered. **ONLY IE**
     We use it to disable IE accelerators and text selection
     
     @param evt {SC.Event} the selectstart event

data/lib/frameworks/sproutcore/frameworks/desktop/render_delegates/checkbox.js

@@ -18,12 +18,12 @@
   --------------------------
   Expects these properties on the data source:
   
-  - isSelected
-  - isActive
-  - isEnabled
-  - title
+   - `isSelected`
+   - `isActive`
+   - `isEnabled`
+   - `title`
   
-  Optional parameters include all parameters for the labelRenderDelegate.
+  Optional parameters include all parameters for the `labelRenderDelegate`.
   
 */
 SC.BaseTheme.checkboxRenderDelegate = SC.RenderDelegate.create({

data/lib/frameworks/sproutcore/frameworks/desktop/render_delegates/master_detail.js

@@ -9,7 +9,7 @@
 /**
   Border between the two panes of the MasterDetail.
 
-  Note that the border does NOT include any space on the sides. Space
+  Note that the border does *NOT* include any space on the sides. Space
   on left or right sides of MasterDetail, if any, should be handled by
   its layout.
  */

data/lib/frameworks/sproutcore/frameworks/desktop/render_delegates/progress.js

@@ -12,14 +12,14 @@
   --------------------------
   Expects these properties on the data source:
   
-  - isIndeterminate
-  - isRunning
-  - isEnabled
-  - value
+   - `isIndeterminate`
+   - `isRunning`
+   - `isEnabled`
+   - `value`
   
   Theme Constants
   -------------------------------------
-  Ace's progressRenderDelegate's rendering process is not affected by 
+  Ace's `progressRenderDelegate`'s rendering process is not affected by
   any theme constants.
 */
 SC.BaseTheme.progressRenderDelegate = SC.RenderDelegate.create({

data/lib/frameworks/sproutcore/frameworks/desktop/render_delegates/radio.js

@@ -12,17 +12,17 @@
   Expected Properties
   -----------------------------------
   
-  - isSelected
-  - isActive
-  - isMixed
-  - isEnabled
-  - title
+   - `isSelected`
+   - `isActive`
+   - `isMixed`
+   - `isEnabled`
+   - `title`
   
   Optional Properties
   -----------------------------------
   
-  - width: an optional width of the radio button
-  - labelRenderDelegate properties
+   - `width` -- an optional width of the radio button
+   - `labelRenderDelegate` properties
   
 */
 SC.BaseTheme.radioRenderDelegate = SC.RenderDelegate.create({

data/lib/frameworks/sproutcore/frameworks/desktop/render_delegates/radio_group.js

@@ -13,9 +13,9 @@
   Expects Properties
   -------------------------------
   
-  - items: a collection of data sources for radioRenderDelegates
-  - layoutDirection
-  - isEnabled
+   - `items` -- a collection of data sources for radioRenderDelegates
+   - `layoutDirection`
+   - `isEnabled`
   
   Extended API
   --------------------------------

data/lib/frameworks/sproutcore/frameworks/desktop/render_delegates/slider.js

@@ -12,8 +12,8 @@
   -------------------------
   Requires the following parameters:
   
-  - value: a value from 0 to 1.
-  - frame: containing the frame in which the slider is being drawn.
+   - `value` -- a value from 0 to 1.
+   - `frame` -- containing the frame in which the slider is being drawn.
 */
 
 SC.BaseTheme.sliderRenderDelegate = SC.RenderDelegate.create({
@@ -37,14 +37,16 @@ SC.BaseTheme.sliderRenderDelegate = SC.RenderDelegate.create({
 
     context = context.begin('span').addClass('track');
     this.includeSlices(dataSource, context, SC.THREE_SLICE);
-    context = context.end();
-
     context.push(
-      '<img src="', blankImage, 
+      '<img src="', blankImage,
       '" class="sc-handle" style="left: ', dataSource.get('value'), '%" />',
       '</span>'
     );
 
+    context = context.end();
+
+
+
     dataSource.get('renderState')._cachedHandle = null;
   },
   

data/lib/frameworks/sproutcore/frameworks/desktop/system/drag.js

@@ -74,43 +74,43 @@ SC.View.reopen(
   manages the mouse/touch events and coordinating with droppable targets until the
   user releases the mouse button. 
   
-  To initiate a drag, you should call SC.Drag.start() with the options below
+  To initiate a drag, you should call `SC.Drag.start()` with the options below
   specified in a hash. Pass the ones you need to get the drag you want:
   
-    - *event: (req)* The mouse event/touch that triggered the drag.  This will be used
+    - `event` -- *(req)* The mouse event/touch that triggered the drag.  This will be used
       to position the element.
   
-    - *source: (req)* The drag source object that should be consulted during 
+    - `source` -- *(req)* The drag source object that should be consulted during
       the drag operations. This is usually the container view that initiated 
       the drag.
   
-    - *dragView:*  Optional view that will be used as the source image for the
+    - `dragView` -- Optional view that will be used as the source image for the
       drag. The drag operation will clone the DOM elements for this view and
-      parent them under the drag pane, which has the class name 'sc-ghost-view'.
+      parent them under the drag pane, which has the class name `sc-ghost-view`.
       The drag view is not moved from its original location during a drag.
       If the dragView is not provided, the source is used as dragView.
   
-    - *ghost:  YES | NO*  If NO, the drag view image will show, but the source 
-      dragView will not be hidden.  Set to YES to make it appear that the 
-      dragView itself is being dragged around.
+    - `ghost` -- `YES` | `NO`  If `NO`, the drag view image will show, but the source
+      `dragView` will not be hidden.  Set to `YES` to make it appear that the
+      `dragView` itself is being dragged around.
   
-    - *slideBack: YES | NO*  If YES and the drag operation is cancelled, the 
-      dragView will slide back to its source origin.
+    - `slideBack` -- `YES` | `NO`  If `YES` and the drag operation is cancelled, the
+      `dragView` will slide back to its source origin.
   
-    - *origin:*  If passed, this will be used as the origin point for the 
+    - `origin` --  If passed, this will be used as the origin point for the
       ghostView when it slides back.  You normally do not need to pass this 
       unless the ghost view does not appear in the main UI.
   
-    - *data:* Optional hash of data types and values.  You can use this to pass 
+    - `data` -- Optional hash of data types and values.  You can use this to pass
       a static set of data instead of providing a dataSource.  If you provide
       a dataSource, it will be used instead.
   
-    - *dataSource:*  Optional object that will provide the data for the drag to 
+    - `dataSource` --  Optional object that will provide the data for the drag to
       be consumed by the drop target.  If you do not pass this parameter or the 
       data hash, then the source object will be used if it implements the 
       SC.DragDataSource protocol.
   
-    - *anchorView:* if you pass this optional view, then the drag will only be 
+    - `anchorView` -- if you pass this optional view, then the drag will only be
       allowed to happen within this view.  The ghostView will actually be added 
       as a child of this view during the drag.  Normally the anchorView is the 
       window.
@@ -138,7 +138,7 @@ SC.Drag = SC.Object.extend(
   ghostView: null,
   
   /**
-    If YES, then the ghostView will acts like a cursor and attach directly
+    If `YES`, then the `ghostView` will acts like a cursor and attach directly
     to the mouse/touch location.
     
     @readOnly
@@ -147,12 +147,12 @@ SC.Drag = SC.Object.extend(
   ghostActsLikeCursor: NO,
   
   /**  
-    The view that was used as the source of the ghostView.
+    The view that was used as the source of the `ghostView`.
     
     The drag view is not moved from its original location during a drag.
     Instead, the DOM content of the view is cloned and managed by the 
     ghostView.  If you want to visually indicate that the view is being 
-    moved, you should set ghost to YES.
+    moved, you should set ghost to `YES`.
     If dragView is not provided the source is used instead.
     
     @readOnly
@@ -161,7 +161,7 @@ SC.Drag = SC.Object.extend(
   dragView: null,
   
   /**
-    If YES, the dragView is automatically hidden while dragging around the 
+    If `YES`, the `dragView` is automatically hidden while dragging around the
     ghost.
     
     @readOnly
@@ -170,7 +170,7 @@ SC.Drag = SC.Object.extend(
   ghost: YES,
 
   /**
-    If NO, the source will not be copied, clone, no ghost view will get created,
+    If `NO`, the source will not be copied, clone, no ghost view will get created,
     and it won't be moved.
 
     @type Boolean
@@ -178,7 +178,7 @@ SC.Drag = SC.Object.extend(
 	sourceIsDraggable: YES,
   
   /**
-    If YES, then the ghostView will slide back to its original location if 
+    If `YES`, then the `ghostView` will slide back to its original location if
     drag is cancelled.
     
     @type Boolean
@@ -186,7 +186,7 @@ SC.Drag = SC.Object.extend(
   slideBack: YES,
 
   /**
-    The origin to slide back to in the coordinate of the dragView's 
+    The origin to slide back to in the coordinate of the `dragView`'s
     containerView.
     
     @type Point
@@ -196,7 +196,7 @@ SC.Drag = SC.Object.extend(
   /**
     The current location of the mouse pointer in window coordinates. This is 
     updated as long as the mouse button is pressed or touch is active. Drop targets are 
-    encouraged to update this property in their dragUpdated() method 
+    encouraged to update this property in their `dragUpdated()` method
     implementations.
     
     The ghostView will be positioned at this location.
@@ -219,7 +219,7 @@ SC.Drag = SC.Object.extend(
     types so that drop targets can detect if they can accept your drag data.
     
     If you are implementing a drop target, you should inspect this property
-    on your dragEntered() and prepareForDragOperation() methods to determine 
+    on your `dragEntered()` and `prepareForDragOperation()` methods to determine
     if you can handle any of the data types offered up by the drag source.
     
     @type Array
@@ -257,9 +257,9 @@ SC.Drag = SC.Object.extend(
   },
   
   /**
-    Retrieve the data for the specified dataType from the drag source.
+    Retrieve the data for the specified `dataType` from the drag source.
     
-    Drop targets can use this method during their performDragOperation() 
+    Drop targets can use this method during their `performDragOperation()`
     method to retrieve the actual data provided by the drag data source.  This
     data may be generated dynamically depending on the data source.
     
@@ -290,16 +290,16 @@ SC.Drag = SC.Object.extend(
   /**
     Optional object used to provide the data for the drag.
     
-    Drag source can designate a dataSource object to generate the data for 
+    Drag source can designate a `dataSource` object to generate the data for
     a drag dynamically.  The data source can and often is the drag source 
     object itself.  
     
-    Data Source objects must comply with the SC.DragDataSource interface.  If
+    Data Source objects must comply with the `SC.DragDataSource` interface.  If
     you do not want to implement this interface, you can provide the data 
     directly with the data property.
     
     If you are implementing a drop target, use the dataTypes property and 
-    dataForTypes() method to access data instead of working directly with 
+    `dataForTypes()` method to access data instead of working directly with
     these properties.
     
     @readOnly
@@ -313,7 +313,7 @@ SC.Drag = SC.Object.extend(
     Drag sources can provide a hash of data when the drag begins instead of 
     specifying an actual dataSource.  The data is stored in this property.
     If you are implementing a drop target, use the dataTypes property and 
-    dataForTypes() method to access data instead of working directly with 
+    `dataForTypes()` method to access data instead of working directly with
     these properties.
     
     @readOnly
@@ -322,7 +322,7 @@ SC.Drag = SC.Object.extend(
   data: null,
   
   /**
-    Returns the currently allowed dragOperations for the drag.  This will be 
+    Returns the currently allowed `dragOperations` for the drag.  This will be
     set just before any callbacks are invoked on a drop target.  The drag 
     source is given an opportunity to set these operations.
     
@@ -973,7 +973,7 @@ SC.Drag.mixin(
     Register the view object as a drop target.
     
     This method is called automatically whenever a view is created with the
-    isDropTarget property set to YES.  You generally will not need to call it
+    isDropTarget property set to `YES`.  You generally will not need to call it
     yourself.
     
     @param {SC.View} target a view implementing the SC.DropTarget protocol