home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / f / lstool11.lbr / LSTOOL11.DZC / LSTOOL11.DOC
Encoding:
Text File  |  1993-10-26  |  4.4 KB  |  97 lines
  1.             ====  Documentation for LST-TOOL.COM  ====
  2.  
  3.                            VERSION 1.1
  4.  
  5.                  Copyright (C) 1985 by UCS, inc.
  6.                        ALL RIGHTS RESERVED
  7.  
  8.             A Utility Program for Use With .LST Files
  9.              as produced by MCAT/XCAT or LCAT/XLCAT
  10.  
  11.                            - NOTICE -
  12.  
  13.      LST-TOOL is released with LIMITED USE END-USER RIGHTS.   You
  14. are encouraged to use this software in any  NON-COMMERCIAL,  NON-
  15. GOVERNMENTAL  environment.   You  may  distribute  this  software
  16. freely,  so long as no monetary transaction takes place, and this
  17. documentation  file accompanies it.   This software is  protected
  18. under United States Copyright Law and International Treaty.   Any
  19. violation of the UCS, inc. copyright will be prosecuted.
  20.  
  21.  
  22.                         - Introduction -
  23.  
  24.      LST-TOOL  is  a  utility  program  designed  to  extend  the
  25. usefulness of the MCAT/XCAT or LCAT/XLCAT Disk Cataloging System.
  26. LST-TOOL  can  read  the .LST files produced  by  XCAT/XLCAT  and
  27. report useful information on them back to you.
  28.  
  29.      LST-TOOL is distributed with a terminal installation routine
  30. that  will  adapt it to most Z-80 based  computers.  The  install
  31. procedure  is menu-driven,  and,  once LST-TOOL is installed  for
  32. your  terminal,  the installation files may be deleted from  your
  33. working disk. Only LST-TOOL.COM is necessary.
  34.  
  35.                          - Background -
  36.  
  37.      LST-TOOL was originally written to meet my immediate  needs.
  38. I  had many different sets of MAST.CAT,  MAST.LST,  MASTL.CAT and
  39. MASTL.LST files,  for different sets of disks.  I needed a way to
  40. compare  the files,  and list the names that showed on the  Input
  41. file  that  DID NOT show on the Master file.  I then  decided  it
  42. would  be useful to be able to scan the .LST files and  determine
  43. which  filenames were listed on more than one  disk.  Finally,  I
  44. determined that it would be desirable to be able to REName  files
  45. if necessary (More than one .LST file...).
  46.  
  47.      In  addition to these functions,  LST-TOOL needed to be able
  48. to  read  the disk directory (to remind you what  files  you  are
  49. working  on...) and a way to rapidly read the disk files  created
  50. by LST-TOOL (or other ASCII files for that matter...).
  51.  
  52.                           - Features -
  53.  
  54.      LST-TOOL  will compare two .LST files (NOT THE SAME NAME!!!)
  55. and prepare a file called LIST.DIF showing those entries that are
  56. on  the Input List that were not on the Master  List.  Both,  the
  57. Master List and the Input List MUST be in sorted order.  XCAT.COM
  58. and  XLCAT.COM  will take care of that,  but  results  cannot  be
  59. guaranteed for other applications.
  60.  
  61.      LST-TOOL  will  read a .LST file and prepare a file  showing
  62. all  Filenames  that  appear on  multiple  disks.  These  may  be
  63. (usually...)  deleted  to increase available storage  space.  The
  64. list  will  be saved as DUPES.LST and may be viewed  from  within
  65. LST-TOOL.
  66.  
  67.      Because  LST-TOOL  allows you to use  multiple  ????????.LST
  68. files, LST-TOOL also allows you to rename them, if necessary.
  69.  
  70.      Finally,  LST-TOOL has options for displaying the  directory
  71. of  the working disk and viewing an ASCII file on the screen  (20
  72. lines at a time).
  73.  
  74.                      - Update Information -
  75.  
  76.      LST-TOOL  version 1.1 utilizes a technique to  automatically
  77. determine available memory at run-time.  It adjusts the stack and
  78. heap  pointers  to fit within any size TPA.   The  technique  was
  79. developed by James R.  Shiflett of Stafford,  Texas, and is fully
  80. described  in the August-September,  1985,   (number 25) issue of
  81. Micro Cornucopia magazine
  82.  
  83.                            - Future? -
  84.  
  85.      Heck if I know...  Like I mentioned above,  LST-TOOL grew up
  86. out of my own personal requirements.  This is not the best way to
  87. develop  useful software (but it is typical of  PD  software...).
  88. The  author  lives in a little sterile environment and cannot  be
  89. expected to anticipate all potential uses, or desirable features.
  90. This is where YOU come in.  How do you use the .CAT & .LST files?
  91. What  additional features do you think might be  desirable?  Why?
  92. Let me know what you think at my RCP/M,  The Lost Dutchman's Gold
  93. Mine (602)848-6708, 24 Hours. I support 300, 1200 & 2400 Baud.
  94.  
  95. James A. Gronek
  96. 08/26/1985
  97.