home *** CD-ROM | disk | FTP | other *** search
/ Stars of Shareware: Programmierung / SOURCE.mdf / programm / msdos / c / xv221src / unsupt / vms / readme.vms < prev    next >
Encoding:
Text File  |  1992-04-26  |  7.2 KB  |  167 lines
  1.         Release notes for VMS port  of  XV  2.0 (xv-2.00.tar, released
  2.     2-JAN-1992).       Port  was  mainly  done    by    David    Jones
  3.     (jonesd@kcgl1.eng.ohio-state.edu)  with some contributions by Rick
  4.     Dyson (Dyson@IowaSP.Physics.UIowa.EDU) using the VMS VAXC compiler
  5.     and DECWindow libraries.
  6.  
  7. Installation instructions are at the bottom of this file.
  8.  
  9. Command procedures:
  10.  
  11.     MAKE_XV.COM
  12.         This  command  procedure  is a "poor-person's" version of MMS.
  13.         PLEASE NOTE:  You should look through the command procedure to
  14.         see  if any customizing is necessary  before  executing  them!
  15.         If you have MMS you might want to use that method instead.
  16.  
  17.     MAKE_JPEG.COM
  18.         This procedure  is  called by MAKE_XV.COM to compile and build
  19.         the JPEG library.    This is not needed if you use MMS.  Check
  20.         the customizing sections for your system.
  21.  
  22.     SETUP.COM
  23.         A simple command procedure  to setup the final XV package.  It
  24.         an be executed by itself  or  used  with  many of the commonly
  25.         available SETUP packages.  If kept  in  the  same directory as
  26.         the binaries, it will be able to  get  the  necessary  symbols
  27.         setup anywhere the directory structure is located WITHOUT  the
  28.         need  to  edit  the command procedure.  Move them  all  around
  29.         together and you will be OK.
  30.  
  31. Make files:
  32.  
  33.     MAKEFILE.VMS (in the top level directory)
  34.         This is a MMS  description  file for the VMS MMS utility.  You
  35.         should  edit  the file first  to  make  sure  the  customizing
  36.         features  are  appropriate  for  your system.   To  produce  a
  37.         working  version  of XV and BGGEN just  type
  38.                       MMS /Description = MAKEFILE.VMS
  39.         at  the  DCL command prompt.  For users without MMS  you  will
  40.         need to use MAKE_XV.COM instead.
  41.  
  42.     MAKEFILE.VMS (in the JPEG sub-directory)
  43.         This is a MMS description file for the VMS  MMS  utility.  You
  44.         should  edit  the  file  first  to  make  sure the customizing
  45.         features are  appropriate  for  your  system.    To  produce a
  46.         working version of  the  JPEG  library  type  MMS  at  the DCL
  47.         command prompt.  For  users  without  MMS you will need to use
  48.         MAKE_JPEG.COM instead.
  49.  
  50. VMS specific source files:
  51.  
  52.     VMS.C     - Miscellaneous  routines   to  support  UNIX  functions
  53.                 missing from the  C  run-time  library.    Also define
  54.                 do_vms_wildcard() function used to  fixup the argument
  55.                 vector.
  56.  
  57.                 Private version  of qsort added, Kevin Oberman claimed
  58.                 the  VAXCRTL  qsort   bug  (well  known)  was  causing
  59.                 aberrant images.  There are also remnants of a aborted
  60.                 attempt at adding uncompress support.
  61.  
  62.     VMSREADDIR.C  - Substitute   routines  for  UNIX  directory  scan
  63.                 routines  (opendir),  perform  equivalent  VMS  system
  64.                 calls.
  65.  
  66.     DIRENT.H  - Include file  to  use  in conjunction with routines in
  67.                 VMSREADDIR.C.
  68.  
  69.     PSEUDO_ROOT.C -  Finds virtual root  window  for DECWindows window
  70.                 manager.
  71.  
  72.     GIFMAPF.C - VMS optimized GIF file  access routines, maps the file
  73.                 to virtual memory and treats it as an array.
  74.  
  75.     GIFDECOMP.MAR -  Optimized  GIF decompressor routines, written  in
  76.                 MACRO.
  77.  
  78.     ARGPROC.C  -  getredirection() routine  to  implement  the  piping
  79.                   and/or redirection of I/O.  Makes  VMS command lines
  80.                   work like the Unix lines.
  81.  
  82.     INCLUDES.H - Header file for ARGPROC.C code.
  83.  
  84.     DECOMPRESS.C - A decompression program  for  Unix-style  .Z  files
  85.                 which can be used by XV for automatic decompression of
  86.                 .Z files.  It can also  be  used  at  the DCL level to
  87.                 decompress files by hand.
  88.  
  89.     XVPDS.C   - Reader  of  PDS/VICAR  file  formats of the  NASA/AMES
  90.                 spacecraft images.
  91.  
  92.     PDS.H     - Header file for the XVPDS.C code.
  93.  
  94.     VDCOMP.C - A decompression progrma for Huffman encoded PDS files.
  95.                Called by XVPDS.C.
  96.  
  97. Documentation files:
  98.  
  99.     XV.HLP - A brief VMS Help file written from the man page.
  100.  
  101.     XV.TEX - A LaTeX formated version of the Unix man page.
  102.  
  103.     TROFFMAN.STY - A LaTeX style file for the LaTeX document.
  104.  
  105. Installation Instructions:
  106.  
  107.         Step 0:
  108.             You  need  to have installed the DECWindows programmer kit
  109.         with  the  C  language file selected.  You need a  C  compiler
  110.         compatible  with  the VAXC installed as well, including the .h
  111.         files in SYS$LIBRARY.
  112.  
  113.         Step 1:
  114.             The first step in getting  XV  (v2.00) running on your VMS
  115.         system is to get the Unix  source  files  on  your disk in the
  116.         structure intended by the Unix environment.   This  should  be
  117.         like the following:
  118.  
  119.             [XV-2_00]---+---[.BITMAPS]
  120.                         |
  121.                         +---[.DOCS]
  122.                         |
  123.                         +---[.JPEG]
  124.                         |
  125.                         +---[.UNSUPT]
  126.  
  127.             The original Unix compressed tar file can be obtained from
  128.         export.lcs.mit.edu (make sure you  get version 2.00!).  If you
  129.         don't have the tools to  decompress/detar  it, then Dave Jones
  130.         has made a VMS text library  of  the  source code available at
  131.         his ftp site, job.acs.ohio-state.edu.
  132.  
  133.         Step 2:
  134.             You are now  ready  to  build the code.  IF you DON'T have
  135.         MMS, go to Step 3.
  136.  
  137.             Since  you    have   MMS,  you  should  look  through  the
  138.         MAKEFILE.VMS file to  check for any customizing changes.  Note
  139.         specifically the references to  LZW  and  JPEG.   This is also
  140.         true for the MAKEFILE.VMS in the JPEG sub-directory.
  141.  
  142.             When you are satisfied that everything is correct for your
  143.         site, just type MMS and sit back and  watch  XV  being  built.
  144.         This  may  take  quite  a  while  depending  on  your   system
  145.         speed/load.    It may also require that your system have  it's
  146.         virtual memory increased.  If you get an error message of this
  147.         type, see a system guru for help!
  148.  
  149.         Step 3:
  150.             If  you  don't  have  MMS  you  will need to  execute  the
  151.         supplied  command  procedure  to  build  the  XV package.  You
  152.         should look  through  the  MAKE_XV.COM  file  to check for any
  153.         customizing changes.   Note specifically the references to LZW
  154.         and JPEG.  This is also true for the MAKE_JPEG.COM in the JPEG
  155.         sub-directory.
  156.  
  157.             When you are satisfied that your site changes are correct,
  158.         execute the MAKE_XV.COM and watch it  build  the  package.  If
  159.         there are any problems you will want to  delete  the offending
  160.         .OBJ file so the command procedure will try to  build it again
  161.         instead of skipping to the next one.
  162.  
  163.         Step 4:
  164.             If there were no errors,  you should be finished and would
  165.         just need to execute SETUP.COM to start viewing images!!!
  166.  
  167.