home *** CD-ROM | disk | FTP | other *** search
/ Bila Vrana / BILA_VRANA.iso / 005A / DIRTO603.ZIP / BRUCE603.DOC next >
Text File  |  1996-03-26  |  29KB  |  556 lines
  1. BRUCE603.DOC                         1                         Revised: 03/26/96
  2.  
  3. --------------------------------------------------------------------------------
  4.                               Contact information
  5.  
  6. For the following routines:  AV,  BFIND,  COPSINCE,  DATES,  DIRCOMP,  DIRTOTAL,
  7. FILL, FIXTEXT, FORTUNE, HTMSTRIP, PAGINATE,  READINIT,  READMAKE-created  files,
  8. and TXTABLE:
  9.  
  10.                 Bruce Guthrie
  11.                 Wayne Software
  12.                 113 Sheffield St.
  13.                 Silver Spring, MD 20910
  14.  
  15.                 fax: (301) 588-8986
  16.                 e-mail: bguthrie@nmaa.org
  17.                 http://hjs.geol.uib.no/guthrie/
  18.  
  19. For the following routines:  CHANGE, CONVERT, FILUPDAT, ISAMFIND/ISAMMAKE, READ,
  20. and READY:
  21.  
  22.                 Bruce Guthrie
  23.                 Room H-4885
  24.                 U.S. Dept of Commerce/ESA/STAT-USA
  25.                 Washington, DC 20230
  26.  
  27.                 fax: (202) 482-2164
  28.                 voice: (202) 482-3234
  29.  
  30.                 e-mail: bguthrie@doc.gov
  31.  
  32. Foreign users:  Please provide  an  Internet-reachable  e-mail  address  in  all
  33. correspondence if you have any hope of getting a reply!  Internet e-mail is  the
  34. preferred method of contact for all  other  users  as  well.   America  On-Line,
  35. CompuServe, and Prodigy all offer Internet e-mail access so get with it!
  36.  
  37. Since these programs are typically "freeware"  (with  the  exception  of  people
  38. trying to make money from them instead of me), they generate maybe $100/year  in
  39. revenue for me.  As such, my ability to afford  wonderful  customer  support  is
  40. somewhat restricted.   Please  do  not  leave  messages  saying  "Call  me  long
  41. distance".  Also, please be specific  about  what  problems  you  encounter  and
  42. include command-line inputs as well as any control  or  INI  files  that  you're
  43. using.
  44.  
  45. The "production" releases of these programs are posted  directly  by  me  (Bruce
  46. Guthrie, the author) on the Simtel ftp site at ftp.coast.net.  More  information
  47. about locations at this site is provided later.  People are encouraged to upload
  48. them to bulletin board systems but I do not upload them to BBS's myself.
  49.  
  50. Standard disclaimer in this society:  Wayne Software disclaims all warranties as
  51. to this software, whether express or implied, including without  limitation  any
  52. implied  warranties  of  merchantability,  fitness  for  a  particular  purpose,
  53. functionality, data integrity or protection.
  54.  
  55.  
  56. BRUCE603.DOC                         2                         Revised: 03/26/96
  57.  
  58. --------------------------------------------------------------------------------
  59.                                   Introduction
  60.  
  61. This documentation provides some overview information on a number of  utilities.
  62. All  programs  described  herein  were  written  by  Bruce  Guthrie.   Most  are
  63. distributed with a Wayne Software copyright.  Others were written for  the  U.S.
  64. Department of Commerce.  All are free for use provided relevant documentation is
  65. kept with the programs, no changes are made to the  programs  or  documentation,
  66. and they are not bundled with commercial programs or charged for separately.
  67.  
  68. CHANGE, CONVERT, FILUPDAT, ISAMFIND/ISAMMAKE, READ, and READY are excluded  from
  69. the commercial-packaging restriction.  These programs  are  owned  by  the  U.S.
  70. Department of Commerce and may be re-distributed without restriction.
  71.  
  72. People who need to bundle AV, BFIND, COPSINCE, DATES, DIRCOMP,  DIRTOTAL,  FILL,
  73. FIXTEXT,  FORTUNE,  HTMSTRIP,  PAGINATE,  READINIT,  or  TXTABLE  in  commercial
  74. packages other than shareware/freeware collections must pay a  $50  registration
  75. fee to "Wayne Software" at the following address.   READMAKE-created  files  are
  76. also subject to this limitation.  I don't expect to make any  money  from  these
  77. utilities but I don't want others to sell them instead.
  78.  
  79. This collection of utilities were compiled using Microsoft's  Visual  BASIC  for
  80. DOS 1.0 compiler.  Thomas G. Hanlin III's excellent  PBClone  routines,  release
  81. 2.3, provided additional functionality.  Since Tom has dropped support  for  his
  82. PBClone routines, some things will are simply not possible for me to do so don't
  83. push!  The basic routines should be able to be maintained indefinitely  as  long
  84. as DOS continues to exist; we'll see.  I keep thinking that I  should  be  doing
  85. Windows programming but it's hard to get psyched up for that when you  think  of
  86. Windows as a computer virus.
  87.  
  88. Documentation provided in appropriate ZIP files:
  89.  * routine.DOC: Each utility is separately described in a like-named *.DOC file.
  90.  * FILE_ID.DIZ: Standard Description In Zip file.
  91.  * BRUCEymm.DOC: This file serves to summarize all  of  the  various  utilities.
  92.      The "ymm" indicates the release date in  year/month  format.   "601"  means
  93.      1996, first month (Jan 1996).
  94.  * BRUCEINI.DOC: Most of the routines have defaults that can  altered  by  using
  95.      initialization files (inifiles).   These  are  referenced  in  the  regular
  96.      documentation and further described here.  (One thing about *.INI files; if
  97.      you don't have one, it's in your interests to specify the "/-I"  parameter.
  98.      Otherwise, the program searches your entire DOS path looking for the file.)
  99.  * BRUCEHEX.DOC: Many of the routines allow you to enter  parameters  as  either
  100.      hexadecimal  or  decimal  strings.   This  is  referenced  in  the  regular
  101.      documentation and further described here.
  102.  
  103.      All program documentation was created  using  a  text  editor  (PE2).   The
  104.      PAGINATE command (see below) was  used  to  justify  the  text  and  create
  105.      titles, page breaks, and (where provided) indexes.
  106.  
  107. Beta  testers  and  suggestions  are  always   appreciated.    Contact   me   at
  108. bguthrie@nmaa.org  Note that all beta releases are done via e-mail  so  if  your
  109. gateway can't handle some pretty big mail attachments,  you  definitely  do  NOT
  110. want to be a beta tester for me!  Modifications that are not of  mainstream  use
  111. can be contracted for.
  112.  
  113.  
  114. BRUCE603.DOC                         3                         Revised: 03/26/96
  115.  
  116. --------------------------------------------------------------------------------
  117.                             The programs themselves
  118.  
  119. The utilities are uploaded with a ZIP name that includes the year and  month  of
  120. the release in a "ymm" format ("603" is the March 1996 version).  The files  are
  121. posted directly by the author to two places.  The following  Web  site  has  the
  122. current versions of *all* programs:
  123.  
  124.                 http://hjs.geol.uib.no/guthrie/
  125.  
  126. Thanks to Hans Schrader for the Web site!  Major releases are also posted on the
  127. Simtel archives at  ftp.coast.net  (Web  to  http://www.coast.net/SimTel  site.)
  128. Users are encouraged to post the files on bulletin boards and such  but,  again,
  129. the author directly posts only to these sites.
  130.  
  131. If you're using a version of the programs that's more  than  a  year  old,  it's
  132. almost always the case that there's  a  newer  version.   Please  check  for  an
  133. update.  If you can receive binary attachments, contact me at  bguthrie@nmaa.org
  134. for free updates.  Alternatively, send $10 made out to "Wayne Software"  to  the
  135. Wayne Software address above and I'll send you everything on diskette.  (If  you
  136. need anything other than 3.5" high density, specify that too please.)
  137.  
  138. The versions of each program posted on SimTel are documented  below  along  with
  139. the directory information for  this  site.   The  *current*  versions  of  *all*
  140. programs are posted on the Web site in Norway.
  141.  
  142. This listing is current as of the February 1996 (602) release.
  143.  
  144. SimTel/msdos/arcutil/
  145. av602.zip       Archive View: Free ZIP etc directory viewer
  146.  
  147.    AV.EXE:  Archive directory viewer.  Presents list of files in  archive  (ZIP,
  148.    ARC, etc) and lets you sort as desired.  Also allows resetting  of  the  file
  149.    date based on the archive's contents.
  150.  
  151. SimTel/msdos/textutil/
  152. bfind511.zip    Boolean FIND command (BFIND BEGIN & END)
  153.  
  154.    BFIND.EXE:  Allows Boolean-type FIND requests.  For example,  find  any  line
  155.    with one string AND anot