home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / programs / wstar / wsdocon.doc < prev    next >
Encoding:
Text File  |  1994-07-13  |  3.3 KB  |  81 lines
  1.       WordStar Non-Document to Document Conversion Program
  2.  
  3.                       Dr. William C. Parke
  4.  
  5.  
  6. Micropro's  WordStar word processor creates and handles two kinds 
  7. of files.   A "document" file uses high-bit flags to signal  word 
  8. boundaries,  "soft"  spaces and "soft"  carriage  returns.  These 
  9. flags let WordStar properly justify and format the file.  A "non-
  10. document"  file uses no formatting or justification flags.   This 
  11. type of file is created to edit data or program source code,  for 
  12. which text formatting is not required.
  13.  
  14. A  "document"  file can easily be converted to  a  "non-document" 
  15. file  by simply using the CP/M utility PIP to copy the file  with 
  16. the "Z" switch set.  For example,
  17.  
  18.      >PIP DESTIN.DOC=SOURCE.DOC [Z]
  19.  
  20. will create a file DESTIN.DOC from the file SOURCE.DOC which  has 
  21. all  high-bits of each character (also called the parity bit) set 
  22. to zero.   This conversion may be necessary if you intend to edit 
  23. the file with another word processor besides WordStar.
  24.  
  25. There are occasions when you may wish to convert a "non-document" 
  26. file to a "document" file.  For example,  the "non-doc" file  may 
  27. have  been created on some other word processor,  or it may  have 
  28. been  a WordStar "doc" file transferred via modem with the parity 
  29. bit masked off.   This type of conversion is a less trivial task.  
  30. Micropro   suggests  that  you  enter  the  file  as  a  WordStar 
  31. "document" file,  delete all unwanted spaces and carriage returns 
  32. and reformat each paragraph.  This is a laborious procedure.
  33.  
  34. The program WSDOCON was written to relieve this labor.   It  will 
  35. do the following:
  36.  
  37. 1) Establish word boundary flags.
  38.  
  39. 2) Make all extra spaces between words "soft" spaces.
  40.  
  41. 3) Set all carriage returns within a paragraph to "soft" carriage 
  42. returns.  Paragraph boundaries are recognized by the existence of 
  43. blank  lines  (more than one carriage return-line  feed).   These 
  44. boundaries are not made "soft".
  45.  
  46. 4) Convert tab characters ( hex 09 ) into spaces,  at the  option 
  47. of the user.
  48.  
  49. The command format is:
  50.  
  51.      >WSDOCON SOURCE.DOC DESTIN.DOC
  52.  
  53. or   
  54.      >WSDOCON SOURCE.DOC
  55.  
  56. The  second  form  will  write the converted  file  back  to  the 
  57. original file.
  58.  
  59. WordStar  does  not  use tab characters (CTL-I's) in  its  files.  
  60. Instead,  the tab key is converted to the (user settable)  number 
  61. of  spaces.  However,  other word processors,  such as  PIE  from 
  62. Software Toolworks, use tabs in the file to preserve space.
  63.  
  64. WSDOCON will convert each tab encountered into a single space, in 
  65. anticipation of a reformating within WordStar.  If there are tabs 
  66. in  the your file which establish fixed columns,  you may wish to 
  67. preserve  these tabs in the conversion.   This can be done  using 
  68. the "/T" switch in the form:
  69.      
  70.      >WSDOCON SOURCE.DOC DESTIN.DOC /T
  71.  
  72. A  second  switch  ("/N") is available for the  conversion  of  a 
  73. "document" file to a "non-document" file.  You may find this type 
  74. of conversion more convenient using WSDOCON than using PIP, since 
  75. you need not create a new file in the process:
  76.  
  77.      >WSDOCON SOURCE.DOC /N
  78.  
  79. After  using  WSDOCON to create a "document" file,  you  can  use 
  80. WordStar to reformat paragraphs to you liking.
  81.