manpagez: man pages & more
man osacompile(1)
Home | html | info | man
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., Apple-
           Script 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.

     -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 ``ppc'', ``i386'', and ``x86_64''.
           The default is to create a universal binary.

     The following options control the packaging of the output file.  You
     should only need them for compatibility with classic Mac OS or for custom
     file formats.

     -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.  If this option is not specified, the creator code will not
           be set.

     -c creator
           Set the output file creator to creator, where creator is a four-
           character code.  If this option is not specified, the creator code
           will not be set.

     If no options are specified, osacompile produces a Mac OS X format script
     file: data fork only, with no type or creator code.

     If the -o option is specified and the file does not already exist,
     osacompile uses the filename extension to determine what type of file to
     create.  If the filename ends with ``.app'', it creates a bundled 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

Mac OS X 10.7 - Generated Tue Aug 9 08:00:50 CDT 2011
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.