home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / wp / filt7m.zip / FILT7M.DOC < prev    next >
Text File  |  1989-01-01  |  4KB  |  109 lines
  1.  
  2.     FILT7M - Filters ASCII text or .ASM source code files - 12/01/88
  3.                                    by
  4.                       Dennis Vallianos, based on:
  5.  
  6.  
  7.                      FILT7A, A CP/M Filter Program
  8.                            by Irv Hoff W6FFC
  9.                        COPYRIGHT 1984, 1985, 1986
  10.  
  11.  
  12. This program filters several types of unwanted characters  from  various
  13. types  of ASCII files, including those written by the Wordstar word pro-
  14. cessor program.  These include unwanted  control  characters,  high-bits
  15. set,  soft-hyphens,  soft-carriage  returns, space-breaks, dot commands,
  16. etc.  It also removes all tabs, then retabs automatically -  since  this
  17. involves not adding tabs in DB strings, the user needs to type a "T" for
  18. any sort of ASCII text file, or any other character (including a RETURN)
  19. for any source code .ASM file.  It has the following choices:
  20.  
  21. Note:  Although  written  specifically for handling WordStar ".dot"
  22.        commands, this program works equally  well on document files
  23.        generated by most other word processors, as well.
  24.  
  25.                      1) Wordstar, normal files
  26.                      2) Wordstar, w/dot commands
  27.                      3) ASCII text files
  28.  
  29.                              select:
  30.                              tabs (y/n):
  31.  
  32.         1) Wordstar files, normal.  Insures any file generated
  33.            by the Wordstar word processor can be used  on  any
  34.            other  system.   (Also  selected  by  default  with
  35.            RETURN.)
  36.  
  37.         2) Wordstar files, retains all  dot  commands  -  some
  38.            host   systems   such   as  Compuserve  use  "dots"
  39.            (periods) in the first column  for  enabling  blank
  40.            lines.   This  selection  is  primarily  for  those
  41.            users.
  42.  
  43.         3) Normal ASCII text files.
  44.  
  45.                  NOTE:  Although option 1  removes  dot
  46.                         commands, it changes ".pa" into
  47.                         FF (form feed) characters.
  48.  
  49.  
  50. A  comprehensive  summary  of  what the program found and what it did is
  51. presented upon completion.  A display is provided showing  the  progress
  52. of  the  program.   This  is controlled by byte 103, which can easily be
  53. changed by DDT.  Change to 0F (every 16 lines), 1F (every 32  lines)  or
  54. 3F  (every 64 lines) to match the speed of your equipment.  Then save 12
  55. pages.  The following is a general description of all the options:
  56.  
  57. It is a very small program (under 4k) and very fast, as it was written
  58. completely in assembly level code.
  59.  
  60.  
  61.   NORMAL FEATURES:
  62.   ---------------
  63.         1) counts all current tabs, then removes all tabs
  64.         2) removes any unneeded trailing spaces or tabs
  65.         2) places tabs every 8 columns wherever possible as long
  66.                 as there is more than 1 space.  (In  Text  mode,
  67.                 asks if you want any tabs or not.)
  68.         3) optionally selects between ASCII text and .ASM source
  69.            code.
  70.              a) If .ASM is selected, does not attempt to put new
  71.                 tabs  in  quoted  DB  strings and will replace a
  72.                 single space with a  tab  until  encountering  a
  73.                 semicolon delimiter.
  74.  
  75.  
  76.   WHY THE TWO CHOICES:
  77.   -------------------
  78.         The .ASM source code version will not compress spaces into tabs
  79.         between "quotes", in any DB strings.  As the ASCII text version
  80.         will be processed by a normal display and/or printer routine it
  81.         does compress spaces, wherever possible, if tabs  are requesed.
  82.  
  83.  
  84.   DISPLAYS UPON COMPLETION:
  85.   ------------------------
  86.                 total lines in the file
  87.  
  88.                    original spaces
  89.                    original tabs
  90.                    current  spaces
  91.                    current  tabs
  92.  
  93.                    form feeds present
  94.                    high-order bits zeroed
  95.                    imbedded control chars. deleted
  96.                    orphan LF's fixed
  97.                    trailing spaces deleted
  98.  
  99.   (For Wordstar:)  dot commands deleted
  100.                    soft CR's fixed
  101.                    soft hyphens fixed
  102.                    space breaks fixed
  103.  
  104.  
  105.  
  106.                                         - notes by Irv Hoff W6FFC
  107.  
  108.  -----------------------------------------------------------------------
  109.