diff --git a/AppKit/CPAnimation.j b/AppKit/CPAnimation.j
index bbdb79c69..6b943279f 100644
--- a/AppKit/CPAnimation.j
+++ b/AppKit/CPAnimation.j
@@ -68,7 +68,7 @@ ACTUAL_FRAME_RATE = 0;
@param animation the animation that was stopped
@delegate - (float)animation:(CPAnimation)animation valueForProgress:(float)progress;
- The value from this method will be returned when currentValue method is called.
@param animation the animation to obtain the curve value for
@param progress the current animation progress
diff --git a/AppKit/CPApplication.j b/AppKit/CPApplication.j
index 73fd8c0fe..2063b889f 100644
--- a/AppKit/CPApplication.j
+++ b/AppKit/CPApplication.j
@@ -230,7 +230,7 @@ CPRunContinuesResponse = -1002;
/*!
This method is called by run before the event loop begins.
When it successfully completes, it posts the notification
- finishLaunching, the subclass method should invoke the superclass method.
*/
- (void)finishLaunching
@@ -437,7 +437,7 @@ CPRunContinuesResponse = -1002;
}
/*!
- Returns the aWindowNumber.
+ Returns the CPWindow object corresponding to aWindowNumber.
*/
- (CPWindow)windowWithWindowNumber:(int)aWindowNumber
{
@@ -445,7 +445,7 @@ CPRunContinuesResponse = -1002;
}
/*!
- Returns an array of the application's
aState.
- @param aState Possible states are any of the CPOffState, CPOnState, CPMixedState
*/
- (void)setState:(int)aState
@@ -830,7 +830,7 @@ var CPButtonImageKey = @"CPButtonImageKey",
/*!
Initializes the button by unarchiving data from aCoder.
- @param aCoder the coder containing the archived The class does not have a set: method
like NextStep based frameworks to change the color of
the current context. To change the color of the current
- context, use colorWithHexString: implementation
+ Used for the CPColor colorWithHexString: implementation
@ignore
@class CPColor
@return an array of rgb components
diff --git a/AppKit/CPColorPicker.j b/AppKit/CPColorPicker.j
index 6bc05e442..344a78ecb 100644
--- a/AppKit/CPColorPicker.j
+++ b/AppKit/CPColorPicker.j
@@ -25,7 +25,7 @@
/*! @class CPColorPicker
- setPickerMode: method. The simplest way to implement your own color picker is to create a subclass of CPColorPicker.
+ CPColorPicker is an abstract superclass for all color picker subclasses. If you want a particular color picker, use CPColorPanel's setPickerMode: method. The simplest way to implement your own color picker is to create a subclass of CPColorPicker.
*/
@implementation CPColorPicker : CPObject
{
diff --git a/AppKit/CPColorWell.j b/AppKit/CPColorWell.j
index cc605e841..6cee93020 100644
--- a/AppKit/CPColorWell.j
+++ b/AppKit/CPColorWell.j
@@ -31,9 +31,9 @@ var _CPColorWellDidBecomeExclusiveNotification = @"_CPColorWellDidBecomeExclusiv
/*! @class CPColorWell
-
An application can have one or more active activate: method with NO as its argument. When a mouse-down event occurs on an
An application can have one or more active CPColorWells. You can activate multiple CPColorWells by invoking the activate: method with NO as its argument. When a mouse-down event occurs on an CPColorWell's border, it becomes the only active color well. When a color well becomes active, it brings up the color panel also.
*/
@implementation CPColorWell : CPControl
{
@@ -136,7 +136,7 @@ var _CPColorWellDidBecomeExclusiveNotification = @"_CPColorWellDidBecomeExclusiv
// Activating and Deactivating Color Wells
/*!
Activates the color well, displays the color panel, and makes the panel's current color the same as its own.
- If exclusive is YES, deactivates any other NO, keeps them active.
+ If exclusive is YES, deactivates any other CPColorWells. NO, keeps them active.
@param shouldBeExclusive whether other color wells should be deactivated.
*/
- (void)activate:(BOOL)shouldBeExclusive
@@ -262,7 +262,7 @@ var CPColorWellColorKey = "CPColorWellColorKey",
/*!
Initializes the color well by unarchiving data from aCoder.
- @param aCoder the coder containing the archived YES if the document has a
- YES makes the document have an undo manager
*/
- (void)setHasUndoManager:(BOOL)aFlag
@@ -649,7 +649,7 @@ var CPDocumentUntitledCount = 0;
}
/*
- Implemented as a delegate of a aType.
+ Returns the CPDocument subclass associated with aType.
@param aType the type of document
@return a Cappuccino Class object, or nil if no match was found
*/
diff --git a/AppKit/CPDragServer.j b/AppKit/CPDragServer.j
index 8ef08829d..d0fc4f33f 100644
--- a/AppKit/CPDragServer.j
+++ b/AppKit/CPDragServer.j
@@ -116,7 +116,7 @@ var CPDragServerUpdateDragging = function(anEvent)
}
/*
- aWindowNumber
- @param modifierFlags a bitwise combination of the modifiers specified in the YES if this is caused by the system repeat as opposed to the user pressing the key again
@param code a number associated with the keyboard key of this event
- @throws CPInternalInconsistencyException if anEventType is not a anEventType is not a CPKeyDown,
+ CPKeyUp or CPFlagsChanged
@return the keyboard event
*/
+ (CPEvent)keyEventWithType:(CPEventType)anEventType location:(CGPoint)aPoint modifierFlags:(unsigned int)modifierFlags
@@ -233,9 +233,9 @@ var _CPEventPeriodicEventPeriod = 0,
Creates a new mouse event
@param anEventType the event type
@param aPoint the location of the cursor in the window specified by aWindowNumber
- @param modifierFlags a bitwise combination of the modifiers specified in the aWindowNumber
- @param modifierFlags a bitwise combination of the modifiers specified in the YES if the aRect, contains
- the aPoint.
+ Returns YES if the CGRect, aRect, contains
+ the CGPoint, aPoint.
@param aRect the rectangle to test with
@param aPoint the point to test with
@group CGRect
@@ -222,11 +222,11 @@ function CPRectContainsPoint(aRect, aPoint)
}
/*!
- Returns a BOOL indicating whether possibleOuter
- contains possibleInner.
+ Returns a BOOL indicating whether CGRect possibleOuter
+ contains CGRect possibleInner.
@group CGRect
- @param possibleOuter the possibleInner is inside of
- @param possibleInner the possibleOuter.
+ @param possibleOuter the CGRect to test if possibleInner is inside of
+ @param possibleInner the CGRect to test if it fits inside possibleOuter.
@return BOOL YES if possibleInner fits inside possibleOuter.
*/
function CPRectContainsRect(lhsRect, rhsRect)
@@ -235,11 +235,11 @@ function CPRectContainsRect(lhsRect, rhsRect)
}
/*!
- Tests whether the two x and y members.
@group @CGPoint
- @param lhsPoint the first YES if the two points have the same x's, and the same y's.
*/
function CPPointEqualToPoint(lhsPoint, rhsPoint)
@@ -248,10 +248,10 @@ function CPPointEqualToPoint(lhsPoint, rhsPoint)
}
/*!
- Test whether the two YES if the two rectangles have the same origin and size. NO, otherwise.
*/
function CPRectEqualToRect(lhsRect, rhsRect)
@@ -262,7 +262,7 @@ function CPRectEqualToRect(lhsRect, rhsRect)
/*!
@group CGRect
- @param aRect a YES if the two rectangles intersect
@group CGRect
- @param lhsRect the first YES if the two rectangles have any common spaces, and NO, otherwise.
*/
function CPRectIntersectsRect(lhsRect, rhsRect)
@@ -353,11 +353,11 @@ function CPRectIntersectsRect(lhsRect, rhsRect)
}
/*!
- Returns YES if the YES if the CGRect has no area.
The test is performed by checking if the width and height are both zero.
@group CGRect
- @param aRect the YES if the NO, otherwise.
+ @param aRect the CGRect to test
+ @return BOOL YES if the CGRect has no area, and NO, otherwise.
*/
function CPRectIsEmpty(aRect)
{
@@ -365,10 +365,10 @@ function CPRectIsEmpty(aRect)
}
/*!
- Returns YES if the YES if the CGRect has no area.
The test is performed by checking if the width and height are both zero.
@group CGRect
- @return BOOL YES if the NO, otherwise.
+ @return BOOL YES if the CGRect has no area, and NO, otherwise.
*/
function CPRectIsNull(aRect)
{
@@ -376,10 +376,10 @@ function CPRectIsNull(aRect)
}
/*!
- Returns YES if the two YES if the two CGSizes are identical.
@group CGSize
- @param lhsSize the first YES if the two sizes are identical. NO, otherwise.
*/
function CPSizeEqualToSize(lhsSize, rhsSize)
@@ -388,10 +388,10 @@ function CPSizeEqualToSize(lhsSize, rhsSize)
}
/*!
- Returns a human readable string of the provided CPStringFromRect
@return CGRect the rectangle created from the string
@@ -470,7 +470,7 @@ function CPPointFromEvent(anEvent)
}
/*!
- Returns a zero sized width and height
*/
diff --git a/AppKit/CPImage.j b/AppKit/CPImage.j
index b0c24bdb9..7c4a050c3 100644
--- a/AppKit/CPImage.j
+++ b/AppKit/CPImage.j
@@ -49,7 +49,7 @@ CPImageDidLoadNotification = @"CPImageDidLoadNotification";
/*! @class CPImage
-
-*/ - (void)setState:(int)aState @@ -304,9 +304,9 @@ /*! Returns the menu item's current state. Possible states are:CPMixedState -CPOnState -CPOffState +CPMixedState +CPOnState +CPOffState
-*/ - (int)state @@ -520,10 +520,10 @@ Sets the modifier mask used for the item's keyboard shortcut. Can be a combination of:CPMixedState -CPOnState -CPOffState +CPMixedState +CPOnState +CPOffState
-*/ - (void)setKeyEquivalentModifierMask:(unsigned)aMask @@ -535,10 +535,10 @@ Returns the item's keyboard shortcut modifier mask. Can be a combination of:CPShiftKeyMask -CPAlternateKeyMask -CPCommandKeyMask -CPControlKeyMask +CPShiftKeyMask +CPAlternateKeyMask +CPCommandKeyMask +CPControlKeyMask
-*/ - (unsigned)keyEquivalentModifierMask diff --git a/AppKit/CPOutlineView.j b/AppKit/CPOutlineView.j index a2af0bfb9..d82d737c9 100644 --- a/AppKit/CPOutlineView.j +++ b/AppKit/CPOutlineView.j @@ -24,7 +24,7 @@ /*! @ignore - This class is a subclass ofCPShiftKeyMask -CPAlternateKeyMask -CPCommandKeyMask -CPControlKeyMask +CPShiftKeyMask +CPAlternateKeyMask +CPCommandKeyMask +CPControlKeyMask
-- (id)outlineView:(@param aDataSource the outline's data source @throws CPInternalInconsistencyException if the data source does not implement all the required methods diff --git a/AppKit/CPPanel.j b/AppKit/CPPanel.j index 93798d28e..72c7c9712 100644 --- a/AppKit/CPPanel.j +++ b/AppKit/CPPanel.j @@ -28,7 +28,7 @@ CPCancelButton = 0; /*! @class CPPanel - TheCPOutlineView )outlineView child:(int)index ofItem:(id)item -- (BOOL)outlineView:(CPOutlineView )outlineView isItemExpandable:(id)item -- (int)outlineView:(CPOutlineView )outlineView numberOfChildrenOfItem:(id)item -- (id)outlineView:(CPOutlineView )outlineView objectValueForTableColumn:(CPTableColumn )tableColumn byItem:(id)item +- (id)outlineView:(CPOutlineView)outlineView child:(int)index ofItem:(id)item +- (BOOL)outlineView:(CPOutlineView)outlineView isItemExpandable:(id)item +- (int)outlineView:(CPOutlineView)outlineView numberOfChildrenOfItem:(id)item +- (id)outlineView:(CPOutlineView)outlineView objectValueForTableColumn:(CPTableColumn)tableColumn byItem:(id)item
Panels behave differently from standard windows in only a small number of ways, but the ways are important to the user interface:
diff --git a/AppKit/CPPasteboard.j b/AppKit/CPPasteboard.j index 9037b1d8a..42f136e68 100644 --- a/AppKit/CPPasteboard.j +++ b/AppKit/CPPasteboard.j @@ -44,7 +44,7 @@ var CPPasteboards = nil; /*! @class CPPasteboard -YES if the style
- is NO if it's NO if it's CPProgressIndicatorSpinningStyle.
@param isDisplayedWhenStopped YES means the indicator will be displayed when it's not animating.
*/
- (void)setDisplayedWhenStopped:(BOOL)isDisplayedWhenStopped
diff --git a/AppKit/CPResponder.j b/AppKit/CPResponder.j
index 6331472fb..c85432ef1 100644
--- a/AppKit/CPResponder.j
+++ b/AppKit/CPResponder.j
@@ -88,7 +88,7 @@ CPRightArrowKeyCode = 63235;
/*!
Called to interpret a series of key events.
- @param events an array of key float, which can be retrieved by the method floatValue and set by the method setFloatValue:.
+ An CPSlider displays, and allows control of, some value in the application. It represents a continuous stream of values of type float, which can be retrieved by the method floatValue and set by the method setFloatValue:.
*/
@implementation CPSlider : CPControl
{
diff --git a/AppKit/CPSplitView.j b/AppKit/CPSplitView.j
index 89727ba3b..028d85164 100644
--- a/AppKit/CPSplitView.j
+++ b/AppKit/CPSplitView.j
@@ -515,7 +515,7 @@ var CPSplitViewDelegateKey = "CPSplitViewDelegateKey",
/*
Initializes the split view by unarchiving data from aCoder.
- @param aCoder the coder containing the archived Each
Each CPTableColumn object is identified by a CPString, called the column identifier. The reason is that, after a column has been added to a table view, the user might move the columns around, so there is a need to identify the columns regardless of its position in the table.
@ignore
*/
diff --git a/AppKit/CPTableView.j b/AppKit/CPTableView.j
index 8076b8994..cf4bcd744 100644
--- a/AppKit/CPTableView.j
+++ b/AppKit/CPTableView.j
@@ -27,7 +27,7 @@ import "CPTableColumn.j"
var CPTableViewCellPlaceholder = nil;
/*
-
-- (int)numberOfRowsInTableView:(@param aDataSource the object with the table data @throws CPInternalInconsistencyException ifCPTableView )aTableView -- (id)tableView:(CPTableView )aTableView objectValueForTableColumn:(CPTableColumn )aTableColumn row:(int)rowIndex +- (int)numberOfRowsInTableView:(CPTableView)aTableView +- (id)tableView:(CPTableView)aTableView objectValueForTableColumn:(CPTableColumn)aTableColumn row:(int)rowIndex
aDataSource doesn't implement all the required methods
diff --git a/AppKit/CPToolbar.j b/AppKit/CPToolbar.j
index 9d6763fee..2d72bece0 100644
--- a/AppKit/CPToolbar.j
+++ b/AppKit/CPToolbar.j
@@ -358,7 +358,7 @@ var CPToolbarIdentifierKey = "CPToolbarIdentifierKey",
/*
Initializes the toolbar by unarchiving data from aCoder.
- @param aCoder the coder containing the archived CPView is a class which provides facilities for drawing in a window and receiving events. It is the superclass of many of the visual elements of the GUI.
In order to display itself, a view must be placed in a window (represented by an
-
Subclasses can override -drawRect: in order to implement their
- appearance. Other methods of aSize is the same as the frame's current dimensions, this
- method simply returns. The method posts a NO.
Methods that could cause a frame change notification are:
@@ -1259,7 +1259,7 @@ setFrameOrigin: } /*! - ReturnsYESif the receiver posts aCPViewFrameDidChangeNotification if its frame is changed. + ReturnsYESif the receiver posts a CPViewFrameDidChangeNotification if its frame is changed. */ - (BOOL)postsFrameChangedNotifications { @@ -1267,7 +1267,7 @@ setFrameOrigin: } /*! - Sets whether the receiver posts aCPViewBoundsDidChangeNotification notification + Sets whether the receiver posts a CPViewBoundsDidChangeNotification notification to the default notification center when its bounds is changed. The default isNO. Methods that could cause a bounds change notification are:@@ -1291,7 +1291,7 @@ setBoundsOrigin: /*! ReturnsYESif the receiver posts a -CPViewBoundsDidChangeNotification when its + CPViewBoundsDidChangeNotification when its bounds is changed. */ - (BOOL)postsBoundsChangedNotifications @@ -1331,7 +1331,7 @@ setBoundsOrigin: /*! Sets the receiver's list of acceptable data types for a dragging operation. - @param pasteboardTypes an array ofCPPasteboard s + @param pasteboardTypes an array of CPPasteboards */ - (void)registerForDraggedTypes:(CPArray)pasteboardTypes { @@ -1340,7 +1340,7 @@ setBoundsOrigin: /*! Returns an array of all types the receiver accepts for dragging operations. - @return an array ofCPPasteBoard s + @return an array of CPPasteBoards */ - (CPArray)registeredDraggedTypes { @@ -1559,7 +1559,7 @@ setBoundsOrigin: } /*! - Scrolls the nearest ancestorCPClipView a minimum amount soaRectcan become visible. + Scrolls the nearest ancestor CPClipView a minimum amount soaRectcan become visible. @param aRect the area to become visible @returnif any scrolling occurred, NOotherwise. */ @@ -1627,8 +1627,8 @@ setBoundsOrigin: } /*! - Returns theCPScrollView containing the receiver. - @return theCPScrollView containing the receiver. + Returns the CPScrollView containing the receiver. + @return the CPScrollView containing the receiver. */ - (CPScrollView)enclosingScrollView { @@ -1652,7 +1652,7 @@ setBoundsOrigin: } /*! - Notifies the receiver (superview of aCPClipView ) + Notifies the receiver (superview of a CPClipView) that the clip view bounds or the document view bounds have changed. @param aClipView the clip view of the superview being notified */ @@ -1714,8 +1714,8 @@ setBoundsOrigin: } /*! - ReturnsYESif the receiver uses aCALayer - @returnsYESif the receiver uses aCALayer + ReturnsYESif the receiver uses a CALayer + @returnsYESif the receiver uses a CALayer */ - (BOOL)wantsLayer { diff --git a/AppKit/CPWindow.j b/AppKit/CPWindow.j index 8c7aa7637..aec1dc6da 100644 --- a/AppKit/CPWindow.j +++ b/AppKit/CPWindow.j @@ -186,7 +186,7 @@ var CPWindowSaveImage = nil, /*! @class CPWindow - AnCPWindow instance represents a window, panel or menu on the screen. + An CPWindow instance represents a window, panel or menu on the screen.Each window has a style, which determines how the window is decorated; whether it has a border, a title bar, a resize bar, minimise and close buttons.
@@ -194,7 +194,7 @@ var CPWindowSaveImage = nil,A window always contains a content view which is the highest level view available for public (application) use. This view fills the area of the window inside any decoration/border. This is the only part of the window that application programmers are allowed to draw in directly.
-You can convert between view coordinates and window base coordinates using the
[CPView -convertPoint:fromView:] ,[CPView -convertPoint:toView:] ,[CPView -convertRect:fromView:] , and[CPView -convertRect:toView:] methods with anil view argument. +You can convert between view coordinates and window base coordinates using the [CPView -convertPoint:fromView:], [CPView -convertPoint:toView:], [CPView -convertRect:fromView:], and [CPView -convertRect:toView:] methods with a nil view argument. @par Delegate Methods @@ -876,7 +876,7 @@ CPTexturedBackgroundWindowMask /*! Sets the delegate for the window. Passing
+ +nilwill just remove the window's current delegate. - @param aDelegate an object to respond to the various delegate methods ofCPWindow + @param aDelegate an object to respond to the various delegate methods of CPWindow */ - (void)setDelegate:(id)aDelegate { @@ -1079,7 +1079,7 @@ CPTexturedBackgroundWindowMask } /*! - Dispatches events that are sent to it fromCPApplication . + Dispatches events that are sent to it from CPApplication. @param anEvent the event to be dispatched */ - (void)sendEvent:(CPEvent)anEvent diff --git a/AppKit/CPWindowController.j b/AppKit/CPWindowController.j index fe7db2f2c..9bf09717b 100644 --- a/AppKit/CPWindowController.j +++ b/AppKit/CPWindowController.j @@ -32,10 +32,10 @@ /*! @class CPWindowController - An instance of aCPWindowController manages aCPWindow . It has methods + An instance of a CPWindowController manages a CPWindow. It has methods that get called when the window is loading, and after the window has loaded. In the - Model-View-Controller method of program design, theCPWindowController would be - considered the 'Controller' and theCPWindow the 'Model.' + Model-View-Controller method of program design, the CPWindowController would be + considered the 'Controller' and the CPWindow the 'Model.' */ @implementation CPWindowController : CPResponder { @@ -123,7 +123,7 @@ /*! ReturnsYESif the window has been loaded. Specifically, - ifloadWindow has been called. + if loadWindow has been called. */ - (BOOL)isWindowLoaded { diff --git a/AppKit/CoreAnimation/CAAnimation.j b/AppKit/CoreAnimation/CAAnimation.j index d94804b7f..fbaca60fd 100644 --- a/AppKit/CoreAnimation/CAAnimation.j +++ b/AppKit/CoreAnimation/CAAnimation.j @@ -34,8 +34,8 @@ } /*! - Creates a newCAAnimation instance - @return a newCAAnimation instance + Creates a new CAAnimation instance + @return a new CAAnimation instance */ + (id)animation { @@ -191,8 +191,8 @@ @end /*! - ACABasicAnimation is a simple animation that moves a -CALayer from one point to another over a specified + A CABasicAnimation is a simple animation that moves a + CALayer from one point to another over a specified period of time. */ @implementation CABasicAnimation : CAPropertyAnimation diff --git a/AppKit/CoreAnimation/CALayer.j b/AppKit/CoreAnimation/CALayer.j index 583ad8ccc..baef5f944 100644 --- a/AppKit/CoreAnimation/CALayer.j +++ b/AppKit/CoreAnimation/CALayer.j @@ -51,11 +51,11 @@ var CALayerRegisteredRunLoopUpdates = nil; /*! @class CALayer - ACALayer is similar to aCPView , but with the ability + A CALayer is similar to a CPView, but with the ability to have a transform applied to it. @delegate -(void)drawLayer:(CALayer)layer inContext:(CGContextRef)ctx; - If the delegate implements this method, theCALayer will + If the delegate implements this method, the CALayer will call this in place of itsdrawInContext:. @param layer the layer to draw for @param ctx the context to draw on @@ -418,7 +418,7 @@ var CALayerRegisteredRunLoopUpdates = nil; // Providing Layer Content /*! - Returns theCGImage contents of this layer. + Returns the CGImage contents of this layer. The default contents arenil. */ - (CGImage)contents diff --git a/AppKit/CoreGraphics/CGColor.j b/AppKit/CoreGraphics/CGColor.j index fd48edb6f..6c9381041 100644 --- a/AppKit/CoreGraphics/CGColor.j +++ b/AppKit/CoreGraphics/CGColor.j @@ -62,8 +62,8 @@ function CGColorRelease() } /*! - Creates a newCGColor . - @param aColorSpace theCGColorSpace of the color + Creates a new CGColor. + @param aColorSpace the CGColorSpace of the color @param components the color's intensity values plus alpha @return CGColor the new color object @group CGColor @@ -86,10 +86,10 @@ function CGColorCreate(aColorSpace, components) } /*! - Creates a copy of a color... but not really.CGColor s + Creates a copy of a color... but not really. CGColors are immutable, so to be efficient, this function will just return the same object that was passed in. - @param aColor theCGColor to 'copy' + @param aColor the CGColor to 'copy' @return CGColor the color copy @group CGColor */ @@ -166,7 +166,7 @@ function CGColorCreateCopyWithAlpha(aColor, anAlpha) /*! Creates a color using the specified pattern. - @param aColorSpace theCGColorSpace + @param aColorSpace the CGColorSpace @param aPattern the pattern image @param components the color components plus the alpha component @return CGColor the patterned color @@ -182,8 +182,8 @@ function CGColorCreateWithPattern(aColorSpace, aPattern, components) /*! Determines if two colors are the same. - @param lhs the firstCGColor - @param rhs the secondCGColor + @param lhs the first CGColor + @param rhs the second CGColor @returnYESif the two colors are equal.NOotherwise. */ @@ -229,8 +229,8 @@ function CGColorGetAlpha(aColor) } /*! - Returns theCGColor 's color space. - @returnCGColorSpace + Returns the CGColor's color space. + @return CGColorSpace @group CGColor */ function CGColorGetColorSpace(aColor) @@ -239,7 +239,7 @@ function CGColorGetColorSpace(aColor) } /*! - Returns theCGColor 's components + Returns the CGColor's components including the alpha in an array. @param aColor the color @return CPArray the color's components @@ -252,7 +252,7 @@ function CGColorGetComponents(aColor) /*! Returns the number of color components (including alpha) in the specified color. - @param aColor theCGColor + @param aColor the CGColor @return CPNumber the number of components @group CGColor */ @@ -262,8 +262,8 @@ function CGColorGetNumberOfComponents(aColor) } /*! - Gets theCGColor 's pattern. - @param aCGColor + Gets the CGColor's pattern. + @param a CGColor @return CGPatternFIXME the pattern image @group CGColor */ diff --git a/AppKit/CoreGraphics/CGGeometry.j b/AppKit/CoreGraphics/CGGeometry.j index 9f156cec8..d9a07af7a 100644 --- a/AppKit/CoreGraphics/CGGeometry.j +++ b/AppKit/CoreGraphics/CGGeometry.j @@ -66,11 +66,11 @@ _function(CGRectIsNull(aRect)) _function(CGRectContainsPoint(aRect, aPoint)) /*! - Returns aBOOLindicating whetherCGRect lhsRect- containsCGRect rhsRect. + Returns aBOOLindicating whether CGRectlhsRect+ contains CGRectrhsRect. @group CGRect - @param lhsRect theCGRect to test ifrhsRectis inside of - @param rhsRect theCGRect to test if it fits insidelhsRect. + @param lhsRect the CGRect to test ifrhsRectis inside of + @param rhsRect the CGRect to test if it fits insidelhsRect. @return BOOLYESifrhsRectfits insidelhsRect. */ function CGRectContainsRect(lhsRect, rhsRect) @@ -83,8 +83,8 @@ function CGRectContainsRect(lhsRect, rhsRect) /*! ReturnsYESif the two rectangles intersect @group CGRect - @param lhsRect the firstCGRect - @param rhsRect the secondCGRect + @param lhsRect the first CGRect + @param rhsRect the second CGRect @return BOOLYESif the two rectangles have any common spaces, andNO, otherwise. */ function CGRectIntersectsRect(lhsRect, rhsRect) @@ -95,8 +95,8 @@ function CGRectIntersectsRect(lhsRect, rhsRect) } /*! - Makes the origin and size of aCGRect all integers. Specifically, by making - the southwest corner the origin (rounded down), and the northeast corner aCGSize (rounded up). + Makes the origin and size of a CGRect all integers. Specifically, by making + the southwest corner the origin (rounded down), and the northeast corner a CGSize (rounded up). @param aRect the rectangle to operate on @return CGRect the modified rectangle (same as the input) @group CGRect diff --git a/Foundation/CPRunLoop.j b/Foundation/CPRunLoop.j index 1d97afe5b..20c52f0ea 100644 --- a/Foundation/CPRunLoop.j +++ b/Foundation/CPRunLoop.j @@ -151,6 +151,7 @@ var CPRunLoopLastNativeRunLoop = 0; Object _nativeTimersForModes; CPDate _nextTimerFireDatesForModes; BOOL _didAddTimer; + CPDate _effectiveDate; CPArray _orderedPerforms; } @@ -276,7 +277,7 @@ var CPRunLoopLastNativeRunLoop = 0; _runLoopLock = YES; - var now = [CPDate date], + var now = _effectiveDate ? [_effectiveDate laterDate:[CPDate date]] : [CPDate date], nextFireDate = nil, nextTimerFireDate = _nextTimerFireDatesForModes[aMode]; @@ -348,7 +349,7 @@ var CPRunLoopLastNativeRunLoop = 0; //initiate a new window.setTimeout if there are any timers if (_nextTimerFireDatesForModes[aMode] !== nil) - _nativeTimersForModes[aMode] = window.setNativeTimeout(function() { _nativeTimersForModes[aMode] = nil; ++CPRunLoopLastNativeRunLoop; [self limitDateForMode:aMode]; _isNativeTimerRun = NO; }, MAX(0, [nextFireDate timeIntervalSinceNow] * 1000)); + _nativeTimersForModes[aMode] = window.setNativeTimeout(function() { _effectiveDate = nextFireDate; _nativeTimersForModes[aMode] = nil; ++CPRunLoopLastNativeRunLoop; [self limitDateForMode:aMode]; _effectiveDate = nil; }, [nextFireDate timeIntervalSinceNow] * 1000); } // Run loop performers diff --git a/Objective-J/bootstrap.js b/Objective-J/bootstrap.js new file mode 100644 index 000000000..42d4767e6 --- /dev/null +++ b/Objective-J/bootstrap.js @@ -0,0 +1,24 @@ +/* + * bootstrap.js + * Objective-J + * + * Created by Francisco Tolmasky. + * Copyright 2008, 280 North, Inc. + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2.1 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + */ + +if (window.OBJJ_MAIN_FILE) + objj_import(OBJJ_MAIN_FILE, YES, function() { main(); }); diff --git a/Objective-J/build.xml b/Objective-J/build.xml index 7e838c18c..7cb2cf127 100644 --- a/Objective-J/build.xml +++ b/Objective-J/build.xml @@ -18,6 +18,7 @@+ diff --git a/Objective-J/file.js b/Objective-J/file.js index d9b268c03..e2d4c353c 100644 --- a/Objective-J/file.js +++ b/Objective-J/file.js @@ -37,9 +37,11 @@ var objj_files = { }, objj_bundlesForClass = { }, objj_searches = { }; -var OBJJ_NO_FILE = {}, - OBJJ_INCLUDE_PATHS = ["Frameworks", "SomethingElse"]; - +var OBJJ_NO_FILE = {}; + +if (!window.OBJJ_INCLUDE_PATHS) + var OBJJ_INCLUDE_PATHS = ["Frameworks", "SomethingElse"]; + var OBJJ_BASE_URI = ""; IF (OPERA) diff --git a/Tools/Documentation/Cappuccino.doxygen b/Tools/Documentation/Cappuccino.doxygen index a73f5bdc6..d083ca453 100644 --- a/Tools/Documentation/Cappuccino.doxygen +++ b/Tools/Documentation/Cappuccino.doxygen @@ -5,7 +5,7 @@ #--------------------------------------------------------------------------- DOXYFILE_ENCODING = UTF-8 PROJECT_NAME = Cappuccino -PROJECT_NUMBER = 1.5.5 +PROJECT_NUMBER = 0.6 OUTPUT_DIRECTORY = Documentation CREATE_SUBDIRS = NO OUTPUT_LANGUAGE = English diff --git a/Tools/NewApplication/index-debug.html b/Tools/NewApplication/index-debug.html new file mode 100644 index 000000000..392b37a8f --- /dev/null +++ b/Tools/NewApplication/index-debug.html @@ -0,0 +1,35 @@ + + + + + Hello World + + + + + + + + +++ + + diff --git a/Tools/NewApplication/index.html b/Tools/NewApplication/index.html index 2353705c3..fbcf5a9bc 100644 --- a/Tools/NewApplication/index.html +++ b/Tools/NewApplication/index.html @@ -15,11 +15,12 @@+ ++
Hello World + + - diff --git a/Tools/READMEs/STARTER-README b/Tools/READMEs/STARTER-README index 551b8c326..fe0b77486 100644 --- a/Tools/READMEs/STARTER-README +++ b/Tools/READMEs/STARTER-README @@ -2,11 +2,11 @@ Welcome to the Cappuccino Starter Package! Included you should find the following: -1. Frameworks +1. Documentation 2. NewApplication 3. README -NewApplication is a stand alone Cappuccino application that you can use as a template to start building your own apps. To get started, just open up NewApplication/index.html in your favorite web browser. A great place to go from there is to read the "Downloading and Getting Started" tutorial found at http://cappuccino.org/learn/tutorials/starter-tutorial.php. This will walk you through these initial steps as well as getting you to do a little coding. +NewApplication is a stand alone Cappuccino application that you can use as a template to start building your own apps. To get started, just open up NewApplication/index.html in your favorite web browser. A great place to go from there is to read the "Downloading and Getting Started" tutorial found at http://cappuccino.org/learn/tutorials/starter-tutorial.php. This will walk you through these initial steps as well as getting you to do a little coding. If you want to debug your application, try running it with index-debug.html instead, which should make it easier. You can build your entire application right from this sample project, but if you want to dig a little deeper, you can also download the Tools package found at http://cappuccino.org/download/. This will set you up with some great additions like syntax modules for certain text editors and build tools to get extra performance. diff --git a/Tools/READMEs/TOOLS-README b/Tools/READMEs/TOOLS-README index b22681926..efac4c0ba 100644 --- a/Tools/READMEs/TOOLS-README +++ b/Tools/READMEs/TOOLS-README @@ -6,11 +6,13 @@ This package includes syntax highlighting modes for both SubEthaEdit, Coda, Text + SubEthaEdit + - NOTE: SubEthaEdit now has built-in support for Objective-J, but the copy included here is probably more up to date. - Unarchive Tools/Editors/Objective-J.mode.zip - Double click the generated Objective-J.mode file + Coda + - NOTE: Coda now has built-in support for Objective-J, but the copy included here is probably more up to date. - Unarchive Tools/Editors/Objective-J.mode.zip - Place the generated Objective-J.mode file in ~/Library/Application Support/Coda/Modes @@ -87,6 +89,6 @@ objjc is a static preinterpreter for Objectie-J. It will take Objective-J files Steam is a simple tool for managing Objective-J projects. Among other things, it allows you to statically pre-interpret entire Objective-J applications so that you can deliver it without requiring client-side pre-interpretation. - steam create path - This will create a new Cappuccino application at the specified path. The resulting project contains a basic Cappuccino application as well as Objective-J and the preprocessed Cappuccino frameworks. + steam create [-l] path - This will create a new Cappuccino application at the specified path. The resulting project contains a basic Cappuccino application as well as Objective-J and the preprocessed Cappuccino frameworks. steam build [options] - This builds an application or framework. \ No newline at end of file diff --git a/Tools/SubEthaEdit/Objective-J.mode.zip b/Tools/SubEthaEdit/Objective-J.mode.zip index 11058cd13..95f9b988f 100644 Binary files a/Tools/SubEthaEdit/Objective-J.mode.zip and b/Tools/SubEthaEdit/Objective-J.mode.zip differ diff --git a/Tools/bake/bake.j b/Tools/bake/bake.j index 2865f2f6f..7df936ab2 100644 --- a/Tools/bake/bake.j +++ b/Tools/bake/bake.j @@ -1,4 +1,4 @@ -import+@import importPackage(Packages.java.io); var options = { diff --git a/Tools/bake/bake_template.html b/Tools/bake/bake_template.html index cf9ab8e15..28ed44809 100644 --- a/Tools/bake/bake_template.html +++ b/Tools/bake/bake_template.html @@ -13,23 +13,18 @@ // --> - - Loading... + OBJJ_MAIN_FILE = "main.j"; - - - + + +diff --git a/Tools/steam/steam.js b/Tools/steam/steam.js index 2792ebc14..e28a4ba86 100644 --- a/Tools/steam/steam.js +++ b/Tools/steam/steam.js @@ -404,7 +404,7 @@ function mainCreate() sourceFrameworks = new File(OBJJ_HOME + "/lib/Frameworks"), sourceDebugFrameworks = new File(OBJJ_HOME + "/lib/Frameworks-Debug"), destinationFrameworks = new File(destination + "/Frameworks"), - destinationDebugFrameworks = new File(destination + "/Frameworks-Debug"); + destinationDebugFrameworks = new File(destination + "/Frameworks/Debug"); System.out.println(sourceNewApplication.getCanonicalPath() + "," + destinationNewApplication.getCanonicalPath() + "," + sourceFrameworks.getCanonicalPath() + "," + destinationFrameworks.getCanonicalPath()); @@ -414,13 +414,36 @@ function mainCreate() if (!link) { - exec(["cp", "-vR", sourceDebugFrameworks.getCanonicalPath(), destinationDebugFrameworks.getCanonicalPath()], true); exec(["cp", "-vR", sourceFrameworks.getCanonicalPath(), destinationFrameworks.getCanonicalPath()], true); + exec(["cp", "-vR", sourceDebugFrameworks.getCanonicalPath(), destinationDebugFrameworks.getCanonicalPath()], true); } else { - exec(["ln", "-s", new File(System.getenv("STEAM_BUILD") + "/Debug").getCanonicalPath(), destinationDebugFrameworks.getCanonicalPath()], true); - exec(["ln", "-s", new File(System.getenv("STEAM_BUILD") + "/Release").getCanonicalPath(), destinationFrameworks.getCanonicalPath()], true); + var STEAM_BUILD = System.getenv("STEAM_BUILD"); + + // Release Frameworks + new File(destinationFrameworks).mkdir(); + + exec(["ln", "-s", new File(STEAM_BUILD + "/Release/Objective-J").getCanonicalPath(), + new File(destination + "/Frameworks/Objective-J").getCanonicalPath()], true); + + exec(["ln", "-s", new File(STEAM_BUILD + "/Release/Foundation").getCanonicalPath(), + new File(destination + "/Frameworks/Foundation").getCanonicalPath()], true); + + exec(["ln", "-s", new File(STEAM_BUILD + "/Release/AppKit").getCanonicalPath(), + new File(destination + "/Frameworks/AppKit").getCanonicalPath()], true); + + // Debug Frameworks + new File(destinationDebugFrameworks).mkdir(); + + exec(["ln", "-s", new File(STEAM_BUILD + "/Debug/Objective-J").getCanonicalPath(), + new File(destination + "/Frameworks/Debug/Objective-J").getCanonicalPath()], true); + + exec(["ln", "-s", new File(STEAM_BUILD + "/Debug/Foundation").getCanonicalPath(), + new File(destination + "/Frameworks/Debug/Foundation").getCanonicalPath()], true); + + exec(["ln", "-s", new File(STEAM_BUILD + "/Debug/AppKit").getCanonicalPath(), + new File(destination + "/Frameworks/Debug/AppKit").getCanonicalPath()], true); } } else diff --git a/build.xml b/build.xml index c09eba2ad..6953f8f64 100644 --- a/build.xml +++ b/build.xml @@ -85,13 +85,45 @@ -+ + + + ++ + ++ + + ++ ++ + + + + +*** WARNING: Doxygen not installed. Could not create documentation. ++ @@ -262,14 +294,17 @@ -- - + + + + + + + ++ + + ++ + - + + + +