Next: length() Up: MacAnova Help File Previous: labels   Contents

launching

Usage:
Unix/Linux and DOS: macanova [-q] [File Options] [Screen Options]
                    at Unix/Linux or DOS prompt
Macintosh:          Double click on MacAnova icon or MacAnova file icon
Windows:            Double click on MacAnova for Windows icon



Keywords: general, files
                          Nonwindowed versions
For non-windowed versions (Unix/Linux or DOS), type 'macanova' at the
Unix/Linux or DOS prompt.  If the MacAnova directory is not in the
search path, you will need to specify the complete path.  See below for
command line options.

For non-windowed versions, you may also use "redirected" input and
output to run an entire analysis noninteractively and save the output.
   macanova [options] < cmdFile > outputFile
will read commands from cmdFile and save the results in outputFile.

                        Microsoft Windows Version
If MacAnova is installed correctly under Windows 95/98/NT/XP there is
a MacAnova entry on the Start menu, with subentries for all installed
versions and possibly for browser based help files.  All versions can
also be launched from the DOS prompt.

In addition, the installer should also register the extentions
.mvbat, .mvsave, and .mvout for MacAnova batch files, save (workspace)
files, and output files.  Double clicking any file with one of those
extensions should start MacAnova, execute the batch file, restore
the save file, and/or open the output file.

Finally, you may drag and drop save, batch, and output files onto the
MacAnova for Windows icon.

See also topic 'dos_windows', 'carapace'.

                                Linux GTK
Assuming the Carapace GTK version has been named macanovacpc and is
in a directory in your search path, type

    macanovacpc [-q] [File Options] [Path Options] [Screen Options] 

at the Unix/Linux prompt, where items in [...] are options.  See below
for details on command line options.  

See also topics 'unix', 'carapace'.

                           Macintosh Mac OS X
Double click the MacAnova icon.  In addition, the Finder should also
recognize files with extensions .mvbat, .mvsave, and .mvout (files
with creator mat2 and types TeXT, S000, and TeXT) as MacAnova batch
files, save (workspace) files, and output files.  Double clicking
any file of those types should start MacAnova, execute the batch
file, restore the save file, and/or open the output file.  You can,
in fact, shift click on more than one such file and then choose Open
from the Finder File menu to do more than one operation.

It is possible, though rather awkward, to launch MacAnova from
a Terminal window.  Change into the directory where MacAnova is
located; it will show up as MacAnova.app.  Then change into the
MacAnova.app directory, and the Contents directory within that,
and the MacOS directory within that.  There you should find
macanovacpc, which is the actual executable.  Typing ./macanovacpc
will start MacAnova.  In this fashion you may also use command
line options.

See also topic 'macintosh'.

                          Command line options
The windowed versions of MacAnova have a greater array of command
line options than the nonwindowed versions.  However, most casual
users will never need these options, particularly for windowed
versions.

The following tables give an option, whether it is usable in
windowed (W) or nonwindowed (N) versions, and its use.  There will
be a 1 in the W or N column if an option can be used exactly once,
and an asterisk if the option can be used multiple times (up to 50).

                          File related options
Option              W  N   Use
-restore filename   1  1   execute restore("filename") at startup
-batch filename     *  1   execute batch("filename") at startup
-f startfile        *  1   execute batch("startfile") silently
-help helpfile      1  1   use helpfile as the default help file
-macro filename     *  1   add filename to variable MACROFILES
-open filename      *      open filename in a command window
-data filename      *  1   add filename to DATAFILES
-addhelp filename   *      add filename to HELPFILES
-config filename    1      use filename as the Carapace preference file

                          Path related options
Option              W  N   Use
-home pathname      1  1   set variable HOME to pathname
-appdir pathname    1      set MacAnova root directory to pathname
-path pathname      *      add pathname to DATAPATHS
-dpath pathname        1   add pathname to DATAPATHS
-mpath pathname        1   add pathname to DATAPATHS

                              Other options
Option              W  N   Use
-q                  1  1   suppress banner at startup
-prompt string      1  1   set the MacAnova prompt to string
-bprompt string     1  1   set the batch prompt to string (for -batch)
-e expression       1  1   execute expression at startup
-eq expression         1   execute expression and then quit
-l lines            1  1   set page height to l lines
-w columns          1  1   set page width to w columns
-hist count         1  1   set history length to count items

                             Option details

-restore saveFile 
  The equivalent of 'restore("saveFile")' is executed at startup and
  MacAnova.ini.txt is not read and executed.  See 'customize', restore().

-batch batchFile  
  The equivalent of 'batch("batchFile")' is executed after
  initialization.

-f initFile
  File initFile is executed silently as a batch file at startup instead
  of file MacAnova.ini.txt (see 'customize').

-help helpFile 
  Help information will be taken from file helpFile rather than the
  default help file MacAnova.hlp.txt.

-macro macroFile 
  "macroFile" will be added to the beginning of Pre-defined CHARACTER
  variable MACROFILES.  This will mean that pre-defined macro
  getmacros() will search the file before the standard macro files.  You
  can accomplish the same thing after starting MacAnova by
  addmacrofile("macroFile").  See topics getmacros() and addmacrofile().

-open windowFile 
  Load the contents of windowFile into a command-output window, as if
  Open were selected on the File menu.  No startup message printed.

-data dataFile 
  "dataFile" will be added to the beginning of pre-defined CHARACTER
  variable DATAFILES.  DATAFILES is used by pre-defined macro
  getdata() to make it easy to read data from a standard file.  See
  topic getdata().

-addhelp helpFile
  "helpFile" will be added to the beginning of pre-defined CHARACTER
  variable HELPFILES.  Files in HELPFILES are searched when using the
  command help().  See topic help().

-config configFile
  Use configFile instead of the default file MacAnova.config.  Some
  aspects of MacAnova (fonts, window sizes, etc) can be controlled
  through the configuration file.

-home homePath
  Predefined CHARACTER variables HOME will have "homePath" as value
  instead of a default value.  HOME is used to expand file names of the
  form "~/filename".  For instance, when HOME is "dataDir", "~/filename"
  is expanded to "dataDir/fileName".  See topic 'files'.

-appdir appPath
  By default, the last element of DATAPATHS is the directory where
  MacAnova is located.  You may override that value by using -appdir.
  This is really only useful on Unix/Linux, because the location of
  MacAnova cannot be determined at execution time and a default value
  must be used instead.  Here you can override the default.

-path pathName (or -dpath dataPath  or -mpath macroPath)
  Add pathName to the front of the CHARACTER vector DATAPATHS, which
  contains a set of directories that are searched when you attempt to
  read a file (for example, by using vecread(), read(), matread() or 
  macroread()). If the file cannot be found in the default directory,
  MacAnova searches in the directories in DATAPATHS.  See topic
  DATAPATHS.

If -q is present, the startup message will not be printed and the
  welcome screen is not shown.

-e Expr 
  Execute the MacAnova command in Expr as if it were the contents of 
  a batch file.  Expr will be executed before anything else is done.  

-eq Expr 
  Execute the MacAnova command in Expr as if it were the contents of 
  a batch file and then immediately quit.  Expr will be executed
  before anything else is done.  This option does not make sense
  for windowed versions.

-prompt Prompt 
  Sets the non-batch command line prompt.  Usually Prompt should end
  with a space, for example, -prompt "Next? ".  This becomes the default
  prompt that will be set by setoptions(default:T).  See topics
  setoptions(), 'options'.

-bprompt Prompt 
  Sets a prompt to be used with echoed commands in batch files
  specified on the command line (-batch batchFile). Usually Prompt
  should end with a space, for example, -bprompt "HW 1> "..

-l Nlines
  This pre-defines option 'height' to be Nlines, where Nlines is either
  0 or an integer at least 5.  On windowed versions, this only controls
  the height of "dumb" plots. See subtopic 'options:"height"'.

-w Ncols
  This pre-defines option 'width' to be Ncols, where Ncols is an integer
  at least 20.  On windowed versions, this only controls the width of
  "dumb" plots. See subtopic 'options:"width"'.

-hist Nhist
  This pre-defines option 'history' to be Nhist, an integer >= 0.  This
  limits the number of previous command lines that can be saved and
  recalled to Nhist.  The default value is 100.  See subtopic
  'options:"history".

See also topics 'quitting', 'customize'.


Gary Oehlert 2006-01-30