< Previous PageNext Page > Hide TOC

Document Revision History

This table describes the changes to Open Scripting Architecture Reference.

DateNotes
2007-05-07Added documentation for new functions and other changes in Mac OS X version 10.5.
 

The new functions are ASCopySourceAttributes, ASSetSourceAttributes, OSACopyDisplayString, and OSACopySourceString.

 

The functions ASGetSourceStyles and ASSetSourceStyles are deprecated in Mac OS X version 10.5; use ASCopySourceAttributes and ASSetSourceAttributes instead.

 

Removed undocumented constants that can be used with CallComponentFunction, such as kOSASelectLoad and kASSelectSetSourceStyles, because they have easier-to-use function equivalents, such as OSALoad and ASSetSourceStyles (though the latter is deprecated in Mac OS X version 10.5, in favor of ASSetSourceAttributes).

 

For the function ASInit and the constants in “Default Initialization Values” that you use with ASInit, noted that starting in Mac OS X version 10.5, heap size parameter values are ignored—AppleScript's heap will grow as large as needed.

 

Removed the description for the OSACopyScript function because it has never been defined in a public header.

 

Made minor changes to the Discussion sections for the functions OSADoScript and OSADoScriptFile, including that for OSADoScriptFile, the Discussion now correctly refers to OSAExecute, rather than OSAExecuteEvent.

 

In “Source Style Constants,” noted that you should not use the constant kASNumberOfSourceStyles to determine the number of style items used by theASCopySourceAttributes, ASSetSourceAttributes, and ASGetSourceStyleNames functions (and the deprecated functions ASGetSourceStyles and ASSetSourceStyles).

2005-07-07 Moved some functions to more appropriate groups to make them easier to find.
 

Provided the correct descriptions for kOSANoDispatch and kOSADontUsePhac in “Resume Dispatch Function Constants.”

2005-04-29 Updated for Mac OS X v10.4. Filled in missing error code descriptions and made minor text corrections.
 

Added description for function OSACopyScriptingDefinition, new in Mac OS X version 10.4 (v10.4).

 

Added constant kASNumericStrings to “Considerations Flags” and constants kASNumericStringsConsiderMask and kASNumericStringsIgnoreMask to “Considerations Bit Masks”; constants are new in Mac OS X v10.4.

 

Added more stringent warning not to use the OSA debugging functions listed in “Deprecated Functions.”

 

Added note to “Current Dialect Constants” that the constants are not particularly useful because no currently available OSA languages support them.

 

Made minor revision to Introduction.

 

Deleted a duplicate entry for the error code constant errOSARecordingIsAlreadyOn. (The entry with the error number -1760 was incorrect.)

 

Added Version Notes sections to OSASetScriptInfo and OSAGetScriptInfo to clarify use of the selector parameter in Mac OS X.

 

Noted that the functions ASSetProperty and ASGetAppTerminology are obsolete and only available for backward compatibility, and that you should use OSASetProperty and OSAGetAppTerminology instead.

2003-08-21

Incorporated existing OSA reference documentation.

2003-07-31

Added descriptions for the following functions: OSADoScriptFile, OSALoadExecuteFile, OSALoadFile, OSAStoreFile

 

Moved OSADebugger functions to “Deprecated Functions” and marked them as unsupported.

2003-01-01

Added comments available in header file.

 

Updated Result Code section.

2001-07-01

Last version of this document.




< Previous PageNext Page > Hide TOC


© 1993, 2007 Apple Inc. All Rights Reserved. (Last updated: 2007-05-07)


Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.