home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / email / nfile13c.zip / NEWFILES.DOC < prev    next >
Text File  |  1993-11-06  |  6KB  |  141 lines
  1. NEWFILES    v1.3C
  2. (c) Copyright Keith Treichel Aug 11, 1992
  3. *Modifications (C)Copyright Oct-31-1993 Geoffrey Liu
  4. *Lines that begin with an * is my (Geoffrey Liu) addition to NEWFILES
  5. *1.3 documentations.
  6.  
  7. ■■■ FIRST THINGS FIRST ■■■
  8.  
  9. This is my first contribution to the world of FREE/SHAREWARE. If you use
  10. this program at all, I would like to hear from you, just to give me an
  11. indication of how far these programs are distributed and how many people
  12. would use them. (C'mon folks, I have only received two messages from you. All
  13. I want is 'Hi, I'm using it, Keith!')
  14.  
  15. *Since Keith is not a member of CRS anymore, sent a message to me,
  16. *Geoffrey Liu, and I'll sent them to Keith.
  17.  
  18. Any suggestions or criticisms (hopefully constructive) would be appreciated
  19. as well.
  20.  
  21. ■■■ INTRODUCTION ■■■
  22.  
  23. I always download the list of new files with my QWK mail packet.
  24. Unfortunately, it is never just the list of new files that were uploaded
  25. since the last time I downloaded my mail. The file always contains many
  26. files that I have already read about in a previous packet. Wading through
  27. the list of files is a strenuous task at best. Many times it is over a
  28. thousand lines long!
  29.  
  30. NEWFILES is a small utility that takes two files as input. The first is a
  31. new NEWFILES.DAT pkunziped from your latest mail packet, and an old
  32. NEWFILES.DAT pkunziped from your previous mail packet.
  33.  
  34. When you run NEWFILES on these two files, you get a listing of the files
  35. that are unique in your latest download, ie. all the files that are found
  36. in the old newfiles.dat are deleted from the listing.
  37.  
  38. ■■■ RUNNING THE PROGRAM ■■■
  39.  
  40. Here is a quick summary of how to use this program.
  41.  
  42.     1. PKUNZIP your latest CRS.QWK file and save the NEWFILES.DAT
  43.        file as a unique name (NEWFILE.NEW comes to mind).
  44.  
  45.     2. Ditto for your previous QWK packet. Mine is always called
  46.        CRS1.QWK. Save its NEWFILES.DAT as, say, NEWFILES.OLD.
  47.  
  48.     3. Enter the command...
  49.             nfiles newfiles.new newfiles.out > x.x
  50.  
  51.     4. Now you can examine x.x for the list of new files uploaded to
  52.        the bulletin board since the last time you downloaded some mail.
  53.  
  54.  
  55. Included in this package is NEW.BAT, which will do all of the above for you
  56. automatically. It ASSUMES you have a \JUNK\NEW and \JUNK\OLD directory on
  57. your hard drive, and that NFILES.EXE is available somewhere in your PATH
  58. statement. It also ASSUMES that your QWK mail packets are located in a
  59. directory called \DOWN. (I wrote this BAT file for my own machine. You can
  60. edit it to match your own setup.)
  61.  
  62. Give NEW.BAT two parameters, the new QWK and the old QWK, e.g.
  63.         new  crs.qwk  crs1.qwk
  64.  
  65. ■■■ INCLUDED IN THIS PACKAGE ■■■
  66.  
  67.         NEW.BAT        - Batch file to do all the unpacking of your QWK
  68.                          files. You will have to edit this to match the
  69.                          directories you want to use on your system.
  70.         NEWFILES.DOC   - You are reading it!
  71.         NFILES.EXE     - The program itself. Put it in a directory that is
  72.                          found in your DOS PATH statement. (I put mine in
  73.                          C:\APPS.)
  74. *                        OR put it in your reader directory
  75. *       NFILE386.EXE   - This is the 386 version of NEWFILES, there is
  76. *                        no difference in operation, except an
  77. *                        improvement in speed. Only run this if you have a
  78. *                        386 or better. If you are using this version,
  79. *                        rename it to NFILES.EXE or substitute NFILE386
  80. *                        into the NEW.BAT.
  81.  
  82. ■■■ Last Words ■■■
  83.  
  84. This started off as a quick and dirty utility. It took me all of one hour
  85. to write it. Since then I have tidied things up a bit, fixed the
  86. statistical display, and reduced the memory requirements. If you find any
  87. bugs with the program, please tell me about them. I grab mail from CRS
  88. (Mississauga) almost every day, so just leave me a message in the Main
  89. Board or IBM section. If this program has found it way to Timbuktu, then
  90. talk to me via InterNet at 'keith.treichel@canrem.com'
  91.  
  92. *As I've said before, Keith is not a member of CRS anymore, so you can leave
  93. *mail to me (Geoffrey Liu) on CRS main board, NAnet IBM conf,
  94. * Fido NETMAIL 1:229/15, RIME ->CRS, and using the internet,
  95. * geoffrey.liu@canrem.com
  96.  
  97. ■■■ LEGAL STUFF ■■■
  98.  
  99. Sorry, I gotta say it, but...
  100.  
  101. NEWFILES is being distributed as Freeware. Feel free to make copies of it
  102. and distribute it, so long as no fee is charged for the program itself.
  103. NEWFILES is copyrighted material and may not be modified in any way, shape,
  104. or form, without the authors' consent.
  105.  
  106. DISCLAIMER:
  107. UNDER NO CIRCUMSTANCES SHALL THE AUTHORS BE RESPONSIBLE FOR ANY DIRECT OR
  108. INDIRECT DAMAGE DUE TO USE OF THIS PROGRAM.  NO WARRANTIES, EITHER
  109. EXPRESSED OR IMPLIED, ARE GIVEN.
  110.  
  111. ■■■ MOD HISTORY ■■■
  112.  
  113.     v1.0    20Mar92 Initial release.
  114.  
  115.     v1.1    01Apr92 Check for malloc added.
  116.                     Improved check for valid file names in NEWFILES.DAT
  117.                     Added "# of duplicates found."
  118.  
  119.     v1.2    28Apr92 Reduced memory requirements by not reading the OLD file
  120.                     into memory.
  121.                     Uploaded, since the 1.1 upload didn't work anyway!
  122.  
  123.     v1.3    11Aug92 Fixed up the EXIT statements so they return ERRORLEVEL 0
  124.                     if everything is OK, ERRORLEVEL 1 if something went
  125.                     wrong. (An error message goes to STDOUT if there was a
  126.                     problem.) Thanks to Jan Nolan of Montreal for pointing
  127.                     this problem out to me!
  128.  
  129.     v1.3a    2Feb93 Modifications complete by Geoffrey Liu of Unionville.
  130.                     Now works with Deluxe2 1.25 Newfiles downloader.
  131.                     Maximum # of files at about 1200.
  132.  
  133.     v1.3b   31Oct93 Maintance release by Geoffrey Liu. Recompiled and
  134.                     optimized for faster speed and now have 386 version.
  135.                     386 version has about a 20% increase in speed over 1.3a
  136.  
  137.     v1.3c    6Nov93 David Sandbrook pointed out that neither version
  138.                     works on his 286. After investigation, one of the modules
  139.                     was compiled for 386, and only the main module was for
  140.                     8086. Now fixed.
  141.