Next: xrows() Up: MacAnova Help File Previous: wtregress()   Contents


Keywords: general
Both the Windows and Unix/Motif versions of MacAnova make use of the
wxWindows version 1.68 windowing interface (see topic 'copyright').
There are minor differences in the look and feel of MacAnova on
different platforms.  Although the interface was patterned on the
Macintosh version, the matching is incomplete.

You can have up to eight command/output windows and up to eight high
resolution graphics windows.  All windows have four menus -- File, Edit,
Windows, and Help (no Edit menu on Motif graphics windows).

Commands are typed or pasted immediately after the prompt into the
front-most command/output window.

Editing the contents of the command/output window, including any command
being entered after the prompt, is done using the mouse and the

When the Windows or Motif versions are launched from the command line
with command line argument -open windowFile, where windowFile is a
text file, the contents of windowFile will be loaded into the
command/output window.  This simulates Open on the File menu.  See

                      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.
Pressing F7 or F8 is equivalent to selecting menu item Up History or
Down History, respectively.  Instead of F7 and F8 you can press the Ctrl
and the up or down arrow key on the key pad at the right side of the
keyboard.  In Windows, but not Motif, you can use Ctrl and the ordinary
up and down arrow keys.

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

                        Moving Around the Window
Arrow keys move the cursor as you would expect.

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

Ctrl+E (Go To End on the Windows menu) moves the cursor to the end of
the current command line at the very end of window.

Ctrl+T (Scroll To Top on the Windows menu) scrolls to the Top of the
current command/output window without moving the cursor.

                         Specifying File Names
When you use "" as the file name in any command requiring one (for
example vecread("")), a 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 ':' or '/' (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(),

The Windows version can read and write files with long names when
running Windows 95 or Windows NT.

Selecting item Help on the Help menu displays a dialog box containing
basic information on using command help().

Ctrl+I (Interrupt on the File menu) may be used to interrupt an
operation or output.  Depending on the operation it may not be
recognized immediately.  The Tab key does not trigger an interrupt.

                               File Menu
Open (Ctrl+O) allows you to read a file into a new command/output
window.  This would usually be the contents of a command/output window
saved on an earlier run, but can be any text file.  You select the file
using a dialog box.

Caution: Open is *not* how you read data from a file; for that you use
vecread(), matread() or readcols().

Save Window (Ctrl+S) saves the contents of the front-most command/
output window in a file.  If the window hasn't previously been saved,
you are asked to provide a name for the file in a dialog box.

Save Window As does the same, but always asks for a file name in a
dialog box.

Caution: Save Window and Save Window As do *not* save the values of your
variables or anything else in your workspace.  Use Save Workspace (see
below) or commands save() and asciisave() for that.

Page Setup allows you some control over how a command/output window is

Print Window (Ctrl+P) prints the contents of the window.  There is
currently no way to print part of the window as on a Macintosh.

Interrupt (Ctrl+I) interrupts any command that is running or stops
output.  See above.

Restore Workspace (Ctrl+R) is equivalent to restore(""), allowing you to
restore a previously saved workspace.

Save Workspace (Ctrl+K) is equivalent to save("") if there has been no
previous save or asciisave, or to save() otherwise.  See save().

Save Workspace As is equivalent to save("").  See save().

Quit (Ctrl+Q) is equivalent to typing quit.  You will be asked if you
want to save the workspace and any open command output windows.  If you
change your mind about quitting, you can click on Cancel in the dialog
box.  If you want to quit unconditionally, without the chance to save
stuff, type quit(F) at the prompt.  See topic 'quitting'.

When a graphics window is in front, the File menu contains only three
items, Interrupt, Go On and Print Graph.  Go On is used to restart
execution after pause:T is used on a plotting command (see 'graphs') and
Print Graph allows you to print a copy of the graphics window.

                               Edit Menu
The first four items are Undo, Cut, Copy and Paste.

Undo (Ctrl+Z) gives you a limited capability to undo changes to the
window.  After you have undone something, selecting Undo redoes what you
just undid.  Undo affects only the window and cannot change anything
that has been computed.

Cut (Ctrl+X) and Copy (Ctrl+C) are operative only when you have selected
some text with the mouse.  Both copy the text to an internal "clipboard"
from which it can later be retrieved.  Cut also removes the selected
text from the window.  The text on the clipboard can be pasted into any
window with a Paste item on its Edit menu, if there is one.  In
particular, under Windows, the text on the clipboard can be pasted into
a Microsoft Word or other word processor document.

Paste (Ctrl+V) inserts at the cursor any text that is on the clipboard,
perhaps because you just Copied or Cut it from elsewhere in the window.
The text may have been put on the clipboard in another program, allowing
you to transfer text to MacAnova.

The clipbord is "connected" to special variable CLIPBOARD.  See topic

Copy to End (F5) copies to the end of the command line any text that has
been selected with the mouse.  This is an easy way to reuse previously
typed commands.  In the Motif version, pressing Ctrl+/ also selects this

Execute (F6) is similar to Copy to End except it adds a Return after the
copied text.  This will usually cause the line to be executed.  When
nothing is selected, Execute simply adds a Return to the command line,
usually executing what has been typed.  This is helpful when you have
edited something in the middle of the line and then want to execute it.
Pressing Shift+Enter or Ctrl+Enter also selects this item; in the Motif
version, so do Ctrl+/ or Enter on the "keypad".

Up History (F7) inserts the previously typed command after the prompt.
Repeated selection of Up History successively inserts older and older
commands.  Ctrl+Keypad Up Arrow also selects this item; on Windows, so
does Ctrl+Up Arrow.

Down History (F8) moves forward through previously saved commands,
inserting them after the prompt.  Ctrl+Keypad Down Arrow also selects
this item; on Windows, so does Ctrl+Down Arrow.

By default, the Wx MacAnova versions save the most recent 100 lines.  To
change this, say, to 50, type 'setoptions(history:50)'.  See
topics setoptions(), subtopic 'options:"history"'.

When a graph window is in front, under Motif there is no Edit menu at
all.  Under Windows the only item is Copy.  This allows you to copy the
graph to the clipboard to paste into a Windows word processor or drawing

                               Windows Menu
Hide hides the front window without destroying its contents.

Close (Contol-W) closes the front window.  If it is a command/output
window you are asked if you want to save it.

Graphs pulls down a submenu allowing you to select any graph window in
use, including any that are hidden.  You can also use key combinations
Ctrl+F1, Ctrl+F2, ..., Ctrl+F8 to select a graph window.  In Motif, you
can use Ctrl+1, ..., Ctrl+8 instead.

Windows pulls down a submenu allowing you to select any command/output
window in use, including any that are hidden.

When a command/output window is in front, the following additional menu
items are available.

New (Ctrl+N) creates a new command/output window and makes it the front
window.  If there are already 8 command/output windows New does nothing.

Scroll to Top (Ctrl+T) scrolls the command/output window to the
beginning but does not move the cursor.

Go to End (Ctrl+E) moves the cursor after the last text in the
command/output window.

Go to Prompt (Ctrl+A) moves the cursor immediately after the prompt.

In the Windows version, but not Motif, there is also a Fonts item,
allowing you to change the font used in the command/output window.  The
default font is Courier New size 12.

In addition, there is a Help menu which doesn't do much except give a
little information on how to use help().

Workspace files produced by save() by the Windows version are restorable
by both DOS versions and Linux.  Files produced by the Motif version are
restorable by other Unix/Linux versions on the same computer.

See topic 'unix' for general information on Unix/Linux versions and
topic 'dos_windows' for general information about versions on
DOS/Windows systems.

Gary Oehlert 2003-01-15