home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / sigm / vols000 / vol052 / abstract.052 < prev    next >
Text File  |  1984-04-29  |  4KB  |  106 lines
  1.     Documentation for CATALIST.BAS, SCATPAD.BAS and UN.COM
  2.  
  3. CATALIST.BAS -  Is used to produce a listing of the contents of
  4.     the latest CPMUG and SIG/M volumes.  It reads in SCATS,
  5.     which is a modified version of MAST.CAT ( MAST.CAT is
  6.     produced by FMAP.COM  and UCAT.COM).  The modifications
  7.     were:
  8.     1>  Exclusion filenames (those between parentheses)
  9.         were deleted - parentheses too.
  10.     2>  Volume filenames were deleted.  It's just redundant
  11.         information, since -CATALOG.xxx or -SIGMLOG.xxx
  12.         are assumed to exist (or there would be no files
  13.         of the form 'filename.ext, ????LOG.xxx'.
  14.     3>  A working copy was made using PIP.COM using the [z]
  15.         option, since some programs were inadvertantly
  16.         distributed with CP/M file attributes which set
  17.         some bits in the filenames that prevent them from
  18.         being properly sorted.
  19.     4>  It was then sorted in ascending sequence on all
  20.         fields in the following order:  1, 2, 4, 3.
  21.  
  22.     If CATALIST.BAS/COM is run, the listing file will be
  23.     saved on disk and may be printed when convenient.  If
  24.     you want a listing in your own SCATalogical order, it
  25.     will be necessary to sort SCAT.  Since a good number of
  26.     those wishing to do so will have a sort program which
  27.     handles only fixed length records, a request was made
  28.     that a simple program be included which will modify
  29.     SCAT for use by those sort programs. This program is
  30.     known as...
  31.  
  32. SCATPAD.BAS - A quick and dirty program (minimal error checks)
  33.     which will modify a file in one of two ways.
  34.  
  35.     1>  Make all records fixed length by padding spaces
  36.         onto the end of each line. (This extends the size
  37.         of the last field only).
  38.     2>  Make all fields fixed length by padding them with
  39.         spaces.  Note that while the input file seperated
  40.         the fields with commas, the output will not have
  41.         any if you so specify. Just make sure that they are
  42.         inserted before using CATALIST.  If field lengths
  43.         are stated to be larger the the max. possible, then
  44.         the files could look as follows:
  45.  
  46.  
  47.     SCAT                    OUTPUT
  48.  
  49.     /,DOC,CATALOG,040        |   /        DOC CATALOG  040
  50.     15/PUZ,ASC,CATALOG,013   |   15/PUZ   ASC CATALOG  013
  51.     1500,ASC,CATALOG,013     |   1500     ASC CATALOG  013
  52.     1CHECK,BAS,CATALOG,054   |   1CHECK   BAS CATALOG  054
  53.  
  54.         If the field lengths are stated as being the true
  55.         maximum, then the result will look like this:
  56.  
  57.     SCAT                    OUTPUT
  58.  
  59.     21,ASC,CATALOG,005    |    21      ASCCATALOG005
  60.     21BIOS,ASM,SIGMLOG,017    |    21BIOS  ASMSIGMLOG017
  61.     21BIOS,ASM,CATALOG,069    |    21BIOS  ASMCATALOG069
  62.     21BIOS,DOC,SIGMLOG,017    |    21BIOS  DOCSIGMLOG017
  63.  
  64.         If commas were specified with field lengths of
  65.         8, 3, 7, and 3 bytes, the result will appear as:
  66.  
  67.     21BIOS,DOC,SIGMLOG,017   |   21BIOS  ,DOC,SIGMLOG,017
  68.     21BIOS,DOC,CATALOG,069   |   21BIOS  ,DOC,CATALOG,069
  69.     21BOOT,ASM,SIGMLOG,017   |   21BOOT  ,ASM,SIGMLOG,017
  70.     21BOOT,ASM,CATALOG,069   |   21BOOT  ,ASM,CATALOG,069
  71.  
  72.  
  73.     If you would like to know where to obtain information
  74.     on how to use Ward Christenson's catalog programs, just
  75.     use them like so...
  76.     Type 'CAT CAT??.*' or 'CAT FMAP??.*' and watch the tube.
  77.  
  78. UN.COM  -   An updated version of the one submitted to the CPMUG
  79.         several months ago.  Use it to recover your Basic-80
  80.        programs which were saved with the 'P'rotect option.
  81.        It is self documenting if you can figure out how, and
  82.        running it can be a real 'Adventure'.  This version
  83.        works with all version 5.xx MBASICS up to 5.21, but
  84.        unfortunately, not with Heath's CP/M.
  85.  
  86.  
  87. ***** Notes *****
  88.         CATALIST was timed using 8" drives, double
  89.         density, single sided.  The source file, SCAT
  90.         was kept in drive A:, and the output file was
  91.         always written to a empty disk in drive B:. The
  92.         interpreter took 12 minutes to finish, while the
  93.         compiled program made it in 2:50.  However...
  94.         the demo program supplied for UN.COM (TestProt.BAS)
  95.         runs much slower when compiled.
  96.         This will be a do-it-yourself disk for all of
  97.         you that want the listing that CATALIST.BAS
  98.         produces.  In a previous life, this disk was known
  99.         as SIGM Volume 12.  Unlike #12, this disk has no
  100.         room for the listing, but by the time you read this
  101.         it should be available as part of the NYACC Catalog
  102.         of Public Domain Software (Book #2).
  103.  
  104.         bye,           - b.n. -          12/13/81
  105.  
  106.