home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / textutil / read307.zip / BRUCE307.DOC next >
Text File  |  1993-07-19  |  13KB  |  311 lines
  1. BRUCE307.DOC
  2. 07/19/93
  3.  
  4. This documentation provides some overview information on a number of utilities
  5. that have been posted by Wayne Software.  All programs described herein were
  6. written by Bruce Guthrie.  Most are distributed with a Wayne Software copyright.
  7. Others were written for the U.S.  Department of Commerce.  All are free for use
  8. provided relevant documentation is kept with the programs, no changes are made
  9. to the programs or documentation, and they are not bundled with commercial
  10. programs or charged for separately.  READ (but not READMAKE and READINIT) and
  11. CONVERT are excluded from the commercial packaging restriction.
  12.  
  13. People who need to bundle AV, BFIND, DIRTOTAL, FILL, MULTICOL, NETSORT, or
  14. READWK in commercial packages other than shareware/freeware collections must pay
  15. a $50 registration fee to "Wayne Software" at the following address.  Comments
  16. and suggestions can also be sent to:
  17.  
  18.                 Bruce Guthrie
  19.                 Wayne Software
  20.                 113 Sheffield St.
  21.                 Silver Spring, MD 20910
  22.  
  23.                 fax: (301) 588-8986
  24.  
  25. The utilities are uploaded with a ZIP name that includes the year and month of
  26. the release.  These names are:
  27.  
  28.          AVymm.ZIP        (a) AV program
  29.                           (a) w/CONFIGWS
  30.          BFINDymm.ZIP     (a) BFIND program
  31.                           (a) w/CONFIGWS
  32.          CHANGymm.ZIP     (b) CHANGE program
  33.                           (a) w/CONFIGWS
  34.          CONCTymm.ZIP     (b) CONCAT program
  35.          CONVRymm.ZIP     (b) CONVERT program
  36.                           (a) w/CONFIGWS
  37.          DIRTOymm.ZIP     (a) DIRTOTAL program
  38.                           (a) w/CONFIGWS
  39.          FILLymm.ZIP      (a) FILL program
  40.                           (a) w/CONFIGWS
  41.          FILUPymm.ZIP     (b) FILUPDAT program
  42.          FIXCHymm.ZIP     (b) FIXCHARS program
  43.          MULCOymm.ZIP     (a) MULTICOL program
  44.          NETSOymm.ZIP     (a) NETSORT program
  45.          READymm.ZIP      (b) READ program
  46.                           (a) w/CONFIGWS program
  47.                           (a) w/READINIT program
  48.                           (a) w/READMAKE program
  49.          READWyym.ZIP     (a) READWK program
  50.                           (a) w/CONFIGWS program
  51.                           (a) w/READINIT program
  52.  
  53. Note:  "(a)" indicates owned by Wayne Software.  "(b)" indicates owned by U.S.
  54. Department of Commerce.
  55.  
  56.  
  57. This collection of utilities were compiled using Microsoft's VisualBASIC for DOS
  58. 1.0 compiler.  In each case, Thomas G.  Hanlin III's excellent PBClone routines
  59. provided additional functionality.  Each of the utilities are separately
  60. described in a like-named *.DOC file.  This documentation (BRUCEymm.DOC--the
  61. file release date is indicated by the "ymm" parameter) serves to summarize what
  62. the various utilities consist of.
  63.  
  64. Several of the routines have defaults that can be changed by the program
  65. CONFIGWS.EXE which is included in the appropriate ZIP's.
  66.  
  67. Wayne Software also writes programs, batch files, and sets up menu systems for
  68. people on a for-fee basis.  If you desire this service, contact Wayne Software
  69. at the address specified above.
  70.  
  71.  
  72. --------------------------------------------------------------------------------
  73.  
  74. A summary of each routine follows.  See the associated *.DOC files for fuller
  75. explanations:
  76.  
  77. AV.EXE:  Archive directory viewer.  Presents list of files in archive (ZIP, ARC,
  78. etc) and lets you sort as desired.  Syntax:
  79.  
  80.     AV filespec [ /-P | /P ] [ /Ox | /O-x ] [ /? ]
  81.  
  82. BFIND.EXE:  Allows Boolean-type FIND requests.  For example, find any line with
  83. one string AND another one, or any line with one string OR another.  The syntax
  84. shown below is limited since "search" allows a lot of choices.
  85.  
  86.     BFIND [ /V | /-V ] [ /C | /-C ] [ /N | /-N ] [ /I | /-I ] [ /P | /-P ]
  87.       [ /-HEADER | /HEADER ] { search } infile [ /? ] [ >filename ]
  88.  
  89. CHANGE.EXE:  Processes change commands in files.  Files can be of any size and
  90. type (e.g.  binary or text) and are processed quickly.  Up to twenty-five change
  91. commands can be processed in a single pass.  Also provides ability to remove
  92. trailing spaces from text files.  Syntax:
  93.  
  94.     CHANGE filename [ commandfile | /FROM string /TO string [ /IN search ] ]
  95.       [ /LINES { line1-line2 | line1 linect } ... ] [ /V | /-V ] [ /I | /-I ]
  96.       [ /Noutfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] ]
  97.       [ /Fflag_file ] [ /Ttemp_file ] [ /TRIM | /-TRIM ]
  98.       [ /BINARY | /TEXT ] [ /VERIFY | /-VERIFY ] [ /Q ] [ /? ]
  99.  
  100. CONCAT.EXE:  Concatenates a series of files together.  Can use wildcards or an
  101. input file.  Syntax:
  102.  
  103.     CONCAT [ filespec | @filespec | [drive:]filespec+ ] outfile
  104.       [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ]
  105.       [ BINARY | /TEXT [ /CRLF ] ] [ /LRECL=nnn [ /BLKSIZE=nnnn ] ]
  106.       [ /NAMED ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  107.  
  108. CONFIGWS.EXE:  Lets you change some of the defaults for some of the programs.
  109. Syntax:
  110.  
  111.     CONFIGWS [ routine ] [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /? ]
  112.  
  113. CONVERT.EXE:  Converts between data formats:  FROM dBase, ASCII-delimited
  114. (commas between fields and quotes around strings), and fixed field TO Lotus WKS,
  115. ASCII-delimited, dBase, and fixed field.  Syntax:
  116.  
  117.     CONVERT infile [ outfile [ deffile ] ]
  118.       [ /OVERWRITE | /-OVERWRITE | /APPEND | /OVERASK ]
  119.       [ /DEF=deffile ] [ /FROM { FIXED | ASCII | ASCII=char | DBF } ]
  120.       [ /FIXED | /ASCII | /ASCII=char | /DBF ] [ /USEDEF | /NODEF ]
  121.       [ /TO { FIXED | ASCII | ASCII=char | WKS | DBF } ] [ /HEADER | /-HEADER ]
  122.       [ /SKIP | /MISSING | /ABORT ] [ /SAS ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  123.  
  124. DIRTOTAL.EXE:  Prepares report showing files in subdirectory or drive.  Allows
  125. some restriction requests (show only files with date greater than a certain
  126. value).  Similar to Norton's FF and Ray Van Tassle's WIZ command (which is a
  127. great program but it doesn't work on network or CD-ROM discs) in some ways but
  128. presents a more formal report.  Syntax:
  129.  
  130.     DIRTOTAL [ [ drive: ] ... [drive:][filespec] |
  131.         [ drive: ] ... [drive:]\path[\filespec] ]
  132.       [ /NL ] [ /S { GT | GE | LT | LE | EQ | NE } value ]
  133.       [ /D { GT | GE | LT | LE | EQ | NE } mm/dd/yy ]
  134.       [ /ATTR=attr ] [ /Ffilename ] [ /Z ] [ /SPLIT | /WIDE ]
  135.       [ /SUB | /-SUB ] [ /Ox | /O-x ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  136.  
  137. FILL.EXE:  Program designed to fill up floppies with the maximum number of files
  138. that will fit into them.  "FILL *.BAS" will move *.BAS files onto a floppy,
  139. taking the biggest files first.  When it can't fit a file, it will skip it and
  140. move the next one.  Syntax:
  141.  
  142.     FILL [ source-filespec ] [ dest-drive: | dest-drive:\path\ ] [ /MOVE | /COPY ]
  143.       [ /OVERWRITE | /-OVERWRITE | /OVERSKIP | /OVERASK ] [ /PROMPT | /-PROMPT ]
  144.       [ /Ox | /O-x ] [ /Xfilespec ]... [ /WIPE | /-WIPE ] [ /MULTI | /SINGLE ]
  145.       [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  146.  
  147. FILUPDAT.EXE:  Program which compares a selected list of files in a source path
  148. against those in another path and copies those that have been updated.  Similar
  149. to DOS' REPLACE command but works from a stored list of files and can handle any
  150. number of directories.  Syntax:
  151.  
  152.     FILUPDAT control_fil
  153.       [ /Flist_file [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ] ]
  154.       [ /FULL ] [ /ALL ] [ /Q ] [ /? ]
  155.  
  156. FIXCHARS.EXE:  Program which removes non-standard print characters from a text
  157. file.  Translates graphics characters into their ASCII equivalents.  Also
  158. expands tabs and removes backspaces.  Is primarily intended for people who have
  159. problems printing a file.  Syntax:
  160.  
  161.     FIXCHARS infile { outfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] |
  162.       /REPLACE } [ /BINARY | /TEXT ] [ /Ffilename ] [ /-EJECT ] [ /Q ] [ /? ]
  163.  
  164. MULTICOL.EXE:  Program creates multiple column listings from straight ASCII
  165. text, ASCII-delimited text, or dBase files.  Also does subtotalling.  Syntax:
  166.  
  167.     MULTICOL infile outfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ]
  168.       [ /DELIM="string" ]
  169.       [ /LINES=n ] [ /WIDTH=n ] [ /EJECT | /-EJECT ]
  170.       [ /COLUMNS=n ] [ /WRAP | /-WRAP [ /INDENT=n ] | /REFLOW ]
  171.       [ /Ccontrol_file ] [ /SETUP="string" ] [ /RESET="string" ]
  172.       [ /{ TITLE | HEADER | FOOTER }[ R | C | L ][ 1 to 5]="text" ]
  173.       [ /{ TITLE | HEADER | FOOTER }{ T | B }="string" ]
  174.       [ /FROM ASCII | /FROM ASCII=char | /FROM DBF ] [ /DEF=deffile ]
  175.       [ /SKIP | /MISSING | /ABORT ] [ /GAP=n ] [ /USEDEF ] [ /TALLY ]
  176.       [ /SUM={ col_spec | var_spec } ] [ /BREAK={ col_spec | var_spec } ]
  177.       [ /PRINT={ col_spec | var_spec } ] [ /? ]
  178.  
  179. NETSORT.EXE:  Slow but effective method for sorting files on a Banyan (and
  180. possibly other) server.  Syntax:
  181.  
  182.     NETSORT [ path ] [ /S ] [ /Ox | /O-x ] [ /BEEP | /-BEEP ] [ /? ]
  183.  
  184. READ.EXE:  Simplified version of a file browser.  Only works with files of
  185. 16,000 lines or less (maybe 800,000 bytes).  Other text viewers are out there.
  186. This one has some advantage because it's free.  Syntax:
  187.  
  188.     READ [ filename ] [ /line ] [ /MONO | /-MONO | /COLOR | /-COLOR ]
  189.       [ /DOS | /-DOS ] [ /Pport ] [ /-I ] [ /? ]
  190.  
  191. READINIT.EXE:  Creates and maintains the READ.INI file which may be used by
  192. READ.EXE, READWK.EXE and any self-viewable file created by READMAKE.EXE.
  193. Syntax:
  194.  
  195.     READINIT [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /-I ] [ /? ]
  196.  
  197. READMAKE.EXE:  Program which takes an ASCII-text file and makes it
  198. self-viewable.  Provides same capabilities as the READ program.  Syntax:
  199.  
  200.     READMAKE infile [ outfile ] [ /OVERWRITE | /-OVERWRITE | /OVERASK ]
  201.       [ /DATE=FILE | /DATE=TODAY ] [ /TITLE="text" ] [ /? ]
  202.  
  203. READWK.EXE:  Program to view Lotus worksheets (WKS and WK1 only at this point;
  204. anyone know the forms for WK3?).  Limited to 2500 cells.  Syntax:
  205.  
  206.     READWK [ filespec | @filename ] [ /row ] [ /Pport ] [ /-I ]
  207.       [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /? ]
  208.  
  209. -------------------------------------------------------------------------------
  210.  
  211. If you can't get all of the utilities from your own sources, send $10 to the
  212. address above and I'll send you everything.  Please specify disk type.
  213.  
  214. Another Wayne Software product, called The DEMO System, is released as a
  215. shareware program.  The DEMO System is a unique system designed to create
  216. text-screen demos, tutorials, help screens, etc.  Look for the file
  217. DEMOSymm.ZIP.
  218.  
  219.  
  220. ================================Revision history================================
  221.  
  222. Detailed revision history is only maintained for the last two or three releases.
  223. After that, you get the summaries only.  No one reads this junk anyway, right?
  224. Programmer types like to put in it in just to justify what they've been doing
  225. over the last couple of years.
  226.  
  227. Release 93/07:
  228.  
  229. DIRTOTAL:  Fixed a bug when it came to naming DIR files for CD-ROM and
  230. Bernoulli drives.
  231.  
  232. READ:  Added F9 (backward search for text).  Also incorporated in any READMAKE
  233. files too.  Fixed a bug in READMAKE--searching didn't work at all.
  234.  
  235. --------------------------------------------------------------------------------
  236. Release 93/06:
  237.  
  238. DIRTOTAL:  Added /Ox and /O-x to change the default listing order.  Made
  239. this CONFIGWS-able.  Added a new /WIDE option after being able to uncatalog
  240. all files on Walnut Creek's CD-ROM version of the SIMTEL archives.  Fixed up a
  241. bug which didn't let it work when the CD-ROM was the default drive.
  242.  
  243. FILL:  Added recovery when the output disk was not present.
  244.  
  245. READ:  Added /-DOS and /DOS options and made them CONFIGWS-able.
  246.  
  247. --------------------------------------------------------------------------------
  248.  
  249. Release 93/05:
  250.  
  251.   ADD, DIRCOMP, and TAKE1ST:  Dropped.
  252.  
  253.   New:  NETSORT and READWK.
  254.  
  255. Release 93/04:
  256.  
  257.   READ:  Added the ability to provide an input file list using the "@filename"
  258.   parameter.
  259.  
  260. Release 93/03:
  261.  
  262.   New:  Added AV (archive viewer) and READINIT (creates printer initialization
  263.   file for READ.
  264.  
  265.   DIRTOTAL:  Switched to ISAM processing to avoid need for external sort
  266.   programs.
  267.  
  268.   READ:  Added support for printers via the READ.INI file.
  269.  
  270. Release 93/02:
  271.  
  272.   CHANGE, CONVERT, DIRCOMP, FILL, FILUPDAT, FIXCHARS, MULTICOL, READMAKE, and
  273.   TAKE1ST:  Added /OVERWRITE, /OVERASK, /-OVERWRITE, and /OVERPROMPT where
  274.   appropriate.
  275.  
  276.   FILL:  Added /COPY and /MULTI features.
  277.  
  278. Release 93/01:
  279.  
  280.   First release posted on SIMTEL (Internet).
  281.  
  282.   New:  The DEMO System (shareware and not part of normal package).
  283.  
  284. Release 92/12:
  285.  
  286.   Major changes:  MULTICOL adds ASCII-delimited and dBase support.
  287.  
  288. Release 92/11:
  289.  
  290.   BRUCEymm.ZIP idea ends; utilities released separately now.
  291.  
  292.   New:  MULTICOL and READMAKE.
  293.  
  294. Release BRUCE210.ZIP:
  295.  
  296.   New:  BFIND and CONFIGWS (called BGCONFIG then).
  297.  
  298. Release BRUCE208.ZIP:
  299.  
  300.   New:  FIXCHARS.
  301.  
  302. Release BRUCE205.ZIP:
  303.  
  304.   DIRTOTAL supports MS-DOS 5.0 and can avoid external sorting program.
  305.  
  306. Release BRUCE204.ZIP:
  307.  
  308.   Initial release.  ADD, CHANGE, CONCAT, CONVERT, DIRCOMP, DIRTOTAL, FILL,
  309.   FILUPDAT, READ, and TAKE1ST.
  310.  
  311.