home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / dbase / convr304.zip / BRUCE304.DOC next >
Text File  |  1993-04-01  |  20KB  |  415 lines
  1. BRUCE304.DOC
  2. 04/01/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 of Wayne Software.  Some were written for and are
  7. distributed by the U.S.  Department of Commerce.  All are free for use provided
  8. relevant documentation is kept with the programs, no changes are made to the
  9. programs or documentation, and they are not bundled with commercial programs or
  10. charged for separately.  READ (but not READMAKE and READINIT) and CONVERT are
  11. excluded from the commercial packaging restriction.  People who need to bundle
  12. any of the other routines in for-sale packages must pay a $50 registration fee
  13. to "Wayne Software" at the following address.  Comments and suggestions can also
  14. be sent to:
  15.  
  16.                 Bruce Guthrie
  17.                 Wayne Software
  18.                 113 Sheffield St.
  19.                 Silver Spring, MD 20910
  20.  
  21.                 fax: (301) 588-8986
  22.  
  23. The utilities are uploaded with a ZIP name that includes the year and month of
  24. the release.  These names are:
  25.  
  26.          ADDymm.ZIP       ADD program
  27.          AVymm.ZIP        AV program
  28.          BFINDymm.ZIP     BFIND program
  29.          CHANGymm.ZIP     CHANGE program
  30.          CONCTymm.ZIP     CONCAT program
  31.          CONVRymm.ZIP     CONVERT program
  32.          DIRCMymm.ZIP     DIRCOMP program
  33.          DIRTOymm.ZIP     DIRTOTAL program
  34.          FILLymm.ZIP      FILL program
  35.          FILUPymm.ZIP     FILUPDAT program
  36.          FIXCHymm.ZIP     FIXCHARS program
  37.          MULCOymm.ZIP     MULTICOL program
  38.          READymm.ZIP      READ program (with READINIT and READMAKE)
  39.          TAKE1ymm.ZIP     TAKE1ST program
  40.  
  41. This collection of utilities were compiled using either Microsoft's QuickBASIC
  42. 4.5 or Microsoft's VisualBASIC for DOS 1.0 compilers.  In each case, Thomas G.
  43. Hanlin III's excellent PBClone routines provided additional functionality.  Each
  44. of the utilities are separately described in a like-named *.DOC file.  This
  45. documentation (BRUCEymm.DOC--the file release date is indicated by the "ymm"
  46. parameter) serves to summarize what the various utilities consist of.
  47.  
  48. Several of the routines have defaults that can be changed by the program
  49. CONFIGWS.EXE which is included in the appropriate ZIP's.
  50.  
  51. Wayne Software also writes programs, batch files, and sets up menu systems for
  52. people on a for-fee basis.  If you desire this service, contact Wayne Software
  53. at the address specified above.
  54.  
  55.  
  56. --------------------------------------------------------------------------------
  57.  
  58. A summary of each routine follows.  See the associated *.DOC files for fuller
  59. explanations:
  60.  
  61. ADD.EXE:  Adds up a column of numbers in a text file.  Also presents minimum and
  62. maximum information.  Syntax:
  63.  
  64.     ADD infile [ /COLUMNS { col1-col2 | col1 colct } ]
  65.       [ /LINES { line1-line2 | line1 linect } ... ]
  66.       [ /V | /-V ] [ /I | /-I ] [ /IN search ]
  67.       [ /C | /-C ] [ /Q ] [ /? ]
  68.  
  69. AV.EXE:  Archive directory viewer.  Presents list of files in archive (ZIP, ARC,
  70. etc) and lets you sort as desired.  Syntax:
  71.  
  72.     AV filespec [ /-P | /P ] [ /Ox | /O-x ] [ /? ]
  73.  
  74. BFIND.EXE:  Allows Boolean-type FIND requests.  For example, find any line with
  75. one string AND another one, or any line with one string OR another.  The syntax
  76. shown below is limited since "search" allows a lot of choices.
  77.  
  78.     BFIND [ /V | /-V ] [ /C | /-C ] [ /N | /-N ] [ /I | /-I ] [ /P | /-P ]
  79.       [ /-HEADER | /HEADER ] { search } infile [ /? ] [ >filename ]
  80.  
  81. CHANGE.EXE:  Processes change commands in files.  Files can be of any size and
  82. type (e.g.  binary or text) and are processed quickly.  Up to twenty-five change
  83. commands can be processed in a single pass.  Also provides ability to remove
  84. trailing spaces from text files.  Syntax:
  85.  
  86.     CHANGE filename [ commandfile | /FROM string /TO string [ /IN search ] ]
  87.       [ /LINES { line1-line2 | line1 linect } ... ] [ /V | /-V ] [ /I | /-I ]
  88.       [ /Noutfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] ]
  89.       [ /Fflag_file ] [ /Ttemp_file ] [ /TRIM | /-TRIM ]
  90.       [ /BINARY | /TEXT ] [ /VERIFY | /-VERIFY ] [ /Q ] [ /? ]
  91.  
  92. CONCAT.EXE:  Concatenates a series of files together.  Can use wildcards or an
  93. input file.  Syntax:
  94.  
  95.     CONCAT [ filespec | @filespec | [drive:]filespec+ ] outfile
  96.       [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ]
  97.       [ BINARY | /TEXT [ /CRLF ] ] [ /LRECL=nnn [ /BLKSIZE=nnnn ] ]
  98.       [ /NAMED ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  99.  
  100. CONFIGWS.EXE:  Lets you change some of the defaults for some of the programs.
  101. Syntax:
  102.  
  103.     CONFIGWS [ routine ] [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /? ]
  104.  
  105. CONVERT.EXE:  Converts between data formats:  FROM dBase, ASCII-delimited
  106. (commas between fields and quotes around strings), and fixed field TO Lotus WKS,
  107. ASCII-delimited, dBase, and fixed field.  Syntax:
  108.  
  109.     CONVERT infile [ outfile [ deffile ] ]
  110.       [ /OVERWRITE | /-OVERWRITE | /APPEND | /OVERASK ]
  111.       [ /DEF=deffile ] [ /FROM { FIXED | ASCII | ASCII=char | DBF } ]
  112.       [ /FIXED | /ASCII | /ASCII=char | /DBF ] [ /USEDEF | /NODEF ]
  113.       [ /TO { FIXED | ASCII | ASCII=char | WKS | DBF } ] [ /HEADER | /-HEADER ]
  114.       [ /SKIP | /MISSING | /ABORT ] [ /SAS ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  115.  
  116. DIRCOMP.EXE:  Updates files in one subdirectory based on files in another
  117. subdirectory.  Similar to DOS' REPLACE commands in some ways but also removes
  118. unused files and can report what it's doing.  Syntax:
  119.  
  120.     DIRCOMP directory1 directory2 [ /ALL ] [ /UPDATE ] [ /KILL ]
  121.       [ /NET ] [ /Ffilename | /FNUL: ]
  122.       [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ] [ /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 ] [ /SPLIT ] [ /SUB | /-SUB ]
  135.       [ /Z ] [ /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. READ.EXE:  Simplified version of a file browser.  Only works with files of
  180. 16,000 lines or less (maybe 800,000 bytes).  Other text viewers are out there.
  181. This one has some advantage because it's free.  Syntax:
  182.  
  183.     READ [ filename ] [ /line ] [ /MONO | /-MONO | /COLOR | /-COLOR ]
  184.       [ /Pport ] [ /-I ] [ /? ]
  185.  
  186. READINIT.EXE:  Creates and maintains the READ.INI file which may be used by
  187. READ.EXE and any self-viewable file created by READMAKE.EXE.  Syntax:
  188.  
  189.     READINIT [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /-I ] [ /? ]
  190.  
  191. READMAKE.EXE:  Program which takes an ASCII-text file and makes it
  192. self-viewable.  Provides same capabilities as the READ program.  Syntax:
  193.  
  194.     READMAKE infile [ outfile ] [ /OVERWRITE | /-OVERWRITE | /OVERASK ]
  195.       [ /DATE=FILE | /DATE=TODAY ] [ /TITLE="text" ] [ /? ]
  196.  
  197. TAKE1ST.EXE:  Program that takes only the first occurrence of a record in a text
  198. file.  Useful way to get rid of duplicates.  Syntax:
  199.  
  200.     TAKE1ST infile outfile [ /COLUMNS { col1-col2 | col1 colct } ...]
  201.       [ /LINES { line1-line2 | line1 linect } ... ]
  202.       [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ]
  203.       [ /V | /-V ] [ /I | /-I ] [ /IN search ]
  204.       [ /UNIQUE | /DUPLICATES ] [ /GROUP=n ] [ /Q ] [ /? ]
  205.  
  206.  
  207. -------------------------------------------------------------------------------
  208.  
  209. Other utilities that I've written that I might clean up and release if requested
  210. include the following:
  211.  
  212. COPSINCE.EXE:  Copies files created since a given date to another subdirectory.
  213.  
  214. DATES.EXE:  Reminds you in advance of birthdays, special events, etc so you
  215. can get cards out in time or get out of time before hand.
  216.  
  217. NETSORT.EXE:  Rather slow directory sorting program (physically arranging the
  218. files in a particular order) which works on files on a network (at least on a
  219. Banyan network).
  220.  
  221. SPLITREC.EXE:  Splits up fixed length files without carriage return/line feeds
  222. into individual text records based on record lengths.
  223.  
  224.  
  225. I suspect there are better shareware/freeware versions of these out there.  In
  226. any case, if you want a complete release of everything, send $10 to the address
  227. above and I'll send you everything.
  228.  
  229. Another Wayne Software product, called The DEMO System, made its debut in
  230. January 1993.  Unlike the other programs, this one is being released as
  231. shareware.  The DEMO System is a unique system designed to create text-screen
  232. demos, tutorials, help screens, etc.  Look for the file DEMOSymm.ZIP on boards
  233. around you.
  234.  
  235.  
  236. ================================Revision history================================
  237.  
  238. Detailed revision history is only maintained for the last two or three releases.
  239. After that, you get the summaries only.  No one reads this junk anyway, right?
  240. Programmer types like to put in it in just to justify what they've been doing
  241. over the last couple of years.
  242.  
  243. --------------------------------------------------------------------------------
  244. Release 93/04:
  245.  
  246. Several bugs were fixed in The DEMO System, READ, and AV.  Nothing new over the
  247. 93/03 releases which weren't distributed much (I hope).
  248.  
  249. READ:  Added the ability to provide an input file list using the "@filename"
  250. parameter.  This lets you specify multiple files to be processed that can't be
  251. handled by a simple wildcard specification.
  252.  
  253. READMAKE:  Made "Text file viewer" the default title.
  254.  
  255. --------------------------------------------------------------------------------
  256. Release 93/03:
  257.  
  258. This was a buggy release that went up on one BBS but not on the Internet.
  259. Usually, I'm making all sorts of changes at the last minute, trying to make an
  260. end of month deadline for posting on the Internet.  In the rush, I found I had
  261. uploaded an older infinite loop version of The DEMO System Then I found I had
  262. incompletely tested the new printer-initialization stuff in READ.  I uploaded a
  263. couple of patched files (under the names READX303.ZIP and DEMOS303.ZIP) but felt
  264. that all of this pushing that I was doing to myself was counterproductive.  The
  265. changes in The DEMO System had been pretty major and left me without as much
  266. debugging time as I really needed.  After the two botched programs, I decided to
  267. not release a 93/03 version to Internet and wait a week or two and put out a
  268. more tested 93/04 version instead.
  269.  
  270. Added one routine this time--AV which is similar to Vern Buerg's FV program but
  271. is free, views archive directories in page mode (so you can flip up and down),
  272. and lets you change the file date to be the date of the most recent member.
  273. Added a new routine--READINIT--to the READymm.ZIP file.  This one creates a
  274. READ.INI file for you, primarily for setting up printer attributes.
  275.  
  276. CONCAT:  Added /-OVERWRITE and /OVERASK options.
  277.  
  278. CONVERT:  Added /APPEND option which only works for ASCII-delimited or fixed-
  279. field output files.
  280.  
  281. DIRCOMP:  Recoding using VisualBASIC for DOS.  Externally, nothing changed
  282. except for using VBDOS's ISAM program to avoid the need for an external sort
  283. program at all.  This resulted in the dropping of the /SORT=pgm parameter.
  284.  
  285. DIRTOTAL:  Recoded using VisualBASIC for DOS.  Externally, nothing changed
  286. except for using VBDOS's ISAM program to avoid the need for an external sort
  287. program at all.  This resulted in the dropping of the /SORT=pgm, /DOS, and /-DOS
  288. parameters.
  289.  
  290. MULTICOL:  Fixed bug occuring when you had a numeric field that you skipped on
  291. output.  Switched ASCII character representation to be /nnn to be more generic
  292. and to fit in with the changes in the READ program.  "/27" should be recoded as
  293. "/027".  Programmed it so imbedded page eject characters would work in any
  294. file that uses the /-WRAP option.
  295.  
  296. READ:  Switched to VBDOS for this one (for better or worse), added support for
  297. printers via the READ.INI file, and added a /-I switch to ignore same.  Added
  298. secondary program READINIT.EXE which manages the READ.INI file.
  299.  
  300. --------------------------------------------------------------------------------
  301. Release 93/02:
  302.  
  303. In general, all routines have shifted from using Hanlin's PBClone 1.8 routines
  304. to using PBClone 2.1.  Some routines should be a bit quicker because of this.
  305. In addition, I bought a fax machine and have put that phone number on this
  306. documentation.  Finally, some of the options were rationalized; most routines
  307. now support /OVERWRITE, /-OVERWRITE, and /OVERASK.  Much of the search
  308. functionality of the BFIND routine was extended to ADD, CHANGE, and TAKE1ST.
  309. Given the number of options supported by CHANGE, it's possible that new bugs
  310. have crept into the program.  Please report them and back up files before using
  311. that command.
  312.  
  313. ADD:  Added /LINES selection option.  Also added /V, /-V, /I, /-I and the search
  314. string capabilities of the BFIND routine.  Changed /SKIP to be /C (similar to
  315. the BFIND and FIND parameters) and added /-C.  Made several options
  316. CONFIGWS-able and added ADD to that routine.
  317.  
  318. BFIND:  Fixed a problem with the /V switch.
  319.  
  320. CHANGE:  Added /OVERWRITE, /-OVERWRITE, and /OVERASK options.  Added /-TRIM,
  321. /-VERIFY, /V, /-V, /I, /-I, and /LINES.  BFIND's search capabilities have been
  322. added to the "/IN search" parameter but only from the command line.  /V, /-V,
  323. /I, and /-I are now settable by the CONFIGWS routine; CHANGE has been added to
  324. that program.  Slashes were added in front of FROM, TO, and IN in order to make
  325. them consistent with the other routines although use without the slashes at
  326. least temporarily works.  /CASE has been renamed /I to be consistent with the
  327. BFIND command (although /CASE at least temporarily still works).
  328.  
  329. CONFIGWS:  Was previously named BGCONFIG; renamed it as CONFIGWS.  Recoded using
  330. the menu routines in PBClone.  Added several settings for (and sometimes added
  331. in general) configuring ADD, CHANGE, DEMOMAKE (fromt The DEMO System), DIRTOTAL,
  332. FILL, and TAKE1ST.  Added /COLOR and /-COLOR as synonyms for /-MONO and /MONO
  333. respectively.
  334.  
  335. CHANGE:  Fixed a problem with files that were in the root.  You could get them
  336. before but you had to explicitly specify the subdirectory due to a bug.  Also
  337. added some colors and changed subroutines to make the hexadecimal conversion
  338. chart a little more readable.
  339.  
  340. CONVERT:  Added /-OVERWRITE and /OVERASK options.  Fixed a bug in writing out
  341. dBase input files with numeric data.  Fixed a bug in reading dBase files with
  342. more than 32,000 records.
  343.  
  344. DIRCOMP:  Boy!  Been awhile since I looked at this one!  Some things didn't work
  345. at all.  Fixed them up.  Added support for PC Magazine's PCSORT program.  Added
  346. /-OVERWRITE and /OVERASK options.
  347.  
  348. DIRTOTAL:  Added directory subtotals (adding in child subdirectories).  Added
  349. /-SUB option.  Added support for PC Magazine's PCSORT program.  Made /SUB vs
  350. /-SUB CONFIGWS-able.
  351.  
  352. FILL:  Added /OVERASK and /OVERSKIP.  Made the /OVERxxxx parms as well as the
  353. order parameter (/O[-]{N,S,D}) CONFIGWS-able.  Added /COPY and /MOVE parameters
  354. as well as /MULTI and /SINGLE; all of these are CONFIGWS-able.  Switched over to
  355. use Hanlin's BoxMenu subroutines for much of the prompting.
  356.  
  357. FILUPDAT:  Added /OVERASK and /-OVERWRITE options.
  358.  
  359. FIXCHARS:  Added /-EJECT, /-OVERWRITE, and /OVERASK options.
  360.  
  361. MULTICOL:  Added /-OVERWRITE and /OVERASK options.
  362.  
  363. READ:  Added /COLOR and /-COLOR as synonyms for /-MONO and /MONO respectively.
  364. Now have READ returning error level 2 (file not found) and error level 1 (bad
  365. parameter).  Added Ctrl-P (printer page eject).  Added /Pport option and added
  366. the setting of this to CONFIGWS.
  367.  
  368. READMAKE:  Added /-OVERWRITE and /OVERASK options.
  369.  
  370. TAKE1ST:  Added /-OVERWRITE and /OVERASK options.  Added /LINES and /GROUP
  371. selection option.  Also added /V, /-V, /I, /-I and the search string
  372. capabilities of the BFIND routine.  Made several options CONFIGWS-able and added
  373. TAKE1ST to that routine.
  374.  
  375. --------------------------------------------------------------------------------
  376. Release 93/01:
  377.  
  378. First release posted on SIMTEL (Internet).
  379.  
  380. New: The DEMO System (shareware and not part of normal package).
  381.  
  382. --------------------------------------------------------------------------------
  383. Release 92/12:
  384.  
  385. Major changes: MULTICOL adds ASCII-delimited and dBase support.
  386.  
  387. --------------------------------------------------------------------------------
  388. Release 92/11:
  389.  
  390. BRUCEymm.ZIP idea ends; utilities released separately now.
  391.  
  392. New:  MULTICOL and READMAKE.
  393.  
  394. --------------------------------------------------------------------------------
  395. Release BRUCE210.ZIP:
  396.  
  397. New:  BFIND and CONFIGWS (called BGCONFIG then).
  398.  
  399. --------------------------------------------------------------------------------
  400. Release BRUCE208.ZIP:
  401.  
  402. New:  FIXCHARS.
  403.  
  404. --------------------------------------------------------------------------------
  405. Release BRUCE205.ZIP:
  406.  
  407. DIRTOTAL supports MS-DOS 5.0 and can avoid external sorting program.
  408.  
  409. --------------------------------------------------------------------------------
  410. Release BRUCE204.ZIP:
  411.  
  412. Initial release.  ADD, CHANGE, CONCAT, CONVERT, DIRCOMP, DIRTOTAL, FILL,
  413. FILUPDAT, READ, and TAKE1ST.
  414.  
  415.