home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / PROGRAMS / WSTAR / WSLOAD.LBR / WSLOAD.DQC / WSLOAD.DOC
Text File  |  2000-06-30  |  10KB  |  195 lines
  1. WSLOAD - A WordStar Utility
  2.  
  3. WordStar is a trademark of MicroPro International
  4.  
  5. Lindsay Haisley
  6. 14206 Spreading Oaks
  7. Leander, TX  78641
  8.  
  9.                    >>>>>>>>>  C A U T I O N  <<<<<<<<<<
  10.  
  11. DO  NOT  RUN  WSLOAD  ON  YOUR  ONLY  COPY  OF WORDSTAR.  BE SURE TO MAKE A 
  12. CONVENIENT BACKUP OF SAME BEFORE ATTEMPTING  ANY  MODIFICATIONS  WITH  THIS 
  13. SOFTWARE.
  14.  
  15.  
  16. **** DESCRIPTION:
  17. -----------------
  18.  
  19. WordStar, as you are probably aware, may be custom  taylored  to  fit  just 
  20. about  any  necessary application.  Different printers, different terminals 
  21. and different initial user options are all  supported  using  the  WINSTALL 
  22. program,  supplied  by MicroPro, to make the necessary changes to WordStar.  
  23. The "configuration data" which defines thise options  to  WordStar  becomes 
  24. semi-permanently  imbedded  in WordStar and can normally only be changed by 
  25. again using the WINSTALL program.
  26.  
  27. WSLOAD  is  a  patch  to WordStar vs. 3.3 (implemented through the standard 
  28. user  patch  area  INISUB  routine)  which  enables  WordStar   to   accept 
  29. configuration data from an overlay file thus saving the necessity of having 
  30. a different complete WordStar copy for each printer or type of work.   This 
  31. is especially useful for folks who keep several different configurations of 
  32. WordStar on a hard disk  system,  each  version  occupying  20K  of  space.  
  33. Configuration overlay files occupy only 2K to 4K (depending on your system) 
  34. of disk space and can be loaded either automatically  or  by  command  line 
  35. option.  Once WSLOAD is installed, it has no user interface beyond the CP/M 
  36. command line and is effectively invisible.
  37.  
  38.  
  39.  
  40. **** INSTALLATION:
  41. ------------------
  42.  
  43. To create a version of WordStar which will accept  configuration  overlays, 
  44. make  your current generic copy of WordStar available in the same user area 
  45. on your disk system.  Enter WLOAD and respond to the following prompts:
  46.  
  47.  
  48. Enter the filename of your version of WordStar => 
  49.     
  50.     Give the complete filename of your current version  of  WordStar  along 
  51.     with a disk prefix, if appropriate.
  52.     
  53.     
  54. Enter the name you want for WordStar with WSLOAD installed => 
  55.  
  56.     You  may  give  a  different  name  here, or use the same name given in 
  57.     response to the previous question.  A  Carriage  Return  with  no  name 
  58.     entered  will reuse the name previously given.  Although this will save 
  59.     disk space, no backup  will  be  made  and  your  original  version  of 
  60.     WordStar will be overwritten.
  61.     
  62.     
  63. Enter the default configuration filename =>
  64.  
  65.     This  is  the  name of the overlay file which will be loaded if none is 
  66.     specified on the WordStar command line.  This is a  useful  feature  if 
  67.     you  do several different kinds of editing in different user areas on a 
  68.     hard disk.  Put a configuration overlay in  each  user  area  with  the 
  69.     settings you need for the kind of work done there and it will be loaded 
  70.     automatically each time WordStar is invoked in that user  area.   Thus, 
  71.     if  you do assembly language in one user area, C programming in another 
  72.     and word processing in yet another, a default  config.  file  could  be 
  73.     placed  in  each  user area to optimize WordStar for each kind of work.  
  74.  
  75.     If you have a floppy disk system and use  a  single  A  drive  WordStar 
  76.     command  file  disk to edit different kinds of files on a disk in the B 
  77.     drive, you may specify a disk when giving the default config.  filename 
  78.     (e.g. B:WS.DTA) and include an appropriate default config. file on each 
  79.     B drive work disk.
  80.     
  81.     If WordStar with WSLOAD installed can't find the default  configuration 
  82.     overaly,  it  will  simply  run  as  is  with the configuration of your 
  83.     original WordStar intact.  
  84.     
  85.     If  no  filename  is  entered  in response to this question, no default 
  86.     config. overlay will be loaded when WordStar is invoked.
  87.     
  88.  
  89. Enter the character you want to preceed overlay filenames =>
  90.  
  91.     WordStar with WSLOAD looks at the first character of a  filename  given 
  92.     on  the  WordStar  command  line  and  determines  whether  or  not the 
  93.     specified file is an overlay.  This character is a '+' by default.   If 
  94.     you  plan  to  edit  files  starting  with  this  character, or if your 
  95.     operating system uses this character on a command  line  for  something 
  96.     else, then specify another character.
  97.  
  98.     The  filename  of  the default configuration overlay neen not be tagged 
  99.     with this character, although you may want to do  so  to  maintain  the 
  100.     consistency of your config. overlay names.  
  101.  
  102.  
  103. **** CREATING OVERLAYS:
  104. -----------------------
  105.  
  106. Configuration overlays are created from  configured  versions  of  WordStar 
  107. which  may be erased once the configuration data is extracted.  After using 
  108. WINSTALL and setting all options as desired, load and run WordStar and exit 
  109. immediately  using  the  'X' option on the main menu.  Then, before running 
  110. any other program, enter:
  111.  
  112.     SAVE 8 +WSFOO.DTA   (or whatever you want to call your overlay)
  113.  
  114. The  resulting  file,  +WSFOO.DTA  is  the  configuration  overlay  for the 
  115. WordStar just run.  
  116.  
  117.  
  118. **** USAGE:
  119. -----------
  120.  
  121. To use WordStar with WSLOAD installed,  simply  include  the  name  of  the 
  122. desired  overllay  on the command line when WordStar is invoked.  It may be 
  123. either the first or second argument following  the  WordStar  command  file 
  124. name,  the  other  argument  being  the  file,  if any, which WordStar will 
  125. attempt to load and present for editing.  For  example,  all  four  of  the 
  126. following are acceptable:
  127.  
  128. WS +WSFOO.DTA            (Enters command mode, +WSFOO.DTA overlay loaded) 
  129. WS LOVE.LET +WSFOO.DTA   (Edits LOVE.LET, +WSFOO.DTA overlay loaded)
  130. WS +WSFOO.DTA LOVE.LET   (Same as previous)
  131. WS LOVE.LET              (Edits LOVE.LET, default ovly loaded if found)
  132. WS                       (Enters command mode, default ovly loaded if found)
  133.  
  134. If WordStar  can't  find  the  specified  overlay,  or  if  no  overlay  is 
  135. specified,  it  will  attempt to load the default overlay.  If this overlay 
  136. can't be found, your generic version of WordStar will run with  no  overlay 
  137. loaded.
  138.  
  139.  
  140. **** ERRORS:
  141. ------------
  142.  
  143. WSLOAD  will  abort if it can't find the WordStar command file.  Check your 
  144. directory to make sure the filename is spelled correctly and that you  have 
  145. specified  the  proper  disk for the file.  A full disk or a full directory 
  146. will also terminate the program.
  147.  
  148. WSLOAD places the code for config. overlay  loading  immediately  following 
  149. the  end  of  the WordStar code itself.  This area is later occupied by the 
  150. standard WordStar overlays WSMSGS.OVR and WSOLVY1.OVR, and so is  available 
  151. only  for  initialization  routines  which  can  be erased once WordStar is 
  152. running.  WSLOAD checks to see if an initialization routine is  already  in 
  153. place in this portion of memory and if so, it will report a "MORPAT error".  
  154. This will be the case if you try to run WSLOAD on a WordStar copy which has 
  155. already  been  WSLOADed.  Copies of WordStar which have initialization code 
  156. in this area of memory  already  cannot  use  WSLOAD  without  reassembling 
  157. WSLOAD.AZM with the offset variable set to a higher location.
  158.  
  159. The  WSLOAD  installation  envelope checks to see if the INISUB jump in the 
  160. user patch area is to an address  beyond  the  end  of  WordStar  (or  more 
  161. accurately, beyond the current value of the OFFSET variable in WSLOAD.AZM).  
  162. It is possible to have an initialization routine that jumps from within the 
  163. MORPAT  patch  area  itself to an area beyond the end of WordStar.  This is 
  164. kludgey programming, but I am sure it is occasionally done.   If  this  has 
  165. been  done to your WordStar then the WSLOAD envelope will not flag a MORPAT 
  166. error and will bash  your  current  initialization  routine.   In  layman's 
  167. terms,  this means BE SURE TO MAKE A BACKUP COPY OF WORDSTAR BEFORE RUNNING 
  168. WSLOAD ON IT!  If the  resulting  WordStar  copy  works  oddly  or  doesn't 
  169. configure  your  keys,  or won't use the screen properly, you have probably 
  170. destroyed an init. routine and you must  do  some  work  on  your  WordStar 
  171. itself  before  you  can  use  WSLOAD.  The details of this repair work are 
  172. beyond the scope of this DOC, however the locations of  MORPAT  and  INISUB 
  173. within WordStar vs. 3.3  are given in equates within WSLOAD.AZM.
  174.  
  175. If you get a MORPAT error and still wish to use WSLOAD, you may  reassemble 
  176. WSLOAD  with  the  OFFSET  variable set to an area of available free memory 
  177. above existing initialization routines.  Make sure that at least 200  bytes 
  178. of  free  memory  are  available.   Tack  on  an  extra page to WordStar if 
  179. necessary.  WSLOAD will assemble with either Microsoft's M80  or  with  the 
  180. public domain assmebler Z80MR.
  181.  
  182.                  +++++++++++++++++++++++++++++++++++++++
  183.  
  184. If you have problems or questions regarding this program, I will be glad to 
  185. help  if  I  can.   Please  send  a  SAS  disk  and/or  envelope  with your 
  186. correspondance.
  187.  
  188. I would like to thank Ted Silveira of Santa Cruz, CA for his  documentation 
  189. of user patch points in WordStar, without which the writing of WSLOAD would 
  190. have been a pain in the ass.
  191.  
  192. I would also like to thank MicroPro International for WordStar,  which  may 
  193. not  be  the  fanciest  CP/M  word  processor  around, but it is surely the 
  194. smoothest and most trouble free of all the word processors and text editors 
  195. I use.