This manual page is for Mac OS X version 10.6.3

Reading manual pages

OSACOMPILE(1)                            BSD General Commands Manual                           OSACOMPILE(1)

NAME
     osacompile -- compile AppleScripts and other OSA language scripts

SYNOPSIS
     osacompile [-l language] [-e command] [-o name] [-d] [-r type:id] [-t type] [-c creator] [-x] [-s] [-u]
                [-a arch] [file ...]

DESCRIPTION
     osacompile compiles the given files, or standard input if none are listed, into a single output script.
     Files may be plain text or other compiled scripts.  The options are as follows:

     -l language
           Override the language for any plain text files.  Normally, plain text files are compiled as
           AppleScript.

     -e command
           Enter one line of a script.  Script commands given via -e are prepended to the normal source, if
           any.  Multiple -e options may be given to build up a multi-line script.  Because most scripts use
           characters that are special to many shell programs (e.g., AppleScript uses single and double
           quote marks, ``('', ``)'', and ``*''), the command will have to be correctly quoted and escaped
           to get it past the shell intact.

     -o name
           Place the output in the file name.  If -o is not specified, the resulting script is placed in the
           file ``a.scpt''.  The value of -o partly determines the output file format; see below.

     -d    Place the resulting script in the data fork of the output file.  This is the default.

     -r type:id
           Place the resulting script in the resource fork of the output file, in the specified resource.

     -t type
           Set the output file type to type, where type is a four-character code.  The default value is
           ``osas'', that is, a compiled script.

     -c creator
           Set the output file creator to creator, where creator is a four-character code.  The default
           value is ``ToyS'', that is, Script Editor.

     -x    Save the resulting script as execute-only.

     The following options are only relevant when creating a new bundled applet or droplet:

     -s    Stay-open applet.

     -u    Use startup screen.

     -a arch
           Create the applet or droplet for the specified target architecture arch.  The allowable values
           are ``i386'' and ``ppc''.  The default is to create a universal binary.

     If no options are specified, osacompile produces a Mac OS X format script file as would be saved from
     Script Editor: data fork only, type ``osas'' (compiled script), creator ``ToyS'' (Script Editor).

     If the -o option is specified and the file does not already exist, osacompile uses the filename exten-sion extension
     sion to determine what type of file to create.  If the filename ends with ``.app'', it creates a bun-dled bundled
     dled applet or droplet.  If the filename ends with ``.scptd'', it creates a bundled compiled script.
     Otherwise, it creates a flat file with the script data placed according to the values of the -d and -r
     options.

EXAMPLES
     To produce a script compatible with classic Mac OS:

           osacompile -r scpt:128 -t osas -c ToyS example.applescript

SEE ALSO
     osascript(1), osalang(1)

Mac OS X                                      November 12, 2008                                     Mac OS X