        Release notes for VMS port  of  XV  2.0 (xv-2.00.tar, released
    2-JAN-1992).       Port  was  mainly  done    by    David    Jones
    (jonesd@kcgl1.eng.ohio-state.edu)  with some contributions by Rick
    Dyson (Dyson@IowaSP.Physics.UIowa.EDU) using the VMS VAXC compiler
    and DECWindow libraries.

Installation instructions are at the bottom of this file.

Command procedures:

    MAKE_XV.COM
        This  command  procedure  is a "poor-person's" version of MMS.
        PLEASE NOTE:  You should look through the command procedure to
        see  if any customizing is necessary  before  executing  them!
        If you have MMS you might want to use that method instead.

    MAKE_JPEG.COM
        This procedure  is  called by MAKE_XV.COM to compile and build
        the JPEG library.    This is not needed if you use MMS.  Check
        the customizing sections for your system.

    SETUP.COM
        A simple command procedure  to setup the final XV package.  It
        an be executed by itself  or  used  with  many of the commonly
        available SETUP packages.  If kept  in  the  same directory as
        the binaries, it will be able to  get  the  necessary  symbols
        setup anywhere the directory structure is located WITHOUT  the
        need  to  edit  the command procedure.  Move them  all  around
        together and you will be OK.

Make files:

    MAKEFILE.VMS (in the top level directory)
        This is a MMS  description  file for the VMS MMS utility.  You
        should  edit  the file first  to  make  sure  the  customizing
        features  are  appropriate  for  your system.   To  produce  a
        working  version  of XV and BGGEN just  type
                      MMS /Description = MAKEFILE.VMS
        at  the  DCL command prompt.  For users without MMS  you  will
        need to use MAKE_XV.COM instead.

    MAKEFILE.VMS (in the JPEG sub-directory)
        This is a MMS description file for the VMS  MMS  utility.  You
        should  edit  the  file  first  to  make  sure the customizing
        features are  appropriate  for  your  system.    To  produce a
        working version of  the  JPEG  library  type  MMS  at  the DCL
        command prompt.  For  users  without  MMS you will need to use
        MAKE_JPEG.COM instead.

VMS specific source files:

    VMS.C     - Miscellaneous  routines   to  support  UNIX  functions
                missing from the  C  run-time  library.    Also define
                do_vms_wildcard() function used to  fixup the argument
                vector.

                Private version  of qsort added, Kevin Oberman claimed
                the  VAXCRTL  qsort   bug  (well  known)  was  causing
                aberrant images.  There are also remnants of a aborted
                attempt at adding uncompress support.

    VMSREADDIR.C  - Substitute   routines  for  UNIX  directory  scan
                routines  (opendir),  perform  equivalent  VMS  system
                calls.

    DIRENT.H  - Include file  to  use  in conjunction with routines in
                VMSREADDIR.C.

    PSEUDO_ROOT.C -  Finds virtual root  window  for DECWindows window
                manager.

    GIFMAPF.C - VMS optimized GIF file  access routines, maps the file
                to virtual memory and treats it as an array.

    GIFDECOMP.MAR -  Optimized  GIF decompressor routines, written  in
                MACRO.

    ARGPROC.C  -  getredirection() routine  to  implement  the  piping
                  and/or redirection of I/O.  Makes  VMS command lines
                  work like the Unix lines.

    INCLUDES.H - Header file for ARGPROC.C code.

    DECOMPRESS.C - A decompression program  for  Unix-style  .Z  files
                which can be used by XV for automatic decompression of
                .Z files.  It can also  be  used  at  the DCL level to
                decompress files by hand.

    XVPDS.C   - Reader  of  PDS/VICAR  file  formats of the  NASA/AMES
                spacecraft images.

    PDS.H     - Header file for the XVPDS.C code.

    VDCOMP.C - A decompression progrma for Huffman encoded PDS files.
               Called by XVPDS.C.

Documentation files:

    XV.HLP - A brief VMS Help file written from the man page.

    XV.TEX - A LaTeX formated version of the Unix man page.

    TROFFMAN.STY - A LaTeX style file for the LaTeX document.

Installation Instructions:

        Step 0:
            You  need  to have installed the DECWindows programmer kit
        with  the  C  language file selected.  You need a  C  compiler
        compatible  with  the VAXC installed as well, including the .h
        files in SYS$LIBRARY.

        Step 1:
            The first step in getting  XV  (v2.00) running on your VMS
        system is to get the Unix  source  files  on  your disk in the
        structure intended by the Unix environment.   This  should  be
        like the following:

            [XV-2_00]---+---[.BITMAPS]
                        |
                        +---[.DOCS]
                        |
                        +---[.JPEG]
                        |
                        +---[.UNSUPT]

            The original Unix compressed tar file can be obtained from
        export.lcs.mit.edu (make sure you  get version 2.00!).  If you
        don't have the tools to  decompress/detar  it, then Dave Jones
        has made a VMS text library  of  the  source code available at
        his ftp site, job.acs.ohio-state.edu.

        Step 2:
            You are now  ready  to  build the code.  IF you DON'T have
        MMS, go to Step 3.

            Since  you    have   MMS,  you  should  look  through  the
        MAKEFILE.VMS file to  check for any customizing changes.  Note
        specifically the references to  LZW  and  JPEG.   This is also
        true for the MAKEFILE.VMS in the JPEG sub-directory.

            When you are satisfied that everything is correct for your
        site, just type MMS and sit back and  watch  XV  being  built.
        This  may  take  quite  a  while  depending  on  your   system
        speed/load.    It may also require that your system have  it's
        virtual memory increased.  If you get an error message of this
        type, see a system guru for help!

        Step 3:
            If  you  don't  have  MMS  you  will need to  execute  the
        supplied  command  procedure  to  build  the  XV package.  You
        should look  through  the  MAKE_XV.COM  file  to check for any
        customizing changes.   Note specifically the references to LZW
        and JPEG.  This is also true for the MAKE_JPEG.COM in the JPEG
        sub-directory.

            When you are satisfied that your site changes are correct,
        execute the MAKE_XV.COM and watch it  build  the  package.  If
        there are any problems you will want to  delete  the offending
        .OBJ file so the command procedure will try to  build it again
        instead of skipping to the next one.

        Step 4:
            If there were no errors,  you should be finished and would
        just need to execute SETUP.COM to start viewing images!!!

