PICASSO INSTALLATION NOTES 
September 5, 1990

This document explains how to install picasso from a tar file (or tape) on 
either a machine or network of machines.

1.  The picasso account

	Picasso must be installed in the home directory of the picasso account.
This account should be created with group picasso and any picasso users 
should be members of the picasso group.  In addition to a home directory
with ample space (40-60 megabytes recommended for one architecture, plus 30 MB 
for each additional architecture), the picasso account must be provided with
write permission in the local lisp library directory (typically
/usr/local/lib/cl/code).  

2.  Setting up the picasso directory tree.

	The tar version of picasso has been set up to allow you to extract
it directly from the picasso home directory.  All pathnames are relative.  

FOR FTP USERS:

	You should have already transferred the file PICASSO-1.0.Z from 
postgres.berkeley.edu to your machine.  Uncompress this file and place it in 
the home directory for the picasso account.  Extract the Picasso directory
tree with the command:

	tar xvf PICASSO-1.0

FOR TAPE USERS:

	The tape you have includes these installation and release notes, a 
README file, and the tar-format file PICASSO-1.0.  Extract these from the tape
into the picasso account home directory.  Then, extract the rest of the Picasso 
directory structure with the command:

	tar xvf PICASSO-1.0

3.  Changes to the Picasso Account

	The .cshrc file provided with Picasso includes a path that works on 
most standard unix machines.  If your machine is configured in a non-standard 
way, the installation will fail and you should change the path in that file.

4.  Installing Customized Picasso Sources

	Run the shell script in ~picasso/bin/pic-install.  This will
prompt you to enter information Picasso needs to be properly installed.  
Specifically, you will need to know the locations of your lisp library and 
of a lisp image that does not include PCL, CLX or Allegro Composer.

5.  Customizing your machine configuration

	You must edit one shell script ~picasso/bin/machtype to include the name
of each machine that will be used to run Picasso.  The template shows that a 
line is entered for each machine that prints out the type of that machine.  Edit
this file to include your local machines.  The asterisk at the end of each 
machine name allows the pattern to match even when given fully-qualified 
internet names.

6.  Compiling Picasso

	There are two steps involved in compiling Picasso.  First you will
create a lower-level image called pcl-clx that contains all of the base packages
used by picasso:

	cd ~picasso/release/src/sys
	make pcl-clx

	When this has completed, you can make the complete Picasso image:

	cd ~picasso/release/src
	make picasso

6.  Getting Started

	We suggest that you print out any reference materials (from ~picasso/doc
that you do not already have copies of.  Each user of picasso should also edit
his path variable to include ~picasso/release/dumps/`~picasso/bin/machtype` in
the path.  This assures that the dump for the correct architecture is always 
used.  Most users will also want to add ~picasso/bin to their paths.

	Now we suggest you run a sample Picasso tool to ensure that Picasso is
correctly installed.

	a.	Start picasso (just type "picasso" to the shell if your path is
                               set correctly)
	b.      You should get the <picasso> prompt from lisp.
	c.      Enter (run-tool-named '("paper" "demo" . "tool"))
                This will run the tool described in the Picasso Programming 
                Model paper.  Other tools you can run include:
        		'("fmtool" "tool")
        		'("form-test" "tool")
        		'("test" "tool")

	And now, you can start using Picasso!
