home *** CD-ROM | disk | FTP | other *** search
/ vsiftp.vmssoftware.com / VSIPUBLIC@vsiftp.vmssoftware.com.tar / FREEWARE / FREEWARE40.ZIP / flistfrontend / freeware_demo.txt next >
Text File  |  1998-10-29  |  4KB  |  123 lines
  1. For this cdrom, Terry Kennedy provided me with a temporary account to build
  2. and test my maintenance changes to FLIST.  I built the set of executables
  3. in flist-axp.zip with DEC C 5.7 on an Alphastation running VMS 7.2 EFT2.
  4.  
  5. For other system configurations, to run FLIST, you'll need a C compiler
  6. (I've tested with VAX-C and DEC-C).  It's nice but not essential to have
  7. MMS (or its clone, MMK).
  8.  
  9. Documentation:
  10. -------------
  11.     This release contains two subdirectories, [.DOC] and [.SRC]. 
  12.     All documentation for FLIST and its associated BROWSE utility
  13.     are found in the [.DOC] subdirectory.  Precompiled versions of
  14.     the ".HLP" and ".MEM" files are included, though you may wish to
  15.     recompile these (since the underlining is omitted in my release
  16.     versions):
  17.  
  18.         $ SET DEFAULT [.DOC]
  19.         $ @BUILD CLOBBER
  20.         $ @BUILD
  21.  
  22. Building without MMS:
  23. --------------------
  24.  
  25.         If you simply want to build FLIST, run the script:
  26.  
  27.         $ SET DEFAULT [.SRC]
  28.                 $ @BUILD
  29.  
  30.         The build-scripts attempt to determine which of three
  31.         configurations you may have:
  32.  
  33.                 VMS with VAX-C
  34.                 VMS with DEC-C on a VAX
  35.                 VMS with DEC-C on an AXP (alpha)
  36.  
  37.     I've tested directly on the first and last configurations; my
  38.     information for the second (DEC-C + VAX) comes from user
  39.     feedback for other programs I've worked on.  You'll probably
  40.     have to adjust the librarian options (I'd appreciate feedback
  41.     for the next version).
  42.  
  43.     The release version uses the file NORMAL.OPT; I've also built a
  44.     shared version with SHARABLE.OPT (the main thing in either case
  45.     is that FLIST requires a lot of stack space).
  46.  
  47.         The result of the build is an executable, FLIST.EXE
  48.  
  49. Building with MMS:
  50. -----------------
  51.  
  52.         The source distribution includes DESCRIP.MMS, which is the MMS
  53.         script.  Run MMS in the source directory; it'll find this file
  54.         and compile/link FLIST.EXE, e.g.,
  55.  
  56.         $ SET DEFAULT [.SRC]
  57.                 $ MMS
  58.  
  59.     I've only used MMK installed as a foreign command; it doesn't
  60.     work well with the recursive macros set in DESCRIP.MMS, in the
  61.     "all" target.  In this case, I'll type a command such as
  62.  
  63.         $ SET DEFAULT [.SRC]
  64.         $ MMK [-.BIN]FLIST.EXE
  65.         $ MMK [-.BIN]BROWSE.EXE
  66.         $ MMK [-.BIN]HELPLIB.HLB
  67.  
  68.         The standard targets in the MMS script are: "all", "clean",
  69.         clobber".
  70.  
  71. Running the program:
  72. -------------------
  73.  
  74.     You don't have to install the program to run it.  FLIST can run
  75.     from the build directory.  You must define a foreign command to
  76.     run FLIST (otherwise it won't get command-line arguments).
  77.  
  78.     The top-level directory (which should include this file)
  79.     contains a script "SETUP.COM", which when run will define
  80.     foreign commands for the executables in [.BIN], e.g.,
  81.  
  82.                 $ @SETUP
  83.                 $ FLIST
  84.  
  85.     Most of FLIST's documentation is in the online help library
  86.     (generated into [.BIN]HELPLIB.HLB).  It assumes that you already
  87.     know something about the VMS command set and concentrates on the
  88.     additional functions and features that FLIST provides. The
  89.     help library is accessible from FLIST by typing a "?" followed
  90.     by a carriage return.
  91.  
  92. Installing:
  93. ----------
  94.         You can install the executable for FLIST in the directory where
  95.         you normally install user programs or tools.  Define (e.g., in
  96.         your LOGIN.COM) the foreign command to point to it, e.g.,
  97.  
  98.                 $ FLIST :== "$ SYS$LOGIN:FLIST.EXE"
  99.  
  100.         if you put it in your home directory (not tidy, but workable).
  101.     I normally define abbreviations for these programs, e.g.,
  102.  
  103.         $ FL*IST  :== "$ SYS$TOOLS:FLIST.EXE"
  104.         $ BR*OWSE :== "$ SYS$TOOLS:BROWSE.EXE"
  105.  
  106.     FLIST looks for its help-file in a location that depends upon
  107.     where its executable is located:
  108.     
  109.         If it is run from a system directory (e.g., SYS$SYSTEM),
  110.         it looks for SYS$HELP:HELPLIB.HLB
  111.         
  112.         Otherwise, it looks for the file HELPLIB.HLB in the
  113.         directory from which it is run (e.g.,
  114.         [.BIN]HELPLIB.HLB).
  115.  
  116.     (I wrote a vmsinstal script several years ago, but don't have it
  117.     available anymore -- if I get enough user feedback I'll make a
  118.     new one).
  119.  
  120. --
  121.  
  122. Thomas E. Dickey (dickey@clark.net)
  123.