MAE(1) — Apple
Release 2.0.1
NAME
mae − creates the Macintosh Application Environment
SYNOPSIS
mae [ −options ... ]
DESCRIPTION
The mae program creates a virtual Macintosh environment, called the Macintosh Application Environment (MAE), in a window on an X Window System display server. The Macintosh control panels (available from the Apple menu in the MAE menu bar) can be used to modify the behavior of MAE. Command-line options and X resources also can be used to change the behavior of MAE.
OPTIONS
The mae program accepts the following command-line options:
−help Prints a brief summary of mae options and X resources.
−version
Prints the Macintosh Application Environment version information.
−display display
Specifies the X server to use.
−geometry geometry
Specifies the size and position of the MAE window, excluding the Toolbar. The default size is 640 x 480 pixels. (Also can be set in the Monitors control panel.)
−iconic Specifies that MAE should start as an icon.
−title string
Specifies the title that the window manager displays in the window’s title bar. The default title is "Macintosh Application Environment <version>".
−sysfol systemfolder
Specifies the directory that mae should use as the System Folder. If the specified directory does not exist, a new System Folder is created in the specified systemfolder directory. The default is $HOME/System Folder.
−appledir appledirectory
Specifies the Apple directory, containing the MAE startup files, that the mae program should use. The default Apple directory was created when you installed the Macintosh Application Environment. By default, the MAE Installer installs the MAE startup files in $HOME/apple.
−applepath pathname
Specifies an additional directory to be searched when the Desktop is rebuilt using the −rebuild option. Normally, MAE only searches the local System Folder and the appledirectory.
−memory memorysize
Specifies the memory size of the Macintosh Application Environment, in megabytes. The default size is 8 megabytes. (Also can be set in the Memory control panel.)
−fstimeout timeout
Specifies the how long (in seconds) that MAE should wait on a remote file system before timing out. The default is 10 seconds. If this value is set to 0, MAE will wait indefinitely until the mount request is satisfied.
−maxdepth bitdepth
Specifies the maximum frame buffer bit depth (for example 2, 4, 8, 24). Setting −maxdepth will affect the number of colors available in the Monitors control panel. The default value is dynamically set to the maximum bit depth supported by the X server.
−installcmap
Specifies that MAE should force the installation of its X colormap. This option is provided only as a solution for window managers or X servers that do not install X colormaps correctly.
−noextensions
Specifies that system extensions are disabled when MAE is started.
−nommap
Specifies that MAE will not try to run in specific memory locations on the workstation. Using this option will cause more real memory resources to be utilized.
−nomodmap
Specifies that all keystrokes will be interpreted by the X environment instead of being passed to MAE when MAE has focus.
−rebuild
Specifies that the desktop should be rebuilt when MAE is started.
−zappram
Specifies that the PRAM should be reset when MAE is started.
MAE OVERVIEW
The Macintosh Application Environment emulates the following Macintosh hardware and software:
• Motorola 68LC040 CPU
• Macintosh System 7.1
• 32-bit color QuickDraw
• up to 24-bit color, if supported by the X server
DATA INTERCHANGE
The Macintosh Application Environment supports data interchange with X clients by means of the standard ICCCM selection mechanisms and the MAE screen capture utility. MAE supports data interchange by means of the X Window PRIMARY and CLIPBOARD selections. If both selections are available, MAE uses the most current selection. MAE supports export and import of the following X data target types:
TEXT Targets
STRING
COMPOUND_TEXT
TEXT
IMAGE Targets
PICT
PIXMAP/COLORMAP pairs
PIXMAP (using X default colormap)
DRAWABLE
BITMAP
FOREGROUND
BACKGROUND
RESOURCES
The Macintosh Application Environment’s application class is Mae. The following resources are defined:
iconic boolean
Specifies that MAE should start as an icon. The default is False.
title string
Specifies the title that the window manager displays in the window’s title bar. The default title is "Macintosh Application Environment <version>".
systemFolder systemfolder
Specifies the directory that mae should use as the System Folder. If the specified directory does not exist, a new System Folder is created in the specified systemfolder directory. The default is $HOME/System Folder.
appleDirectory appledirectory
Specifies the Apple directory, containing the MAE startup files, that the mae program should use. The default Apple directory is created when the Macintosh Application Environment is installed. By default, the MAE Installer installs the MAE startup files in $HOME/apple.
maximumDepth bit_depth
Specifies the maximum frame buffer bit depth (for example 2, 4, 8, 24). Setting maximumDepth will affect the number of colors available in the Monitors control panel. The default value is dynamically set to the maximum bit depth supported by the X server.
installColormap boolean
Specifies that MAE should force the installation of its X colormap. This option is provided only as a solution for window managers or X servers that do not install X colormaps correctly.
ENVIRONMENT VARIABLES
DISPLAY
Specifies the X server to use.
XENVIRONMENT
Specifies the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.
FILES
$HOME/System Folder MAE personal System Folder
$HOME/.mac MAE personal directory (contains desktop files and PRAM settings)
apple Apple resource directory (contains MAE files and resources)
apple/bin/mae MAE program
apple/bin/macd MAE helper daemon
/usr/lib/X11/app-defaults/Mae
MAE default resource file
SEE ALSO
COPYRIGHT
Copyright 1995, Apple Computer, Inc.
See the Macintosh Application Environment license agreement for more information.
— October 12, 1995