Apple

On 28 Jun 2015, at 14:52, 2551 <email@hidden> wrote:

After months of putting it off, I finally glued my eyes open and waded through all the docs to figure out how to add AppleScript support to my Cocoa apps.

Complaints about the unhelpfulness of AppleScript dictionaries are, to put it politely, "not uncommon". Now, I start to see one possible reason. In the sdef(5) man page there is the diktat that:

Bear in mind that an sdef is intended to be a reference, not a tutorial. If you want to
include any lengthy material, consider using a link to an external resource.
(Source: https://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man5/sdef.5.html)

The link after each "HELP" _expression_ is a public link to a website that requires an internet connection, that my server's are not down at the time it's clicked, and general beneficence from the gods of all things to do with the chaos of internet connectivity. This is much of the explanation (in case someone thinks to ask), why just providing the links alone doesn't seem to me to be sufficient.

The “link” doesn’t need to be to an Online resource, it could be a HTML file you ship with the Script, then in that file, reference your own site for updates etc.

application n [inh. application; see also Standard Suite] : OSXClock application class
HELP: Sqwarq Apps Scripting Examples
properties
ghostmode (boolean) : Is Ghost Mode on or off?
transparency (boolean) : Is Transparency Mode on or off?
logging (boolean) : Is App Logging on or off?
ontop (boolean) : Is OSXClock always on top?
alarmcounter (text, r/o) : If an alarm is set, how much time is left?
the application's top-level scripting object. [see standard suite]
elements
contains documents, windows.
properties
name (text, r/o) : The name of the application.
frontmost (boolean, r/o) : Is this the active application?
version (text, r/o) : The version number of the application.
responds to
open, print, quit.
ghost v : Toggle Ghost mode.
ghost
USAGE:
--toggle ghostmode's current state
tell application "OSXClock" to ghost
--turn Ghost mode on
tell application "OSXClock"
set x to ghostmode
if x = false then ghost
end tell
HELP: Sqwarq Apps Scripting Examples

References:
	>sdef etiquette (From: 2551 <email@hidden>)