home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / cpmug / cpmug078.ark / VOLUME78.DOC < prev    next >
Encoding:
Text File  |  1984-04-29  |  7.2 KB  |  221 lines
  1.         CPMUG volume 78, documentation.
  2.           01/24/82 Ward Christensen
  3.  
  4.     I created this file is an attempt to supply documentation
  5. for all files which do not have a separate .DOC file.
  6.     The following files have their own separate .DOC file:
  7.     DUU, EPROM, SDCOPY SWAPCOPY
  8.  
  9. ====>    /.ASM, /.COM, /DUP.COM
  10.  
  11.     John M. Kodis, author, says: The "slant" program reads a
  12. command line which may contain several program invocations.  A
  13. $$$.SUB file is built with these commands.  This file is then
  14. executed.
  15.  
  16. For example, the command line:
  17.  
  18. / asm copy; load copy; dir copy*.*; type copy.prn
  19.  
  20. will build a file containing commands to assemble and load the
  21. file named 'copy', search the directory for all copy programs,
  22. and type the COPY.PRN file.
  23.  
  24. ====>    BMAPORIG.ASM, BMAPORIG.COM
  25.     Lauren Guimont wrote this "bit map print" program for CP/M
  26. 2.2 because the ALLOC program (CPMUG vol 40 the latest) was
  27. hard-coded for CP/M 1.4.
  28. USAGE: BMAPORIG or BMAPORIG disk:
  29. EX: BMAPORIG B:
  30.  
  31. ====>    CRCK.COM
  32.     Keith Petersen's program is self documenting - just
  33. type CRCK with no operands.  It then says:
  34.  
  35. CRCK [drive:]<filename.filetype> [F]
  36.  
  37. Examples:
  38.  
  39.     CRCK MYFILE.ASM Check only MYFILE.ASM
  40.  
  41.     CRCK *.ASM    Check all .ASM files
  42.  
  43.     CRCK *.* F    Check all files and make file
  44.             of results <CRCKLIST.CRC>
  45.  
  46. ====>    D.COM
  47.     Self documenting via "D HELP":
  48.  
  49. fn, ft are specific, afn aft may be ambiguous (? and * allowed)
  50.  
  51. D SET        sets all filenames on disk into D.COM
  52. D        shows added/erased files since D SET was done
  53. D ADD fn.ft    adds a file to D.COM ("registers" it)
  54. D DEL afn.aft    deletes a file from D.COM ("unregisters" it)
  55. D CU        to Clean Up by selectively adding, erasing,
  56.         or deleting files.
  57. D afn,aft    5-up directory list (e.g. D *.* or D *.ASM)
  58.         (avoid fn of SET, ADD, DEL, CU)
  59.  
  60. ====>    DUH.COM, DUH.Z80
  61.     Bill Norris put some documentation in the front of
  62. the .Z80 file.  NOTE this is not DU itself, but rather a
  63. relocater for DU.  It appears you would have to assemble
  64. DU twice, once for each address.  DUH then is a program
  65. to compare the two .COM versions of DU, and make one
  66. relocatable version of them.
  67.  
  68. ====>    FMAP.COM
  69.     Self documenting via "FMAP H":
  70. FMAP by Ward C. Help:    FMAP fn.ft [option][.suboption]
  71. fn.ft: ? and * allowed.
  72.  
  73. Opt    Console out?    To disk as:    Usage:
  74. ---    --------    --------------    --------
  75.  /    Y (across)
  76.  B    Y + bit map
  77.  D    Y        $1 $2fn.ft $3    for SUBMIT
  78.  F    Y        fn.ft        UCAT input
  79.  K            fn.ft nnK
  80.  L    Y + seq# + #K
  81.  M    N        $1 $2 $3fn.ft    SUBMIT MODEM
  82.  Q    N        fn.ft
  83.  P    N        $1 $2fn.ft$3    SUBMIT PIP
  84.  Unnn            Users group catalog nnn to -CATALOG.nnn
  85. Suboptions: .S selects names as listed; .P output to printer;
  86.     .Unn selects only user nn
  87.  
  88.     Some examples might make things clearer:
  89.  
  90. B>fmap *.asm
  91. FMAP V2.3 - 12/07/81  FMAP H for help
  92. FILENAME TYP EX  RC  #K EXTENTS...
  93. /        ASM 00 001F 04 12-15
  94. BMAPORIG ASM 00 004E 10 02-0B
  95. DUU      ASM 00 0080 16 32-41
  96. DUU      ASM 01 0080 16 42,79-83,88-8B
  97. DUU      ASM 02 0080 16 8D-9C
  98. DUU      ASM 03 0014 03 9D-9F
  99. EPROM    ASM 00 003D 08 43-4A
  100. LPRINT   ASM 00 000D 02 0C-0D
  101. MAKE     ASM 00 005E 12 C0-CB
  102. NOTATE   ASM 00 0017 03 4D-4F
  103. PATCH    ASM 00 0017 03 CC-CE
  104. SWAPCOPY ASM 00 0070 14 66-73
  105. XREFPRN  ASM 00 0080 16 1B-2A
  106. XREFPRN  ASM 01 0035 07 2B-31
  107.   14 FILES, 130 K
  108.  
  109. EX is the extent number
  110. RC is the hex record (sector) count.  Someone asked if this
  111.     is different for double density.  No.  This is the
  112.     "logical" sector count, i.e. in 128-byte "chunks".
  113. #K is the decimal number of K in the extent.  This properly
  114.     reflects single/double density, i.e. single density
  115.     typically allocates in 1K blocks, double in 2K or more.
  116.     (Note the #K is still not right for files on a hard
  117.     disk which are allocated with 4K or larger groups,
  118.     technically, with "EXM>0" in the BIOS)
  119. EXTENTS is the physical location, in hex, of the file on disk.
  120.     Contiguous blocks are shown as nn-mm;
  121.  
  122. Further info on extents: a file is allocated in blocks of 1K,
  123. 2K, etc, on disk, depending upon the density.  The directory
  124. starts in block 0, and usually occupies blocks 0 and 1.  The
  125. first file placed on an empty disk starts in block 2.  Each
  126. directory entry keeps track of 16 blocks;  in double density,
  127. each keeps track of 8 blocks, because each block is 2K.  Other
  128. options may be applied to larger disks, such as having one
  129. directory entry keep track of 32K.
  130.  
  131. ====>    IF.COM
  132.     Allows you to conditionally abort or continue a SUBMIT,
  133. depending upon whether a file exists or not.
  134.  
  135. Examples:
  136.  
  137. if foo.zot continue    ;continues submit if foo.zot exists
  138. if foo.zot abort    ;aborts submit if foo.zot exists
  139.  
  140. ====>    LPRINT.ASM
  141.     P.P.H. Lee, in the .ASM file, says:
  142. TO EXECUTE TYPE:
  143. LPRINT ON     - EQUIVALENT TO STAT LST:=LPT:
  144. LPRINT OFF    - EQUIVALENT TO STAT LST:=TTY:
  145.  
  146. ====>    MAKE.ASM
  147.     Its author, Terry Lewis, writes: Changes directory user
  148. number, making program available to different user without
  149. rewriting program on disk.  Changes only the user number.
  150.  
  151. COMMAND:
  152.     MAKE PIP.COM 5<cr>   or
  153.     MAKE *.ASM 3<cr>     or
  154.     MAKE ST?T.C?L 4<cr>  or
  155.  
  156.          (any ambiguous or)   ( Desired   )
  157.     MAKE (unambiguous CPM )   (USER number) 
  158.          ( filename.typ   )   ( 0 to 15   )
  159.  
  160. RESULT:
  161. The files specified will be changed from their current user
  162. number to the user number specified as the second command
  163. variable.  They will no longer exist under the old user number
  164. but will show up under the new user number.
  165.  
  166. ====>    NOTATE.ASM, NOTATE.COM
  167.     This program was originally distributed on volume 29, but
  168. somehow had many memory "hits" in it.  Martin E. Nason fixed up
  169. those hits so it would re-assemble.
  170.     The program is used to add comments to .ASM files which
  171. have "sparse" comments.  It types the file, and on any line
  172. which does not have a comment, prints the line, a tab, a
  173. semicolon, then awaits input.  If you press return, the line is
  174. left, without the "tab;".  Anything you type will be added to
  175. the line.
  176.  
  177. ====>    PATCH.ASM
  178.     Adequate documentation to implement it is contained in the
  179. .ASM file.
  180.  
  181. ====>    REPEAT.COM
  182.     Repeat a .SUB file "nn" times.  Used in two "phases":
  183. (1) type "REPEAT nn" to set things up (just stores a count
  184.     at 8.
  185. (2) Place "REPEAT" in your .SUB file immediately before a
  186.     line re-submitting the original file.
  187. EX:
  188.  
  189. First, type
  190.  
  191.     REPEAT 5
  192.  
  193. Then have your submit file be:
  194.     blah
  195.     blah
  196.     blah
  197.     repeat
  198.     submit foo
  199.  
  200. When repeat executes with no operands, it decrements the
  201. count at 8, and if 0, erases $$$.SUB.
  202.  
  203. ====>    TESTPROT.BAS, UN.COM
  204.     Author Bill Norris says: UN.COM is used to recover
  205. protected MBASIC programs. TESTPROT.BAS is a simple demo
  206. program which has been written in MBASIC and has been
  207. protected.  (No real reason for including it though... Also, if
  208. you compile it, the program will run a LOT slower.)
  209.     Unprotects protected programs.  No other documentation
  210. exists other than that which is part of the .COM file.  The
  211. .COM file acts as both a normal executable program, and as the
  212. documentation. ( It may be sent to the console via 'A>TYPE
  213. UN.COM'.  Also, part of the above documentation will go to the
  214. console if the user types 'UN HELP'.)
  215.  
  216. ====>    XREFPRN.ASM, XREFPRN.COM
  217.     P.P.H. Lee modified CPMUG XREF from volume 8 (or 36?)
  218. to work with PRN files.
  219.     Usage: XREFPRN name.PRN
  220.     Goes directly to the CP/M LIST device.
  221.