home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT006.ZIP / WSASCII.DOC < prev   
Text File  |  1985-04-21  |  3KB  |  86 lines
  1.  
  2.                 WSASCII -- WordStar <-> ASCII Converter
  3.                  Portions Copyright 1985 by Brian Raub
  4.  
  5. WSASCII converts WordStar files to ASCII, and vice versa. Several
  6. special options allow (and help) you to customize the conversion.
  7.  
  8. OPTION                ACTION
  9. ===================== ==================================================
  10.  
  11. Strip Dot Commands    Removes all lines which start with a period, such
  12. (WS->ASCII Only)      as .PA or comment lines starting with ..
  13.  
  14. Expand Tabs           Expands tabs to 5 spaces.
  15. (WS->ASCII Only)
  16.  
  17. Strip leading spaces  Removes specified number of leading spaces. Useful
  18. (ASCII->WS Only)      for converting a user's manual (with a standard #
  19.                       of leading spaces on each line) to WS format.
  20.  
  21. Compress spaces       Compresses multiple spaces between words to single
  22. (ASCII->WS Only)      space. Used to 'unjustify' text, but can cause
  23.                       trouble if used on tabular material (see ..HARDEN)
  24.  
  25. There are two features on the menu to help review a file before you
  26. convert it.
  27.  
  28. <D>irectory lists the files on the default drive, or at another location
  29. you specify. You may use wildcards.
  30.  
  31. <V>iew lets you review the contents of an ASCII file, so that you can,
  32. for example, decide how many leading spaces to delete. You may use the
  33. <V>iew command on WS files, but the visual display will be garbled and
  34. incomplete. The <V>iew command displays 23 lines of text at a time, or
  35. fewer if the lines are longer than 80 characters each. <V>iew includes
  36. an 'indent character counter' at the bottom of each screen of text.
  37.  
  38. While your file is processed, WSASCII displays a running count of lines
  39. and characters processed -- from both source and destination files. The
  40. unequal counts reflect the effects of your chosen options.
  41.  
  42. ..HARDEN -- if placed in a ASCII file before conversion, will force hard
  43. carriage returns until ..SOFTEN is encountered. These two commands will
  44. help you to maintain hard line endings for tables, or other places you
  45. need to maintain the hard carriage return format.
  46.  
  47. In every file that is converted from ASCII->WS, there will be several
  48. added lines at the top which explain how to reform the file.
  49.  
  50. Here's how WSASCII works:
  51.  
  52. ASCII->WordStar Conversion:
  53. ===========================
  54.  
  55.   A. Strips all nulls (Hex value: 00)
  56.   B. Replaces hard carriage returns with soft ones, except when:
  57.      1. the first character of the following line is a space or tab or
  58.         another <CR>, or if the next line starts with a period.
  59.      2. the first character of the current line is a period or <CR>.
  60.      3. The ..HARDEN flag has been turned on, and ..SOFTEN not yet
  61.         received.
  62.   C. Optionally compresses multiple spaces between words to one.
  63.   D. Optionally strips leading spaces before step A or B.
  64.  
  65. WordStar->ASCII Conversion
  66. ==========================
  67.  
  68.    A. Removes all high bits.
  69.    B. Throws away control characters, except CR, TAB, and LF.
  70.    C. Optionally expands tabs to 5 spaces.
  71.    D. Optionally strips lines that start with a period.
  72.  
  73.  
  74. IF YOU LIKE WSASCII...
  75. ======================
  76.  
  77. WSASCII is user-supported software. If you like it, please send $10
  78. (each user) to the author:
  79.  
  80.      Brian Raub
  81.      14 Rolling Road
  82.      Overbrook Hills, PA 19151
  83.  
  84. Source code (TURBO PASCAL) is available for $25, on a DOS 2.1 diskette,
  85. shipping included.
  86.