home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / f / pwtour.arc / PWDIR.DOC < prev    next >
Encoding:
Text File  |  1993-03-27  |  5.5 KB  |  162 lines
  1. DOCUMENTATION FOR PWDIR.ASM 
  2.  
  3. DESCRIPTION  
  4.  
  5. Internal modifications of PW.COM (Perfect Writer vs. 1.xx) which allow
  6. users to:
  7.  
  8. 1. Read the directory and space available on drive A or B while
  9. editing.  Command: ESC ?
  10.  
  11. 2. Switch disks in drive B while editing.  Command: CTRL-X S
  12. This allows, for example, inserting a file from one disk into a file
  13. on another disk, or saving a file on two different disks.
  14.  
  15. 3. Also, the disk system is automatically reset each time PW.COM is
  16. entered from CP/M, eliminating the need to type CTRL-C after changing
  17. disks.
  18.  
  19. LIMITATIONS
  20.  
  21. These modifications change PW's "HELP" function [ESC ?] to "READ
  22. DIRECTORY" and the "GO TO PERFECT SPELLER" function [CTRL-X S] to
  23. "RESET DISK SYSTEM."  If users wish to use Perfect Speller WHILE
  24. EDITING, these modifications must not be made because they destroy
  25. several of PW's Perfect Speller functions.  (Kaypro II owners who
  26. use Perfect Speller can have a modified PW.COM on their edit disk
  27. and keep an unmodified PW.COM on their Speller disk.)
  28.  
  29. As for the PW "HELP" function, it simply reads PW.HLP, a text file. 
  30. You can still read this file by using FIND FILE [CTRL-X CTRL-F] and
  31. entering A:PW.HLP.  If you never use the HELP file, you can erase it
  32. for the disk space.
  33.  
  34. INSTALLATION
  35.  
  36. STEP 1.  (PW vs. 1.20 users skip this step)
  37.  
  38. On the PW Installation disk there is a text file PW.SYM which lists
  39. the memory locations of all functions in your version of PW.  View
  40. PW.SYM on your screen, and find the locations of MHELP and MGOSPELL.
  41. Write these locations down (they are hex numbers such as "5E10").
  42.  
  43. STEP 2.
  44.  
  45. PIP copies of the following files onto a blank, formatted disk:
  46.     ASM.COM and DDT.COM from the CP/M disk
  47.     PW.COM and PW.SWP from the PW Edit disk
  48.     PWDIR.ASM from this disk
  49. Place this new disk in drive A and press the restart button.
  50.  
  51. STEP 3. (PW vs. 1.20 users skip this step)
  52.  
  53. Edit the file PWDIR.ASM by typing PW PWDIR.ASM <return>.  Find the
  54. following program lines:
  55.         MHELP   EQU    45F1H
  56.         MGOSPEL EQU    5EC9H
  57.  
  58. The hex numbers on the right tell the assembler where to put the
  59. modifications, and if your version of PW is not 1.20, change these
  60. numbers to the locations you wrote down in Step 1.  For example for
  61. version 1.03, change 45F1 to 4597 and change 5EC9 to 5E10.  (Always
  62. keep the H's which signify hex numbers.)
  63.  
  64. SAVE the corrected PWDIR.ASM [CTRL-X CTRL-S], and exit PW
  65. [CTRL-X CTRL-C].
  66.  
  67. STEP 4.
  68.  
  69. Type:    ASM PWDIR.AAZ <return>
  70.  
  71. The assembler changes the assembly code to hex code and creates
  72. PWDIR.HEX.  When you get a Warm Boot, type:
  73.  
  74.             DDT PW.COM <return>
  75.  
  76. The computer will display:
  77.  
  78.             DDT VER 2.2
  79.             NEXT  PC
  80.             8A00 0100    [vs. 1.20; note if different]
  81.             -
  82.  
  83. 0100 is the program starting address (all .COM files start at 100H), and
  84. 8A00 is PW's ending address (vs. 1.20).  If yours is not 8A00, write
  85. down the correct value for future reference.
  86.  
  87. At the hyphen type:    IPWDIR.HEX <return>
  88. Then:            R <return>
  89.  
  90. DDT overwrites PW.COM at the MHELP and MGOSPELL locations.  When the
  91. disk stops spinning, the computer will display:
  92.  
  93.             NEXT  PC
  94.             8A00 0000    [vs. 1.20]
  95.             -
  96.  
  97. Exit DDT by typing:     G0 <return>    [letter "G", number zero]
  98.  
  99. STEP 5.
  100.  
  101. After you get a Warm Boot, read the following paragraph and type:
  102.  
  103.             SAVE 137 PW.COM <return>
  104.  
  105. This causes CP/M to write 137 "blocks" of memory (starting with 0100H
  106. and ending with 8A00H) to disk, calling it PW.COM.  If your version
  107. was different than 8A00, consult the table below and substitute the
  108. correct number of blocks in place of the 137 in the above command.
  109.  
  110.             8700    -->    134
  111.             8800    -->    135
  112.             8900    -->    136
  113.             8A00    -->    137
  114.             8B00    -->    138
  115.                 Etc.
  116.  
  117. YOU ARE DONE!  The modifications are permanently imbedded in this new
  118. PW.COM.
  119.  
  120. Now test your handiwork.  Leave the modified PW disk in drive A, and
  121. put a document disk in Drive B.  Call up PW and a text file, or create
  122. a new text file (if you are not familiar with entering PW without the
  123. menu, see the method in Step 3, line 1).   Edit your file, SAVE it,
  124. hit ESC ? to look at the directory, clear the directory by the means
  125. indicated, put a different disk in drive B, reset the disk system
  126. [CTRL-X S], SAVE your document to the new disk, look at its directory,
  127. FIND a file from the new disk, edit and save it, read a directory
  128. again . . .
  129.  
  130. What fun!
  131.  
  132. Two words of caution: Don't try changing disks in drive A while
  133. running PW, because that's where the SWAP file is.  And be sure to
  134. reset the disk system [CTRL-X S] IMMEDIATELY after inserting any new
  135. disk in drive B while running PW.
  136.  
  137. Now copy this modified PW.COM onto your Edit disk.   All the other
  138. files you used are no longer needed, but you should keep a backup copy
  139. of the modified PW.COM.
  140.  
  141. BONUS! (For the forgetful)
  142.  
  143. What happens if you switch disks while in CP/M, forget to hit CTRL-C,
  144. and load Perfect Writer?  Now you are safe.  An automatic "reset disk
  145. system" instruction at the front of your modified PW.COM means you
  146. will never again need to hit CTRL-C before entering PW.COM from CP/M.   
  147.  
  148. Incidentally, the disk system also is automatically reset every time
  149. you use READ DIRECTORY [ESC ?].  If you switch disks in drive B while
  150. running PW, and forget to hit [CTRL-X S] (reset disk system), but
  151. happen to read the directory after the switch, you're still safe.
  152.  
  153. RELEASE
  154.  
  155. PWDIR.ASM and PWDIR.DOC are released to the Public Domain for
  156. unrestricted distribution. 
  157.  
  158.     Ron Friedrich, Garland, TX
  159.     Don Davis, Austin, TX
  160.  
  161.     January 1985
  162. em [CTRL-X S] IMMEDIATELY after inserting any new