Change log of AppleScript support

Unicode normalization

A new value Modified NFC was added to the normalize unicode command.

Selected line editing

The following new commands were added to the ‘selection’ object.

• move line up
• move line down
• sort lines
• reverse lines
• delete duplicate line

Unicode normalization

A new value Modified NFD was added to the normalize unicode command.

Unicode normalization

A new value NFCK Casefold was added to the normalize unicode command.

Tab width

A new property tab width was added to the ‘document’ object.

Comment handling

New commands comment out and uncomment were added to the ‘selection’ object.

Unicode normalization

The command unicode normalization on CotEditor 1.x was renamed on 2.0 to normalize unicode. The function and parameters are the same as before.

Please note that there is no backward compatibility with this changing.

Discontinuation of path property

The path property of ‘document’ object is discontinued on the modern AppleScript’s Standard Suite for a long time. Since CotEditor adopted it on version 2.0, this property is also deprecated on CotEditor. Use new file property instead. While path property returns a text object, file property returns a file object.

For backwards compatibility, CotEditor 2.0 added a hidden path property to ‘document’ object uniquely, however do not use it if you create new scripts and we also recommend to migrate your previous scripts to use file property. Because this `path` property can be removed some day in the future without announce.

Update of internal code for range property

The internal code for range property of text selection object to identify itself has been changed on CotEditor 2.0. The key for the range property is still range, so you don’t need to care about this if you write a new script. However compiled AppleScripts (.scpt) which were written previously might need some update for this change.

How to fix:

Open your .scpt files on AppleScript Editor (or Script Editor), the words that was range previously might be changed to «class prng» or something like that. Overwrite them with range again. And save them.
This issue doesn’t occur with plain-text AppleScript (.applescript).

Window transparency

According to the changing of the mechanism to make window transparent on CotEditor 1.5, the terms about window opacity for AppleScripting was also changed. The document's properties till on version 1.4:

• transparency: The transparency of Window or TextView. (real, from ‘0.2’ to ‘1.0’)
• alpha only textView: Whether the transparency setting affects only the TextView or not. (boolean)

were deprecated, and the new window's property:

• view opacity: The opacity of the view. (real, from ‘0.2’ to ‘1.0’)

was added instead.

Since the previous term “transparency” was incorrectly used until version 1.4, the property name was renamed from “transparency” to “opacity” but the value to set is not changed. Namely, 1.0 means fully opaque on both properties.

Please note that there is no backward compatibility with this changing.

Selection Object direct under the Application

In version 0.6, the initial release of CotEditor, if you didn't specify the ‘selection’ object, the frontmost window's contents will be selected. But it was actually didn't work correctly and therefore deprecated. This method was kept valid however to maintain backwards compatibility.

On CotEditor 1.5, it is formally removed. Specify the target like below, when you get the ‘selection’ object.

tell application "CotEditor"
	contents of selection of front document
end tell

tell application "CotEditor"
	tell document 1
		contents of selection
	end tell
end tell