==========================================================================
Product: stock
Purpose: command line interface to the web-based information from the
         Fermilab stock database (http://www-stock.fnal.gov/stock/)
==========================================================================
1) If you have previously installed a version of futil which included
   stock, then the following files will need to be removed from your
   system in order for this release of the stock product to function 
   properly:

	/usr/local/bin/stock

   You will need to do this for each of the /usr/local/bin areas within
   a cluster.

2) IF YOU WANT YOUR USERS TO BE ABLE TO USE stock WITHOUT DOING A SETUP,
   IT IS RECOMMENDED THAT YOU FOLLOW THESE INSTRUCTIONS:
	- log in as a user who can write into /usr/local/bin
	- make sure that any previous versions of stock and stock are
	  removed (see above)
	- setup this version of stock
	- execute the commands:
		$ cd /usr/local/bin
		$ ln -s $STOCK_DIR/bin/stock ./stock
		$ ln -s $STOCK_DIR/bin/stock ./stock
	  OR
		$ cd /usr/local/bin
		$ cp $STOCK_DIR/bin/stock ./stock
		$ cp $STOCK_DIR/bin/stock ./stock

	  In the first case, you are creating links to the real stock
	  files; in the second case you are actually copying the files
	  into /usr/local/bin.  The first has the advantage that you can
	  later tell which version of STOCK is being used and where
	  the files came from; the latter has advantages if the 
	  $STOCK_DIR area is NFS-mounted or otherwise not-necessarily-
	  available at all times.

   NOTE, these steps are NOT taken as part of the configuration/declaration
   of stock; you will need to do them manually if you want users to be
   able to use stock without setup.  If you do NOT put the stock and/or
   stock files into /usr/local/bin, users will still be able to use 
   the stock (stock) command, but only after they
	$ setup stock
   (either manually or in their login files).

   NOTE ALSO, you will need to take these steps on EACH of the 
   /usr/local/bin areas within a cluster.

3) THIS VERSION OF STOCK requires the LWP.pm perl module be installed.
   (This perl module is included in the product shells v2_2 and later).  If
   the LWP.pm module isn't available, stock will abort.
==========================================================================
