Obsvis Stand-alone Setup and Patch
===================================

I ) Stand-alone Obsvis

   1) Unpack the binary OBSVIS tarfile for your system:

      > cd <location you want to install obsvis>
      > gunzip -c ciao-4.0.1-bin-obsvis-<SYSTEM>.tar.gz | tar xvf -
	Note where <SYSTEM> = sun, osxppc osxi, fc4, or fc7

   2) Configure the installation 

      > cd ciao-4.0
      > ./configure

      At this point you can run obsvis by executing the command:

      <location where you installed obsvis>/ciao-4.0/bin/obsvis

      Note: While ds9 comes with the obsvis package, if you have ds9
      in your path, obsvis will try to use that version. If you get an
      error stating that the version is too old you can modify your
      path:

	setenv PATH <obsvis location>/ciao-4.0/ots/bin:$PATH (tcsh users)
	  -or-
	PATH=<obsvis location>/ciao-4.0/ots/bin:$PATH
	export PATH	(sh, ksh, and bash users)

      to make sure obsvis sees a current version of ds9.

      At this point you can run the smoke tests described in section III.

II ) Patching an existing CIAO 4.0 build

   1) Download the obsvis patch file ciao-4.0-bin-obsvis.tar.gz
      Note: that this patch is system independent and can be used
      	    to patch any of the binary CIAO 4.0 distributions.

   2) In the directory containing the ciao-4.0 subdirectory (the base of
      your CIAO installation):

	   > gunzip -c ciao-4.0.1-bin-obsvis.tar.gz | tar xvf -

   3) Rerun configure

	   > cd ciao-4.0
	   > ./configure
	     Note: If you used the switches --with-top=<dir> or
	     	   --with-imagerdir=<dir> you will need to use
		   those switches again. Please see INSTALL_BINARY
		   from your CIAO 4.0 distribution for more details.

   4) Setup for CIAO so the ahelp indexes can be built.

	   > source bin/ciao.csh   (tcsh users)
	     -or-
	   > . bin/ciao.sh (bash, sh, ksh shell users)

   5) Rebuild the ahelp indexes

           > ahelp -r

   At this point your CIAO 4.0.1 patch is complete and you can run the
   smoke tests described in section III.

III ) Smoke tests

   A set of tests has been packaged with obsvis. These tests are to
   verify the obsvis installation is working correctly.

   To run the smoke tests all you have to do is:

     > cd <obsvis location>/ciao-4.0/test
     > make test-obsvis

   You also can run an individual test by typing 'make
   test-obsvis-smoke#' (where # = 001 - 012) for example:

     > make test-obsvis-smoke004

   will run the obsvis-smoke004.sh, the General gui window creation
   test.

   Summary of Smoke Tests:
   -----------------------

    obsvis-smoke001.sh   : FoV ACA frame test
    obsvis-smoke002.sh   : Interactions with main menu
    obsvis-smoke003.sh   : ObsVis imager test
    obsvis-smoke004.sh   : General gui window creation
    obsvis-smoke005.sh   : Interactions with FoV instrument frame
    obsvis-smoke006.sh   : Ra/Dec parser
    obsvis-smoke007.sh   : ACIS chip buttons display and interactions
    obsvis-smoke008.sh   : ObsVis utility functions test
    obsvis-smoke009.sh   : Preferences setup
    obsvis-smoke010.sh   : Interactions with duplicate FoV dialog
    obsvis-smoke011.sh   : Instrument definitions test
    obsvis-smoke012.sh   : General message dialog box test