Next: macro() Up: MacAnova Help File Previous: logistic()   Contents


Keywords: general
Summary of features special to the Macintosh version.

There can be up to nine command/output windows.  Everything you type and
all character output goes in the frontmost one.  You can create a new
window using New Window on the Windows menu or Open on the File menu.
The latter loads the window with the contents of the file selected.  You
can switch between windows, close them or hide them using the Windows
menu.  You can print all of a window or a selection from a window by
selecting Print Window or Print Selection on the File menu.  You can
save their contents as files on disk by selecting Save Window or Save
Window As on the File menu.

There are eight high resolution graphics windows plus two panel windows,
Panel 1-4 and Panel 5-8, which display the other graph windows in
miniature.  You can switch between graphics windows, close them or hide
them using the Windows menu.  Any graphics window including the panel
windows can be printed using Print Graph... on the File menu or copied
to the clipboard for pasting into the Scrapbook or other application
using Copy on the Edit menu.  You can direct a plot to graph window i by
plotting keyword phrase 'window:i', where 1 <= i <= 8.  'window:0' puts
the graph in the window most recently written in.

You can display any graph window by pressing Command+1, Command+2, ...,
Command+8 or Command+F1, ..., Command+F8, and display panel windows by
Command+G.  Command+G also switches to the other panel window when a
panel window is displayed.

All windows have a close box in the upper left corner, a resizing box in
the lower right corner, and a zoom box in the upper right corner.
Output windows also have a scroll bar for moving backward and forward
through output.

                          Executing a Command
MacAnova recognizes a command as being ready to execute only if the
cursor is at the end of the line when you hit Return, or if you hit
Enter (see next paragraph).  Of course, as in all versions, the line
will not be accepted as complete if there is any '{' unmatched by a
corresponding '}' or if there is an unfinished quoted string
started by '"'.

The Enter key is not equivalent to Return but might be considered an
"execute" key.  It behaves differently depending on whether you have
selected text before the prompt in the output window.  Command+Return or
Shift+Return are both equivalent to Enter.

  (a) If nothing is selected with the mouse in the output window, Enter
  is equivalent to moving the cursor to the end of the command line and
  pressing Return.  This causes the command on that line to be executed
  unless there is an incomplete quoted string or unbalanced curly
  brackets ({...}).  This is particularly useful when editing a command
  about to be executed.  No matter where in the line the cursor is,
  Enter causes the edited command to be executed, while Return does not
  initiate execution unless the cursor is at the end of the line

  (b) If you have used the mouse to select text before the current
  prompt, Enter causes it to be copied to the end of the current
  command line, followed by Return.  Except when there are unbalanced
  curly brackets or an incomplete quoted string, the current command
  line is then executed.  This makes for very easy re-execution of
  commands, possibly after editing them in place.

Item Copy and Execute (or Execute, when nothing is selected in the
output window) on the Edit menu does the same thing as Enter, as does
pressing Command+\ or key F6.

                      History of Previous Commands
Typed commands are automatically saved in an internal "history" list.
You can move through this list, inserting previous commands after the
prompt, using items Up History and Down History on the Edit menu.

By default, MacAnova saves the most recent 100 lines.  To change this,
say, to 150, type 'setoptions(history:150)'.  See topics setoptions(),

Pressing F7 or the key combination Option+up-arrow is equivalent to
selecting menu item Up History.  Pressing F8 or Option+down-arrow is
equivalent to selecting Down History.

Command+Option+up-arrow retrieves the oldest saved command.
Command+Option+down-arrow reinserts whatever you had originally typed,
if anything, before recalling earlier commands.

                        Moving Around the Window
Arrow keys move the cursor as you would expect.  Command+B (Back) and
Command+F (Forward) are equivalent to the left- and right-arrow keys.
There is no equivalent to the up- and down-arrow keys.

Pressing the Option key while pressing a left- or right-arrow key moves
backward or forward one "name" (stretch of characters that are legal in
names).  Pressing the Option key while pressing an up- or down-arrow key
inserts previous commands at the prompt similar to items Up History and
Down History on the Edit menu.

Pressing the Command key while pressing an arrow key moves the cursor to
the start or end of the line (left- or right-arrow) or the top or bottom
of the window (up- or down-arrow).  Repeated use of Command+up or
Command+down-arrow scrolls through the window, moving the cursor as it

Pressing the Shift key while using an arrow key selects whatever is
between where you start and where you end.

Command+A (Go To Prompt on the Windows menu) moves the cursor to the
start of the current command line, just after the current prompt.

Command+E (Go To End on the Windows menu) or End on suitable keyboards
moves it to the end of the current command line at the very end of

Command+T (Scroll To Top on the Windows menu) or Home scrolls to the Top
of the current command/output window.  Command+U (or Page Up) scrools
back a screenful.  Command+D (or Page Down) scrolls forward a screenful.
These do not move the cursor.

                         Specifying File Names
When you use "" as the file name in any command requiring one (for
example vecread("")), the usual Macintosh scrolling dialog box lets you
select the file.  You can also use an explicit file or "path" name.  In
the latter case, if the name does not contain ':' (which would identify
it as a "path" name), MacAnova will look for it first in the default
Folder (see topic 'files') and then in the Folders specified in pre-
defined CHARACTER vector DATAPATHS.  See topics 'file_names',
'DATAPATHS', adddatapath(), 'customize'.

Selecting item Help on the Apple menu is equivalent to typing 'help()'.
If a word, say 'matrix', is selected in the window, item Help is
equivalent to 'help("matrix").  Command+H or the Help key does the same.

Command+. (period) or Command+I may be used to interrupt an operation or
output.  Depending on the operation it may not be recognized

                               File Menu
Open (Command+O) creates a new output window and reads a file into it.
It might, for example contain output from a previous MacAnova session.

Save (Command+S) and Save As write the current command/output window to
a file.

Page Setup and Print/Print Selection/Print Graph (Command+P) do what you
would think they should do.

Interrupt (Command+I) is equivalent to pressing Command+. (period) (see

Go On resumes computing after a graphing command with keyword phrase
'pause:T'.  See topic 'graph_keys'.

Save Workspace (Command+K) and Save Workspace As invoke save()
(asciisave() if asciisave() was used previously).  See save() and

Open Batch File (Command+Option+O) is equivalent to 'batch("")'.  See

Spool Output to File (Command+Option+S) is equivalent to 'spool("")'.
If a spool file has previously been specified this menu item will be
Stop Spooling or Resume Spooling and is equivalent to 'spool()'.

                               Edit Menu
In the output/command window you can use Undo/Redo (Command+Z), Cut
(Command+X), Copy (Command+C), and Paste (Command+V) in the usual way.
For a graph window only Copy is active.

Copy to End (Command+/) copies the current selection to the end of
the command line without putting it on the Clipboard.

Copy and Execute/Execute (Command+\) is equivalent to pressing Enter
(see above) in the output command window.

Up History inserts the previously typed command after the prompt.
Repeated selection of Up History successively inserts older and older
commands.  It is equivalent to pressing the Option and up-arrow keys.

Down History moves forward through previously saved commands, inserting
them after the prompt.  It is equivalent to pressing the Option and
down-arrow keys.

Function keys F1, F2, F3, F4, F5, F6, F7 and F8 are equivalent to
Undo/Redo, Cut, Copy, Paste, Copy To End, Execute (Copy and Execute), Up
History and Down History, respectively.  Enter, Shift+Return and
Command+Return are additional keyboard short cuts for Execute.

                              Windows Menu
This menu allows you to close or hide a window (Close and Hide), create
a new output/command window (New Window or Command+N), select a graph
window (Graph 1, Graph 2, ... Graph 8, Panel 1-4 and Panel 5-8), select
an output command window by name, and move around the output/command
window (Scroll To Top, Go To End, Go To Prompt, Page Up, Page Down).

                              Command Menu
The last 8 items are pre-defioned commands that are inserted in the
output/command window.  You can also select them by pressing Command+
+Option+1, ..., Command+Option+8.

Edit Commands... allows you to edit or replace any or all of the 8
commands.  Since each command can be a macro, this allows a great deal
of flexibility.

                              Options Menu
Significant Digits, Output Formats, Random # Seeds, Angle Units, GLM
Options, Batch Options and Other Options allow you to set many of the
items that can be changed by setoptions().

                               Font Menu
Size allows you to change the font size of the text in the current
output/command window.

The remaining items are the names of fonts you can select for the text
in the current output/command window.  You should probably restrict
your choices to non-proportional (equal character width) fonts such as
Monaco or Courier.  The default font is McAOVMonaco 9, a modified form
of Monaco 9.  Courier 18 may be preferable for use with an overhead
projector.  You can also change fonts using setoptions() using keywords
'font' and 'fontsize'.  See topic 'options'.

                           Other Information
MacAnova can "background", that is it will continue running when you
switch to another application under System 7 or when you are using
Multifinder under earlier systems.

Option+'<', Option+'>' and Option+'=' are recognized as equivalent to
'<=', '>=', and '!=', respectively.  Option+'\' and Option+'|'
(Option+Shift-'\') are recognized as equivalent to '<<' and '>>',

The shell() command and special treatment of lines starting with '!' is
not available on the Macintosh.  On System 7 or later, you can run other
programs just be starting them.  On SYstem 6 you can do the same using
Multifinder.  On all systems you can run Desk Accessories from within

Files produced by save() in all Macintosh versions 3.xx and 4.xx, but
not 2.xx, can be restored.  However, files produced by asciisave()
should restore correctly.

Color is not supported under MacAnova except in so far as the system
provides it automatically for all applications.

Gary Oehlert 2003-01-15