home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / htmstrip.zip / BRUCE.DOC < prev    next >
Text File  |  1999-06-07  |  14KB  |  280 lines
  1. BRUCE.DOC                            1                         Jun 08, 1999
  2.  
  3. ---------------------------------------------------------------------------
  4.                                 Introduction
  5.  
  6. This documentation provides  some  overview  information  on  a  number  of
  7. utilities.  All programs described herein were written  by  Bruce  Guthrie.
  8. Most are distributed with a Wayne Software copyright.  Others were  written
  9. for the U.S.  Department of Commerce.
  10.  
  11. All programs are free for use provided relevant documentation is kept  with
  12. the programs, no changes are made to the  programs  or  documentation,  and
  13. they are not bundled with commercial programs or charged for separately.
  14.  
  15. CHANGE, CONVERT, READ, and READY are excluded from the commercial-packaging
  16. restriction.  These programs are owned by the U.S. Department  of  Commerce
  17. and may be re-distributed without restriction.
  18.  
  19. People who need to bundle AV, BFIND, COPSINCE,  DATES,  DIRCOMP,  DIRTOTAL,
  20. EUMAIL, FILL, FILUPDAT, FIXTEXT, FORTUNE, HTMSTRIP, PAGINATE, READINIT,  or
  21. TXTABLE in commercial packages other  than  shareware/freeware  collections
  22. must pay a $50  registration  fee  to  "Bruce  Guthrie"  at  the  following
  23. address.  READMAKE-created files are also subject to  this  limitation.   I
  24. don't expect to make any money from these utilities but I don't want others
  25. to sell them instead.  Shareware-distribution groups that charge more  than
  26. $7 for a diskette or $20 for a CD-ROM are, as far as I'm concerned,  making
  27. excessive profits from these programs--their actual  costs  are  way  below
  28. this--and probably keeping people from registering the other  shareware  on
  29. the disk; I do not want these types of places distributing my programs.
  30.  
  31. This collection of utilities were compiled using Microsoft's  Visual  BASIC
  32. for DOS 1.0 compiler in addition  to  Thomas  G.   Hanlin  III's  excellent
  33. PBClone  routines.   Since  DOS  compilers  and  libraries  are  not  being
  34. maintained much anymore (Hanlin announced he was stopping  support  of  the
  35. PBClone routines years ago although I got a message from him in March  1999
  36. saying he was reconsidering), adding new data formats and such may  not  be
  37. possible.  Since they are DOS-based, forget long Win95,  Win98,  and  WinNT
  38. file names and such.  The HTMSTRIP and CHANGE programs, in particular,  are
  39. pretty well at their maximum as far as the compiler  is  concerned  so  new
  40. features are pretty unlikely.
  41.  
  42. Documentation provided in appropriate ZIP files:
  43.  routine.DOC:   Each utility is separately described in a like-named  *.DOC
  44.                 file.
  45.  FILE_ID.DIZ:   Standard "Description In Zip" file.
  46.  BRUCE.DOC:     This file serves to summarize all of the various utilities.
  47.  BRUCEINI.DOC:  Most of the routines have  defaults  that  can  altered  by
  48.                 using   initialization   files   (inifiles).    These   are
  49.                 referenced  in  the  regular  documentation   and   further
  50.                 described here.
  51.  BRUCEHEX.DOC:  Many of the routines  allow  you  to  enter  parameters  as
  52.                 either hexadecimal or decimal strings.  This is  referenced
  53.                 in the regular documentation and further described here.
  54.  HISTORY.ymm:   List of recent modifications to all  programs.   The  "ymm"
  55.                 indicates the release date  in  year/month  format.   "601"
  56.                 means 1996, first month (Jan 1996).
  57.  
  58.  
  59. BRUCE.DOC                            2                         Jun 08, 1999
  60.  
  61. All program documentation was created  using  a  text  editor  (PE2).   The
  62. PAGINATE command (see below) was  used  to  justify  the  text  and  create
  63. titles, page breaks, and (where provided) indexes.
  64.  
  65. ---------------------------------------------------------------------------
  66.                             Contact information
  67.  
  68. For the following routines:  AV, BFIND, COPSINCE, DATES, DIRCOMP, DIRTOTAL,
  69. EUMAIL,   FILL,   FIXTEXT,   FORTUNE,   HTMSTRIP,    PAGINATE,    READINIT,
  70. READMAKE-created files, and TXTABLE:
  71.  
  72.                 Bruce Guthrie
  73.                 Wayne Software
  74.                 113 Sheffield St.
  75.                 Silver Spring, MD 20910
  76.  
  77.                 e-mail: WayneSof@erols.com   fax: (301) 588-8986
  78.                 http://www.geocities.com/SiliconValley/Lakes/2414
  79.              or find through http://www.erols.com/waynesof
  80.  
  81. For the following routines:  CHANGE, CONVERT, FILUPDAT, READ, and READY:
  82.  
  83.                 Bruce Guthrie
  84.                 Room H-4885
  85.                 U.S. Dept of Commerce/ESA/STAT-USA
  86.                 Washington, DC 20230
  87.  
  88.                 fax: (202) 482-2164
  89.                 voice: (202) 482-3234
  90.                 e-mail: bguthrie@doc.gov
  91.  
  92. Please provide an Internet e-mail address on all correspondence.
  93.  
  94. Since these programs are typically "freeware" (with the exception of people
  95. trying to make  money  from  them  instead  of  me),  they  generate  maybe
  96. $100/year in revenue for me.  As  such,  my  ability  to  afford  wonderful
  97. customer support is somewhat restricted.   Please  do  not  leave  messages
  98. saying "Call me long  distance".   Also,  please  be  specific  about  what
  99. problems you encounter and include  command-line  inputs  as  well  as  any
  100. control or INI files that you're using.
  101.  
  102.  
  103. WIN/NT AND WIN95 USERS:  All of these programs are DOS applications.   This
  104. means that they expect 8.3 filenames, short paths, etc.  If  you  use  long
  105. paths or illegal characters in your file names or whatever, these  programs
  106. may not work for you.  This is not a "bug" in the  software.   That's  just
  107. the way DOS programs are.
  108.  
  109. STANDARD LEGAL DISCLAIMER:  Wayne Software disclaims all warranties  as  to
  110. this software, whether express or implied, including without limitation any
  111. implied warranties of merchantability, fitness for  a  particular  purpose,
  112. functionality, data integrity or protection.
  113.  
  114.  
  115. BRUCE.DOC                            3                         Jun 08, 1999
  116.  
  117. ---------------------------------------------------------------------------
  118.           Finding the programs--Current version is 906 (1999 June)
  119.  
  120. The utilities are uploaded with a ZIP name that includes the year and month
  121. of the release in a "ymm" format (mm-number  month  where  01=January,  and
  122. 199y for year).  The following Web site has the current versions  of  *all*
  123. programs:
  124.  
  125.              http://www.geocities.com/SiliconValley/Lakes/2414
  126.           or http://www.erols.com/waynesof
  127.  
  128. Major revisions are directly posted by the author to:
  129. * Simtel (Keith Petersen): ftp.simtel.net (http://www.simtel.net/simtel.net)
  130.  
  131.                          Simtel locations and versions
  132.  
  133.   ftp://ftp.simtel.net/pub/simtelnet/msdos/batchutl/
  134. dates812.zip    Warns you in advance of birthdays etc
  135.   ftp://ftp.simtel.net/pub/simtelnet/msdos/diskutil/
  136. fill809.zip     Stuffs as many files as possible on disk
  137.   ftp://ftp.simtel.net/pub/simtelnet/msdos/html/
  138. htmst812.zip    Reprocesses HTML pages for humans to read
  139.   ftp://ftp.simtel.net/pub/simtelnet/msdos/spredsht/
  140. convr809.zip    Convert dBase, ASCII-delim, fixed, 1-2-3
  141.   ftp://ftp.simtel.net/pub/simtelnet/msdos/txtutl/
  142. bfind806.zip    Boolean FIND command (BFIND BEGIN & END)
  143. chang806.zip    Change strings in text/binary files
  144.  
  145. Programs available only on:
  146.  
  147.             http://www.geocities.com/SiliconValley/Lakes/2414:
  148.                or find through http://www.erols.com/waynesof
  149.  
  150. av906.zip       Archive View: Free ZIP etc directory viewer
  151. cops906.zip     Copies files modified since given date
  152. dirco906.zip    Updates files based on source directory
  153. dirto906.zip    Directory lister and totaller
  154. eumal906.zip    Eudora utility for nicknames, boxes
  155. filup906.zip    Copy updated files based on a control list
  156. fixtx906.zip    Translate text file characters en masse
  157. fortn906.zip    Fine-tunes DOS FOR command w/options
  158. pagin906.zip    Paginates text (indexes, sorts, tables)
  159. read906.zip     Free viewer, also make any text self-viewing
  160. txtab906.zip    Generates text tables
  161.  
  162. If you're using a version of the programs that's more than a year old, it's
  163. almost always the case that there's a newer version.  Please check  for  an
  164. update.  If  you  can  receive  binary  mail  attachments,  contact  me  at
  165. WayneSof@erols.com for free updates.  Alternatively, send $10 made  out  to
  166. "Wayne Software" to the Wayne Software address  above  and  I'll  send  you
  167. everything  on  diskette.   (If  you  need  anything  other  than  3.5-inch
  168. high-density diskettes, specify that too please.)
  169.  
  170.  
  171. BRUCE.DOC                            4                         Jun 08, 1999
  172.  
  173. Quick descriptions of each of the programs available at the  GeoCities  are
  174. provided below:
  175.  
  176.  
  177. ---------------------------------------------------------------------------
  178.                         Short program descriptions
  179.  
  180. NOTE:  All programs support early termination by pressing Escape.
  181.  
  182. AV.EXE: Archive directory viewer.  Presents list of files in archive  (ZIP,
  183.    ARC, etc) and lets you sort as desired.  Also allows  resetting  of  the
  184.    file date based on the archive's contents.  NOTE:  Not being updated  on
  185.    Simtel sites.
  186.  
  187. BFIND.EXE: Allows Boolean-type FIND requests.  For example, find  any  line
  188.    with one string AND another one, or any line with one string OR another.
  189.    Also allows wildcarded input file names.
  190.  
  191. CHANGE.EXE: Processes change commands in files.  Files can be of  any  size
  192.    and type (binary or text) and  are  processed  quickly.   Up  to  thirty
  193.    change commands can be  processed  in  a  single  pass.   Also  provides
  194.    ability to remove trailing spaces from text files.
  195.  
  196. CONVERT.EXE: Converts between data formats:   FROM  dBase,  ASCII-delimited
  197.    (typically commas between fields and quotes around strings),  and  fixed
  198.    field TO Lotus WKS,  ASCII-delimited,  dBase,  and  fixed  field.   Also
  199.    provides ability to add and drop  fields,  giving  you  the  ability  to
  200.    crunch tables.
  201.  
  202. COPSINCE.EXE: Copies all files modified since a given date.  Primarily used
  203.    for making sure you have a back-up of files and  also  to  copy  updated
  204.    programs to another place.  Lets you define your own groupings of  files
  205.    if desired.
  206.  
  207. DATES.EXE: Program that warns you in advance when an event like a birthday,
  208.    anniversary, or holiday is coming up.  The idea is to give  you  advance
  209.    warning so you can send a card or get out of town in time.
  210.  
  211. DIRCOMP.EXE: Similar in some ways to DOS's REPLACE command but adds ability
  212.    to delete extra files in the destination subdirectory, copy  hidden  and
  213.    system  files,  and  prepare  a  report  showing  inconsistencies.    Is
  214.    frequently used by network administrators to update workstation files.
  215.  
  216. DIRTOTAL.EXE: Prepares report  showing  files  in  subdirectory  or  drive.
  217.    Allows restricting search based on date, size, attributes,  etc.   Works
  218.    on networked and CD-ROM drives.  Produces more  formalized  report  than
  219.    some utilities do.  Also allows you to look for duplicate file names.
  220.  
  221. EUMAIL.EXE: Eudora mail summarizer.  Dumps your Qualcomm Eudora mailbook as
  222.    well as summarizing the  contents  of  all  of  your  Eudora  boxes  and
  223.    folders.
  224.  
  225.  
  226. BRUCE.DOC                            5                         Jun 08, 1999
  227.  
  228. FILL.EXE: Program designed to move files off to  floppy  diskettes,  taking
  229.    the biggest files first and skipping those that won't fit.   Also  works
  230.    fine for transfers to/from DOS-compatible  networks,  removable  drives,
  231.    etc.  Also supports splitting large files, creating a status report, and
  232.    other features.
  233.  
  234. FILUPDAT.EXE: Program which compares a selected list of files in  a  source
  235.    path against those in another path  and  copies  those  that  have  been
  236.    updated. Similar to DOS' REPLACE command but works from a stored list of
  237.    files and can handle  any  number  of  directories.   NOTE:   Not  being
  238.    updated on Simtel sites.
  239.  
  240. FIXTEXT.EXE: Program which applies a  user-definable  character-translation
  241.    table to a text file.  Can allow you to convert graphics  characters  to
  242.    their text equivalents, lowercase letters to uppercase letter, etc.  Can
  243.    also be used to translate DOS text files to Mac or Unix text  files  and
  244.    vice versa.  Can also expand tabs, remove leading and  trailing  spaces,
  245.    remove backspaces, and remove blank lines.  NOTE:  Not being updated  on
  246.    Simtel sites.
  247.  
  248. FORTUNE.EXE: A tuner-upper for the DOS FOR command.  Generates a batch file
  249.    which does all those wildcard things  you  wished  FOR  could  do  (like
  250.    "FORTUNE IN (*.BAS) DO RENAME %A %2*.*" to remove parts of file  names).
  251.    Lets you do all sorts of things including distinguishing file name roots
  252.    from their extensions as well as incrementing file  names  by  specified
  253.    values.
  254.  
  255. HTMSTRIP.EXE: Processes and removes embedded HTML commands from  Web  pages
  256.    downloaded from the Web.  Reflows paragraphs, processes tables,  etc  as
  257.    straight ASCII text.  Can function on individually-saved pages  or  else
  258.    process your entire disk cache.  Ideal tool for resending via e-mail  or
  259.    dozens of different uses.  Awarded a "Best" rating by "PC Computing"  in
  260.    their July 1996 issue.
  261.  
  262. PAGINATE.EXE: Reformats text files with embedded formatting codes.  Handles
  263.    things  like  titles,  footers,   indexes,   alignment,   justification,
  264.    multicolumn listings, etc.  Also provides support for embedding  tabular
  265.    data in ASCII-delimited or dBase formats which can  be  embedded  and/or
  266.    sorted in your reports.  NOTE:  Not being updated on Simtel sites.
  267.  
  268. READ.EXE, READY.EXE, READINIT.EXE, and READMAKE.EXE:   Text  file  browsing
  269.    utilities.  READ--Supports marking, copying text, reading Unix  and  Mac
  270.    text files, etc.  Handles files of 16,000 lines or less (approx  800,000
  271.    bytes). READY--truncates or wraps lines over 255  characters  in  length
  272.    but handles files of an unlimited number of lines.   READMAKE--Takes  an
  273.    ASCII-text file and makes it self-viewable (using a READ clone).
  274.  
  275. TXTABLE.EXE: Program  to  generate  text  tables.   Allows  inputs  to   be
  276.    HTML-based as well as one-record per cell.  NOTE:  Not being updated  on
  277.    Simtel sites.
  278.  
  279. 
  280.