Next: unlockvars() Up: MacAnova Help File Previous: unique()   Contents


Keywords: general
Two Unix/Linux versions are distributed.  One runs from the Unix/Linux
prompt (usually under Xterm on a workstation) with no special windows
except those generated by the operating system.  The other (Motif) uses
the Motif windowing system and operates similarly but not identically to
the Windows version.  It allows multiple command and high resolution
graphics windows.

               Features common to all Unix/Linux versions
Various command line arguments are recognized.  These allow automatic
restoring of a workspace, suppressing the startup message, etc.  See
topic 'launching'.

MacAnova recognizes options, file names and path names specified in
environmental variable MACANOVA.  See topic 'customize'.

The startup file is .macanova.ini in the users home directory unless
flag -f has been used on the command line (see 'launching') or in
environmental variable MACANOVA.  See topic 'customize'.

The size of variables is limited only by the amount of memory and disk
space available.

Unless you use command line option -home (see 'launching') or include
-home in environmental variable MACANOVA (see 'customize'), MacAnova
pre-defines CHARACTER variable HOME to contain the user's home
directory.  HOME is used to expand file names of the form "~/path" by
substituting the value of HOME for '~'.  This allows you to refer to
files such as .macanova.ini as "~/.macanova.ini" regardless of the
current directory.  When you redefine HOME, it changes the expansion of
"~/".  See topic 'files'.

File names starting with "~name/" are expanded similarly to csh.  That
is, name is taken to be a Unix/Linux user name and "~name" is expanded
to the path name of the home directory of that user.  Redefining HOME
has no effect on this expansion.  See topic 'files'.

Pre-defined variables DATAPATHS, and DATAPATH are initialized with path
names that are installation dependent (see topic 'DATAPATHS').  You can
override these using options -dpath or -mpath on the command line (see
'launching') or in environmental variable MACANOVA (see 'customize').

                            Non-Motif Versions
High resolution graphics are implemented by emitting codes appropriate
for plotting on a Tektronix 4014 graphics terminal.  When this is not
appropriate, you are limited to displaying "dumb" plots and should use
setoptions(dumbplot:T).  See topic setoptions(), subtopic

When MacAnova is running in a Xterm pseudo VT100 window on a work
station, the graphics commands open a pseudo Tektronix 4014 graphics
window and draw in it, switching back to the VT100 window when <RETURN>
is hit after the plot.  Be aware that certain vendor replacements for
Xterm (for example, hpterm and dterm) don't support Tektronix emulation.
To use high resolution graphics you need to start up an Xterm window.

You can execute Unix/Linux commands by prefixing the line with '!' in
the first position after the prompt or by using command shell().
Keyword phrase keep:T on shell() is recognized.  You must use keyword
phrase interact:T if the program being invoked expects any input from
you.  A line of the form '!command ...  ' is equivalent to
shell("command ...", interact:F).  See shell().

A pre-defined macro edit() is available which allows you to edit macros
and data from within MacAnova.

Depending on how it was compiled on a particular system, keyboard line
editing and history may be available as implemented using the GNU
Readline Library.  If so, the default editing mode is based on Emacs.
You can customize key bindings by creating a special file named
".inputrc" in your home directory.  This will be read each time MacAnova
starts up.  To enable editing based on Vi commands instead of Emacs, put
the following lines in this file:
   set editing-mode vi
   "k": previous-history
   "j": next-history
   "H": beginning-of-history
   "G": end-of-history

On some systems a standard environmental variable INPUTRC is defined and
keyboard bindings are taken from file $INPUTRC and not from ~/.inputrc.
If that is the case and you want to customize key bindings, you will
need to define INPUTRC in your .profile or .cshrc file.  For csh, tcsh
or derivatives use
  setenv INPUTRC $HOME/.inputrc
For sh, ksh, bash and other similar shells, use
  export INPUTRC=$HOME/.inputrc

When keyboard line editing is implemented, a "history" mechanism is also
available.  A certain number (default is 100) of previous commands are
saved.  Using the emacs editing mode, you can scroll backward by
pressing Ctrl+P (possibly also an up-arrow key) and scroll forward by
pressing Ctrl+N (down-arrow).  Under the vi editing mode, the
corresponding keys (when in vi command mode) are 'k' amd 'j'.  See
setoptions() for information on how to change the number of lines saved.

As part of this facility you also may have so-called file name
completion.  When you have partially typed a file name, press the Tab
key or press the Esc key twice and an attempt will be made to complete
it.  Press Tab twice or Esc four times and you will get a list of
possible completions.  See Readline documentation for information on
modifying key bindings using file .inputrc.  If you want to use the Tab
key as a regular key, but the following line in the .inputrc file:
"C-i": self-insert

                               Motif Version
This version is compiled using the WxWin windowing library so as to use
the Motif windowing system.  It allows up to eight command/output
windows with Copy, Paste and Undo capability and up to eight high
resolution graphics windows.

It has File, Edit and Windows menus which are patterned after the
Macintosh version.

Entering and editing of commands is done in a command/output window with
the mouse and keyboard.

Each command/output window can be printed, saved to a file or some or
all of its contents Copied to the Clipboard which is "connected" to
special variable CLIPBOARD (see topic 'CLIPBOARD').  In a similar
manner, special variable SELECTION is "connected" to the X selection.
This means you can select data or text in another Window and import it
into MacAnova.

Each graphics windows can be printed.  They cannot be copied to the
Clipboard in the Motif version.

See topic 'wx' for details on the Motif version.

Gary Oehlert 2003-01-15