home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 24 / CD_ASCQ_24_0995.iso / vrac / fill506.zip / BRUCE506.DOC next >
Text File  |  1995-06-13  |  19KB  |  414 lines

  1. BRUCE506.DOC
  2. 06/13/95
  3.  
  4. --------------------------------------------------------------------------------
  5.                               Contact information
  6.  
  7. For the following routines:  AV, BFIND, COPSINCE, DATES, DIRCOMP, DIRTOTAL,
  8. FILL, FIXTEXT, FORTUNE, PAGINATE, READINIT, and READMAKE-created files:
  9.  
  10.                 Bruce Guthrie
  11.                 Wayne Software
  12.                 113 Sheffield St.
  13.                 Silver Spring, MD 20910
  14.  
  15.                 fax: (301) 588-8986
  16.  
  17. For the following routines:  CHANGE, CONVERT, FILUPDAT, ISAMFIND/ISAMMAKE,
  18. READ, READY, and SPLITREC:
  19.  
  20.                 Bruce Guthrie
  21.                 Room H-4885
  22.                 U.S. Dept of Commerce/ESA/STAT-USA
  23.                 Washington, DC 20230
  24.  
  25.                 fax: (202) 482-2164
  26.                 voice: (202) 482-3234
  27.  
  28.                 E-Mail: bgu@cu.nih.gov
  29.  
  30. Foreign users:  Please provide an Internet-reachable e-mail address in all
  31. correspondence if you have any hope of getting a reply!  Internet e-mail is the
  32. preferred method of contact for all other users as well.  Remember, CompuServe
  33. and Prodigy are now Internet accessible.
  34.  
  35. Since these programs are typically "freeware" (with the exception of people
  36. trying to make money from them instead of me), they generate maybe $100/year in
  37. revenue for me.  As such, my ability to afford wonderful customer support is
  38. somewhat restricted.  Please do not leave messages saying "Call me long
  39. distance".  Also, please be specific about what problems you encounter and
  40. include command-line inputs as well as any control or INI files that you're
  41. using.
  42.  
  43. The "production" releases of these programs are posted directly by me (Bruce
  44. Guthrie, the author) on the Simtel ftp site at oak.oakland.edu.  More
  45. information about locations at this site is provided later.  People are
  46. encouraged to upload them to bulletin board systems but I do not upload them to
  47. BBS's myself.
  48.  
  49. Standard disclaimer in this society:  Wayne Software disclaims all warranties as
  50. to this software, whether express or implied, including without limitation any
  51. implied warranties of merchantability, fitness for a particular purpose,
  52. functionality, data integrity or protection.
  53.  
  54.  
  55. --------------------------------------------------------------------------------
  56.                                   Introduction
  57.  
  58. This documentation provides some overview information on a number of utilities
  59. that have been posted by Wayne Software.  All programs described herein were
  60. written by Bruce Guthrie.  Most are distributed with a Wayne Software copyright.
  61. Others were written for the U.S. Department of Commerce.  All are free for use
  62. provided relevant documentation is kept with the programs, no changes are made
  63. to the programs or documentation, and they are not bundled with commercial
  64. programs or charged for separately.
  65.  
  66. CHANGE, CONVERT, FILUPDAT, ISAMFIND/ISAMMAKE, READ, and SPLITREC are excluded
  67. from the commercial-packaging restriction.  These programs are owned by the
  68. U.S. Department of Commerce and may be re-distributed without restriction.
  69.  
  70. People who need to bundle AV, BFIND, COPSINCE, DATES, DIRCOMP, DIRTOTAL, FILL,
  71. FIXTEXT, FORTUNE, PAGINATE, READINIT, or READMAKE files in commercial packages
  72. other than shareware/freeware collections must pay a $50 registration fee to
  73. "Wayne Software" at the following address.  READMAKE-created files are also
  74. subject to this limitation.  I don't expect to make any money from these
  75. utilities but I don't want others to sell them instead.
  76.  
  77. This collection of utilities were compiled using Microsoft's Visual BASIC for
  78. DOS 1.0 compiler.  In each case, Thomas G. Hanlin III's excellent PBClone
  79. routines, release 2.3, provided additional functionality.  Since Tom has
  80. announced that he will be dropping support for his PBClone routines to allow
  81. himself to spend time on a real life, future directions for my routines is
  82. uncertain.  The basic routines should be able to be maintained indefinitely;
  83. we'll see.  I keep thinking that I should be doing Windows programming but it's
  84. hard to get psyched up for that when you think of Windows as a computer virus.
  85.  
  86. Each of the utilities are separately described in a like-named *.DOC file.  This
  87. documentation (BRUCEymm.DOC--the file release date is indicated by the "ymm"
  88. parameter) serves to summarize the various utilities.
  89.  
  90. Most of the routines have defaults that can altered by using initialization
  91. files (inifiles).  These are described in the appropriate documentation.  (One
  92. thing about *.INI files; if you don't have one, it's in your interests to
  93. specify the "/-I" parameter.  Otherwise, the program searches your entire DOS
  94. path looking for the file.)
  95.  
  96. Wayne Software also writes programs, batch files, and sets up menu systems for
  97. people on a for-fee basis.  If you desire this service, contact Wayne Software
  98. at the address specified above.
  99.  
  100.  
  101. --------------------------------------------------------------------------------
  102.                             The programs themselves
  103.  
  104. The utilities are uploaded with a ZIP name that includes the year and month of
  105. the release in a "ymm" format ("409" is September 1994 version).  The files are
  106. posted directly by the author to the Simtel archives at oak.oakland.edu and are
  107. available via anonymous ftp through that site.  Users are encouraged to post the
  108. files on bulletin boards and such but, again, the author directly posts only to
  109. the Simtel archives.
  110.  
  111. In addition, beginning in June 1995, I will be posting the current versions of
  112. everything on the anonymous ftp site ftp.cu.nih.gov.  Check under the directory
  113. BGUTHRIE.  While the Simtel archives will have the official versions, the NIH
  114. site will have the absolute most current version.  There won't be any
  115. significant differences between the Simtel versions and the NIH versions; the
  116. NIH versions will just have some minor tweeking differences.  The NIH site may
  117. also have beta versions of the software that the Simtel site won't have until
  118. it's ready.  The NIH site may not be available to me in the long-term whereas
  119. the Simtel site will be.
  120.  
  121. The current version of each program is documented below.  In addition, the
  122. Simtel subdirectory name, the Simtel one-line description, and the regular short
  123. file description (from the *.DIZ file) are provided for each of the programs.
  124.  
  125. This listing is current as of the June 1995 (906) release.
  126.  
  127. SimTel/msdos/arcutil/
  128. av412.zip       Archive view: Free ZIP etc directory viewer
  129.  
  130. AV.EXE:  Archive directory viewer.  Presents list of files in archive (ZIP, ARC,
  131. etc) and lets you sort as desired.  Also allows resetting of the file date based
  132. on the archive's contents.
  133.  
  134. SimTel/msdos/textutil/
  135. bfind501.zip    Boolean FIND command (BFIND BEGIN & END)
  136.  
  137. BFIND.EXE:  Allows Boolean-type FIND requests.  For example, find any line with
  138. one string AND another one, or any line with one string OR another.
  139.  
  140. SimTel/msdos/textutil/
  141. chang501.zip    Change strings in text files
  142.  
  143. CHANGE.EXE:  Processes change commands in files.  Files can be of any size and
  144. type (e.g.  binary or text) and are processed quickly.  Up to thirty change
  145. commands can be processed in a single pass.  Also provides ability to remove
  146. trailing spaces from text files.
  147.  
  148. SimTel/msdos/spredsht/
  149. convr505.zip    Convert dBase, ASCII-delim, fixed, 1-2-3
  150.  
  151. CONVERT.EXE and SPLITREC.EXE:  Converts between data formats:  FROM dBase,
  152. ASCII-delimited (commas between fields and quotes around strings), and fixed
  153. field TO Lotus WKS, ASCII-delimited, dBase, and fixed field.  Additional
  154. SPLITREC program is primarily intended for handling mainframe-derived data sets
  155. (which don't use CR/LF to indicate records), typically copied to the PC from a
  156. tape; splits up the logical records into physical records.
  157.  
  158. SimTel/msdos/dirutil/
  159. cops407.zip     Copies files modified since given date
  160.  
  161. COPSINCE.EXE:  Copies all files modified since a given date.  Primarily used for
  162. making sure you have a back-up of stuff and also to copy updated programs to
  163. another place.  Lets you define your own groupings of files if desired.
  164.  
  165. SimTel/msdos/batutil/
  166. dates501.zip    Warns you in advance of birthdays etc
  167.  
  168. DATES.EXE:  Program that warns you in advance when an event like a birthday,
  169. anniversary, or holiday is coming up.  The idea is to give you advance warning
  170. so you can send a card or get out of town in time.
  171.  
  172. SimTel/msdos/dirutil/
  173. dirco505.zip    Updates files based on source directory
  174.  
  175. DIRCOMP.EXE:  Similar in some ways to DOS's REPLACE command but adds ability to
  176. delete extra files in the destination subdirectory, copy hidden and system
  177. files, and prepare a report showing inconsistencies.
  178.  
  179. SimTel/msdos/dirutil/
  180. dirto505.zip    Directory lister and totaller
  181.  
  182. DIRTOTAL.EXE:  Prepares report showing files in subdirectory or drive.  Allows
  183. some restriction requests (show only files with date greater than a certain
  184. value).  Similar to Norton's FF and Ray Van Tassle's WIZ command (which is a
  185. great program but it doesn't work on network or CD-ROM discs) in some ways but
  186. presents a more formal report.  Also allows you to look for duplicate file names
  187. and search by attributes or dates.
  188.  
  189. SimTel/msdos/diskutil/
  190. fill506.zip     Stuffs as many files as possible on disk
  191.  
  192. FILL.EXE:  Program designed to move files off to floppy diskettes, taking the
  193. biggest files first and skipping those that won't fit.  Also provides option of
  194. splitting large files up, creating a status report, and other features.
  195.  
  196. SimTel/msdos/dirutil/
  197. filup503.zip    Copy updated files based on a control list
  198.  
  199. FILUPDAT.EXE:  Program which compares a selected list of files in a source path
  200. against those in another path and copies those that have been updated.  Similar
  201. to DOS' REPLACE command but works from a stored list of files and can handle any
  202. number of directories.
  203.  
  204. SimTel/msdos/textutil/
  205. fixtx407.zip    Translate text file characters en masse
  206.  
  207. FIXTEXT.EXE:  Program which applies a user-definable character-translation table
  208. to a text file.  Can allow you to convert graphics characters to their ASCII
  209. equivalents, lowercase letters to uppercase letter, etc.  Can also be used to
  210. translate DOS text files to Mac or Unix text files and vice versa.  Can also
  211. expand tabs, remove trailing spaces, and remove backspaces.
  212.  
  213. SimTel/msdos/batutil/
  214. fortn411.zip    Fine-tunes DOS FOR command w/options
  215.  
  216. FORTUNE.EXE:  A tuner-upper for the DOS FOR command.  Generates a batch file
  217. which does all those wildcard things you wished FOR could do (like "FORTUNE IN
  218. (*.BAS) DO RENAME %A %2*.*" to remove parts of file names).  Lets you do all
  219. sorts of things including distinguishing file name roots from their extensions
  220. as well as incrementing file names by specified values.
  221.  
  222. SimTel/msdos/textutil/
  223. isamf412.zip    Full-text searching help desk documents
  224.  
  225. ISAMFIND.EXE and ISAMMAKE.EXE:  Programs that work in conjunction to provide
  226. full-text searching of text files.  This is useful for helpdesk applications and
  227. other functions where you want to search for files and retrieve the "best"
  228. document that matches your search criteria.
  229.  
  230. SimTel/msdos/textutil/
  231. pagin506.zip    Paginates text (headers, indexes, sorting...)
  232.  
  233. PAGINATE.EXE:  Reformats text files with imbedded formatting codes.  Handles
  234. things like titles, footers, indexes, alignment, justification, multicolumn
  235. listings, etc.  Also provides support for imbedding tabular data in
  236. ASCII-delimited or dBase formats which can be imbedded and/or sorted in your
  237. reports.
  238.  
  239. SimTel/msdos/textutil/
  240. read506.zip     Free viewer, also make any text self-viewing
  241.  
  242. READ.EXE, READY.EXE, READINIT.EXE, and READMAKE.EXE:  Text file browser.
  243. Supports marking, copying text, reading Unix and Mac text files, etc.  READ and
  244. READMAKE only work with files of 16,000 lines or less (maybe 800,000 bytes).
  245. READY truncates any lines over 80 characters in length but handles files of an
  246. unlimited number of lines.  Includes program which takes an ASCII-text file and
  247. makes it self-viewable (using a READ clone).
  248.  
  249.  
  250. --------------------------------------------------------------------------------
  251.                             Beta-zoids...  Thanks to
  252.  
  253. Beta testers are always desired for these utilities.  You don't get a damned
  254. thing out of being one (which is about what I get for writing them) but it
  255. doesn't cost you much besides an hour or two and lets you have more of an impact
  256. on the future courses of the routines.
  257.  
  258. In order to be a beta tester, you have to be able to receive and processed large
  259. uuencoded files via e-mail (which probably precludes AOL, CompuServe, or Prodigy
  260. subscribers; sorry).  If you're interested, drop a message to me at
  261. bgu@cu.nih.gov and tell me which routine(s) you're interested in being on the
  262. list for.
  263.  
  264. Existing routines have gotten suggestions, comments, and even complements from
  265. all over the world (definitely something I *love* about the Internet).  No money
  266. of course but the ego's a powerful thing to feed!  (The flamers of course should
  267. be burned at the stake or maybe start writing their own programs instead of
  268. criticizing other people's.) Thanks to (and sorry for screwing up some of these
  269. addresses and for forgetting to put in others)...
  270.  
  271. CHANGE:         mcardleb@cosy.uml.edu
  272. CHANGE:         rainer.wuerlaender@statistik.uni-muenchen.d400.de
  273. CHANGE:         rallings@gidday@enet.dec.com
  274. CHANGE:         zazovsky@scrsul.sinet.slb.com
  275. CONVERT:        garyjohn@spk.hp.com
  276. CONVERT:        haapanen@niini.metla.fi
  277. CONVERT:        leono@uiuc.edu
  278. CONVERT:        mhenry@sunbelt.net
  279. CONVERT:        ramak@riskinc.com
  280. CONVERT:        rausch@rz.uni-frankfurt.de
  281. CONVERT:        rehmet@studserv.zdv.uni-tuebingen.de
  282. DATES:          fmaxwell@unixg.ubc.ca
  283. DATES:          hans.schrader@geol.uib.no
  284. DATES:          matt.needham@loebbs.com
  285. DATES:          paul.simmonds@jet.uk
  286. DATES:          m965952@kelso.nadn.navy.mil
  287. DIRCOMP:        mcclell@julian.uwo.ca
  288. DIRCOMP:        ornstedt@it.kth.se
  289. DIRTOTAL:       longr@qus102.qld.tne.oz.au
  290. DIRTOTAL:       saracen@cix.compulink.co.uk
  291. DIRTOTAL:       westg@rintintin.colorado.edu
  292. FILL:           beezer@cc.utah.edu
  293. FILL:           dashiell@nadc.nadc.navy.mil
  294. FILL:           doug@io.org
  295. FILL:           pstoffel@zorro.ruca.ua.ac.be
  296. FORTUNE:        thth@forsci.ualberta.ca
  297. ISAMFIND:       doug@io.org
  298. PAGINATE:       esto@loc.gov
  299. PAGINATE:       ceriosola@poltc7.polito.it
  300. READ:           ferch@cca.ubc.ca
  301. READ:           mossako@asterix.uni-muenster.de
  302.  
  303.  
  304. --------------------------------------------------------------------------------
  305.                                 Revision history
  306.  
  307. Detailed revision histories for the programs are only maintained for the last
  308. three releases.  After that, you get the major revision summaries only for the
  309. next three releases.  After that, you get almost nothing.  No one reads this
  310. junk anyway, right?  Programmer types like to put in it in just to justify what
  311. they've been doing over the last couple of years.
  312.  
  313. -------------- (full detail; revisions made 1 to 3 months ago)
  314. Release 95/06:
  315.  
  316.   All programs:  Started posting in BGUTHRIE subdirectory on ftp.cu.nih.gov.
  317.   This site may not be permanently accessible to me.
  318.  
  319.   FILL:  Added /LETTER and /-LETTER parameters.
  320.  
  321.   ISAMMAKE:  Added option of reading the first line of the file to provide the
  322.   file description.
  323.  
  324.   PAGINATE:  Added /HTML and /-HTML commands to remove imbedded HTML commands.
  325.  
  326.   READ:  Tossed in READY text-file viewer too.  Also free.  Similar to READ but
  327.   operates by rewriting the file to your hard disk.  This is a disk hog but
  328.   allows you to view files of an unlimited line count.  Truncates any lines over
  329.   80 characters in length.  You might not see this program in there in the
  330.   future but I kind of like it.
  331.  
  332. Release 95/05:
  333.  
  334.   All programs:  Removed the message about "Init file xxxx could not be found"
  335.   if the init file was the default init file.  I got tired of people saying that
  336.   the message was an error message instead of a status message.  It's still
  337.   turned off automatically if you pass in /Q or if the output is being
  338.   redirected to an output file.
  339.  
  340.   CONVERT:  Maintenance release.  Bundling with SPLITREC now.  Made a minor
  341.   change to fix errors when ASCII-delimited character fields were
  342.   null-delimited.
  343.  
  344.   DIRCOMP:  Added some error checking.  Otherwise, maintenance release.
  345.  
  346.   DIRTOTAL:  Fixed a bug with respect to SET DIRTOTAL= settings.  Otherwise,
  347.   maintenance release.
  348.  
  349.   FILL:  I didn't realize the maximum number of files in the root varied based
  350.   on the size of the diskette.  Changed that.  Also mentioned in the
  351.   documentation this time that switching diskette densities (e.g.  putting in a
  352.   1.44MB and then a 720K diskette) in the middle of a /MULTI operation can cause
  353.   problems.  Minor other changes.
  354.  
  355.   MULTICOL:  Finally dropped this one.
  356.  
  357.   PAGINATE:  Had problems with footers.  Fixed that.  Fixes for CONVERT were
  358.   incorporated.  There were problems sorting on numeric columns; fixed.
  359.   Maintenance release.
  360.  
  361.   SPLITREC:  Throw-away program for mainframe data sets, converting logical
  362.   records into physical records (ending with CR/LF).  I never intended to
  363.   release this but people started asking for it.  Bundled with the CONVERT ZIP.
  364.  
  365. -------------- (kind of terse; revisions made 4 to 6 months ago)
  366. Release 95/03:
  367.  
  368.   DIRTOTAL:  Fixed division by zero errors when using /CLUSTERS option.
  369.  
  370. Release 95/02:
  371.  
  372.   FILL:  Added support for @flistfile specification.
  373.  
  374.   READ:  Changed program so that Find brings up text about two lines before the
  375.   actual found text.  The also affects READMAKE-created files.
  376.  
  377. Release 95/01:
  378.  
  379.   All routines:  Dropped references to CONFIGWS.EXE in the documentation.  Now
  380.   accept an environmental variable as another way of setting the desired
  381.   defaults (e.g.  "SET FILL=/-I").
  382.  
  383.   CONVERT:  Now allows dBase files with memo fields to be read; the memo fields
  384.   are automatically ignored however.
  385.  
  386.   DATES:  Added the ability to include certain options within a dates input
  387.   file.  Fixed leap-year problem.
  388.  
  389.   FILL:  Added some some rudimentary error-detection (e.g.  for bad sectors).
  390.  
  391. -------------- (real terse)
  392. Release 94/12:
  393.   New:  PAGINATE.
  394.  
  395. Release 94/11:
  396.   New:  ISAMFIND/ISAMMAKE.
  397.  
  398. Release 94/06:
  399.   New:  DATES.
  400.  
  401. Release 94/02:
  402.   New:  FORTUNE.
  403.  
  404. Release 94/01:
  405.   New:  COPSINCE and FIXTEXT.
  406.  
  407. Release 93/03:
  408.   New:  AV and READINIT.
  409.  
  410. Release 93/01:
  411.   First release posted on SIMTEL (Internet).
  412.   New:  The DEMO System (shareware and not part of normal package).
  413.  
  414.