     (This document is best viewed in a monospaced font)

                            M A C A N O V A   5.04
                                 Release 1
                               August 18, 2005

   An Interactive Program for Statistical Analysis and Matrix Algebra
        Copyright 2005, Gary W. Oehlert and Christopher Bingham

This file is the installation guide for the MacAnova on Linux 
and is part of the distribution of MacAnova 5.04 for Linux. 

This document contains the following sections:

Introduction                     Distribution conditions and information
                                 about documentation

Which Platform Do You Want?      Describes available platforms and their
                                 requirements

What Files Do You Need?          Lists the files you should download

Downloading from the Web         Describes procedure for downloading
                                 files

Using the rpm installer          Describes procedures for installing
                                 MacAnova after downloading files and the
                                 installer program from the Internet.

What to Do After Installation    Running MacAnova

File listing                     What is in the installation files



                              Introduction

MacAnova is distributed under the terms of the GNU Public License,
Version 2.  See file Copying.txt distributed with MacAnova.  The latest
versions of MacAnova may be obtained over the Internet from its home
page
   http://www.stat.umn.edu/macanova/

You can get documentation and source code there as well.

See file Readme.linux.txt for information on documentation, starting
MacAnova and features specific to Linux.

Copying.txt and Readme.linux.txt are installed automatically with MacAnova
in the SharedSupport directory.

A standard MacAnova installation includes two program files (one for
X11-GTK and one for xterm), various auxiliary help and macro files,
all documentation in PDF format, and all help in html (browseable)
format.

                        Which Platform Do I Want?

Most people will want to use MacAnova for Linux interactively (the
windowed forms of MacAnova use the Carapace toolkit and are sometimes
referred to as Carapace, cpc, or cp versions of MacAnova).  People who
want to work noninteractively or do production work may wish to use
the command line/xterm version. The installer includes both versions.


                        What Files Do You Need?

MacAnova for Linux comes as a single rpm file.  The rpm will have a
name similar to macanova-5.04-2.i586.rpm, where the numbers reflect
versioning (in the example, version 5.04 release 2).


                        Downloading from the Web

Start at the download page www.stat.umn.edu/macanova/downloadlinux.html.
Right click on the link to download the rpm.  You can save the rpm to
any other convenient location on your hard disk.  That's really all
there is to it.


                           Installing MacAnova

At this stage you should have the rpm on your hard disk.

The default installation puts files in /usr/lib/macanova and
/usr/bin.  To install there, you must be able to run with root
privileges.  The basic install command is

  sudo rpm -i macanova-5.04-2.i586.rpm

This works if you are an authorized user listed in file /etc/sudoers.
If not, you su to root and use command

  rpm -i macanova-5.04-2.i586.rpm

If you do not have root privileges, or if you wish to put the
MacAnova installation in a nonstandard location, you may do so via the
--prefix option to rpm.  For example,

  rpm -i --prefix /home/gary/downloads macanova.all-5.04-2.i586.rpm

will put files in /home/gary/downloads/bin, /home/gary/downloads/lib
and so on.  In other words, the prefix will replace /usr in the path of
the files that are loaded.  The scripts should be set up to work
properly if you relocate the package.

If you want to remove MacAnova, use

  [sudo] rpm -e macanova-5.04-2

where the [sudo] may or may not be required.

IMPORTANT NOTE:
The Linux GTK executable was compiled using shared libraries.  That means
that it does not stand on its own, and will need to search for and 
find those libraries on your system before it can run.  If you are
missing one of the required libraries, you will need to install it.
You can find the list of required libraries via the command
  ldd macanovacpc
The list is discouragingly long, but does not contain anything esoteric:
c/c++ (libgcc, libstdc++, libc, libm)
system (libdl, libpthread, ld-liunx)
Gnome (libgtk-x11, libatk, libgdk_pixbuf, libpangoxft, 
        libpangox, libpango, libgobject, libgmodule,
        libgthread, libglib)
X11 (libX11, libXrandr, libXi, libXext, libXft, libXrender)
image (libpng, libjpeg, libtiff)
xml (libexpat)
compression (libz)
fonts (libfontconfig, libfreetype)


                       What to Do After Installation

You don't need the rpm for running MacAnova.  You can delete it
or save it.  

In KDE or Gnome, you may start MacAnova by clicking its icon in
the file explorer, or by adding MacAnova to your system menu lists.

At a command line window (e.g., xterm), you can start GTK MacAnova
with the command macanovacpc.  You may need to preface it with the
path if you have not installed MacAnova in the standard place.  For
example, ~/downloads/bin/macanovacpc  if you put MacAnova into your
downloads directory.  Similarly, you may start the command line
version of MacAnova with the command macanova.  Again, you may need
to preface the command with the full path.

From an xterm, there are number of command line options you can use.
For example,
     macanovacpc -q -data mydata.txt
suppresses printing the startup "banner" (-q) and sets mydata.txt as the
default data file used by macro getdata.  In MacAnova, type
help(launching) for details on such options.


                            File Manifests

Here are the files installed for MacAnova.  We use PREFIX to be a
shortcut for the prefix where MacAnova was installed; by default,
PREFIX is /usr.  

        Files in PREFIX/bin
macanovacpc              A one line shell script pointing to 
                          PREFIX/lib/macanovacpc including some
                          command line options to establish search
                          paths
macanova                 A one line shell script pointing to 
                          PREFIX/lib/macanova including some
                          command line options to establish search
                          paths

        Files in PREFIX/lib/macanova
macanovacpc              Macanova for GTK program file
macanova                 MacAnova (nonwindowed) program file

        Files in PREFIX/lib/macanova/SharedSupport
MacAnova.hlp.txt         MacAnova Help File
Tser.hlp.txt             Help for Macros in Tser.mac
Design.hlp.txt           Help for Macros in Design.mac
Userfun.hlp.txt          Help related to user functions
Arima.mac.txt            File of macros for time series analysis in
                             the time domain and nonlinear regression
Tser.mac.txt             File of macros for time series analysis in
                             the frequency domain and some plotting
                             macros
Graphics.mac.txt         File of macros related to making graphs
Gui.mac.txt              File of macros related to the graphical interface
Gui.dat.txt              File of dialog definitions to the graphical interface
MacAnova.mac.txt         File of most pre-defined macros plus other
                              miscellaneous macros
Math.mac.txt             File of mathematics related macros,
                             including optimization, factoring and
                             matrix decomposition
Mulvar.mac.txt           File of macros for multivariate analysis,
                             including factor analysis and discriminant
                             analysis
Regress.mac.txt          File of macros related to regression,
                             including stepwise regression
MacAnova.dat.txt         Sample data file
MacAnova.ini.txt         Sample startup file
Copying.txt              File summarizing the form of copyright and
                             giving conditions underwhich MacAnova may
                             be copied
Banner.gif               A splash banner for MacAnova
*.htm                    Four html files used in the About MacAnova dialog
Install.linux.txt        A copy of this file
Readme.linux.txt         Read Me file

        Files in PREFIX/lib/macanova/SharedSupport/afm
*.afm                    14 Adobe font metric files 

        Files in PREFIX/lib/macanova/SharedSupport/docs/pdf
Intro.pdf                "An Introduction to MacAnova"
man*.pdf                 Chapters of "The MacAnova User's Guide"
reference.pdf            "The MacAnova Reference Manual"

        Files in PREFIX/lib/macanova/SharedSupport/docs/html
*.htm                    More than 700  html files with hyperlinked help.
                            Start with index.htm or Contents.htm

        Files in PREFIX/lib/macanova/SharedSupport/userfun
userfun.h                C header file for writing user functions
dynload.h                C header file for writing user functions
goo.c                    Sample user function C source
foo.c                    Sample user function C source
fooeval.c                Sample user function C source
foosym.c                 Sample user function C source

 
Happy Computing!

Gary W. Oehlert          gary@stat.stat.umn.edu
Christopher Bingham      kb@stat.stat.umn.edu
University of Minnesota
School of Statistics
313 Ford Hall
224 Church Street, S.E.
Minneapolis, MN 55455-0493

August 18, 2005

