* Table Of Contents MAE 2.0 - Installing and Getting Started - Preface Chapter 1 *

Preface

Macintosh Application Environment (MAE) is an Apple software product that runs a virtual Macintosh environment on your UNIX workstation. MAE displays the Macintosh desktop interface in an X window. The Macintosh desktop within the MAE window gives you access to your Macintosh applications as well as to UNIX files.

This book explains how to install and set up MAE and how to perform some basic operations (how to start and quit MAE and how to print using MAE). MAE also comes with two on-line documents: Macintosh Application Environment User's Guide, which provides detailed instructions on the use of MAE, and MAE System Administrator's Guide. You can print the on-line documents using the printing instructions in Chapter 4 of this book, or in Chapter 4 of the MAE User's Guide. See also "On-Line Help and Documentation," later in this chapter.

What you need to know

This book assumes that you are familiar with UNIX and with the X Window System. You should know how to perform basic tasks on your workstation, including starting and quitting X applications.

For general information about the X Window System, you may want to read the X Window System User's Guide for X11 Release 5, published by O'Reilly and Associates, Inc.

This book also assumes that you are familiar with the Macintosh user interface, including the use of icons, windows, and folders. For a summary of Macintosh commands, see Appendix A of the MAE User's Guide, which provides information on basic Macintosh skills. For complete information on the use of the Macintosh, see Macintosh User's Guide (part number
030-2651-B). Macintosh User's Guide is not included with MAE.

New features in MAE version 2

MAE version 2 contains many new features that considerably expand its usefulness:

What's covered in this guide

This guide contains information on the following topics:

Terminologyused in this guide

This section explains the terminology used in this guide to refer to modifier keys and to various mouse and keyboard operations.

Modifier keys

This book refers often to several modifier keys that appear on standard Apple keyboards: Command (x), Option, Control, and Caps Lock. Since most workstation keyboards do not come with these modifier keys, MAE assigns the Macintosh modifier keys to keys on your workstation keyboard. MAE also assigns two commonly used X Window System modifier keys, Alt and Mode Switch, to keys on your keyboard. When this guide mentions the name of a Macintosh modifier key, such as Option, you should use the key on your keyboard to which it has been mapped.

To check your modifier key settings, open the MAE Keyboard control panel. (Choose Control Panels from the Apple ([[apple]]) menu and double-click the icon for the MAE Keyboard control panel.) To learn to reassign modifier keys, see "Changing the Keyboard Mapping" in Chapter 9 of the MAE User's Guide.

Mouse buttons

This book often refers to the mouse button, because the Macintosh operating system (Mac OS) was designed to be used with a single-button mouse. The phrase the mouse button refers to the first button (often called "the leftmost" button or "Mouse Button 1") on a mouse or trackball with multiple buttons. For example, if a step instructs you to "press the mouse button," you would press the first button on a three-button mouse.

You can use X window features to change the mapping of the mouse buttons.

Basic mouse and keyboard operations

In this guide, some terms represent a series of actions that you perform with the mouse, keyboard, or both. For example, the word enter indicates that you type a character (or a series of characters), then press the Return key.

Here is a list of standard terms for mouse and keyboard operations and the meaning of each term.

Term Action
ClickPress and then immediately release the mouse button.
Double-clickPress and release the mouse button twice in quick succession without moving the mouse.
DragPosition the pointer on an item on the screen, such as an icon that you want to move. Press and hold down the mouse button while moving the mouse until you have accomplished the desired task, such as moving the icon to a new location, and then release the mouse button.
ChooseActivate a command in a menu by positioning the pointer on the menu title and dragging (usually downward) through the menu until the command you want is highlighted. Then release the mouse button.
SelectDesignate where the next action will take place. To select an object such as an icon, position the pointer on the object and click the mouse button once. When selected, the object appears highlighted. To select text, drag across the text until the entire range of text that you want to select is highlighted.
TypeType a series of characters without pressing the Return key.
PressPress a single key or key combination without pressing the Return key afterward.
EnterType a series of characters and then press the Return key.

On-line help and documentation

To use an on-line document, double-click the document icon located in the docs folder in your home directory. For details on using the on-line documentation, see Chapter 3 of this guide. For a more detailed description, see the Apple DocViewer Guide, which is also available in the docs folder.

The following on-line documents are shipped with MAE:

The Read Me file (README.TXT)

MAE also includes an on-line Read Me file, which provides late-breaking information about MAE, and troubleshooting information about installing and using MAE on your workstation. The Read Me file (named README.TXT) is located in the root directory of the Macintosh Application Environment CD-ROM disc. You can view the Read Me file by using the SimpleText application or a standard UNIX tool, such as more(1) or vi(1).

Balloon Help

MAE comes with a feature called Balloon Help, which provides immediate on-screen help when you need it. Many Macintosh applications also support Balloon Help. If you want to know more about a window, button, menu, command, or icon in the MAE window, use Balloon Help to get the information you need. For instructions for using Balloon Help, see Appendix A of the MAE User's Guide.


* Table Of Contents MAE 2.0 - Installing and Getting Started - Preface Chapter 1 *