launch(1) launch(1)NAME launch - execute a Macintosh binary application SYNOPSIS launch -[it] filename [document...] launch -p[it] filename document... DESCRIPTION launch executes a Macintosh binary file in A/UX. filename is the name of the application to be executed. do- cument is an individual document to be opened. The filename and document parameters are set up as if theyTMwere icons selected through the Macintosh Finder . Thus,the A/UX command launch macpaint is equivalent to double clicking on the icon for MacPaint. The A/UX command launch macpaint mydwg is equivalent to double clicking on the icon for the Mac- Paint document mydwg. If your application is in a pair of AppleDouble files, the two files must be in the same directory. You do not specify both filenames; launch automatically looks for the associat- ed header file when you launch an AppleDouble data file. You can specify one or both of these two options:TM-i Initializes QuickDraw , the Dialog Manager, and Tex-tEdit. You must specify this option if the application does not explicitly initialize these libraries. (In the native Macintosh environment, the Finder initial- izes these libraries during startup. Therefore, some Macintosh applications do not explicitly initialize them.) -t Sets up and maintains the Ticks, Time, and KeyMap low- memory global variables, which are not ordinarily sup- ported in the A/UX Toolbox. The -t option uses the Vertical Retrace Manager to set up a task that is invoked at every tick of the clock. Therefore, this option uses a lot of CPU time and should be used only if you are running a Macintosh binary file that requires to use one or more of these low-memory global variables. April, 1990 1
launch(1) launch(1)Alternatively, you can specify the print option -p Prints the specified document. The -p option requires a document name in the command line. Using the -p op- tion is equivalent to selecting a document through the Macintosh Finder and then choosing Print from the File menu. If all of the application's code resides in an AppleDouble header file in A/UX (see Appendix B of the A/UX Toolbox do- cument), you can make the associated data file either a copy of launch or a link to launch, setting up the simplest and most natural way to run a Macintosh application. For exam- ple, consider an application named xyz; the AppleDouble data file of xyz has the A/UX filename xyz and is a link to launch. The AppleDouble header file of xyz has the A/UX filename %xyz and contains a binary copy of the resource fork of the Macintosh file xyz. To launch xyz, type this command xyz To launch xyz and specify a document file abc, type this command xyz abc Entering this command is equivalent to double-clicking the icon for the file abc from the Macintosh Finder. EXAMPLES The command launch macpaint executes the Macintosh binary application MacPaint(Reg.). launch macpaint demo executes MacPaint and opens the document demo. FILES /mac/bin/launch 2 April, 1990