home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / vrac / dfiles26.zip / DOFILES.DOC < prev    next >
Text File  |  1994-11-16  |  8KB  |  167 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                        Do Files
  9.           =================================================================
  10.  
  11.                This archive should contain the following files:
  12.  
  13.                DOFILES.EXE............... Actual program
  14.                DOFILES.DOC............... Documentation
  15.                FILE_ID.DIZ............... BBS description file
  16.                READ.ME................... Update information
  17.                HUCKABEY.TXT.............. Current list of James Huckabey
  18.                                           software
  19.                SOFTWARE.TXT...............Information on shareware theme
  20.                ARCHIVE.TXT............... This list of files
  21.  
  22.                Since I do a lot of file trading I found  I needed something
  23.           to do  archiving automatically for me and  more fancy than just a
  24.           batch file.  I do not like archives that contain a number of like
  25.           files, that is, ROL, MOD, GL, FLI, etc., or even archived under a
  26.           different name  than the contents. I always rearchive files using
  27.           the  same  name as  the  contents:  MUSIC.ROL becomes  MUSIC.ZIP,
  28.           WOW.FLI becomes  WOW.ZIP. I get  in hundreds of files  at a time,
  29.           some times thousands. Hence DOFILES.EXE was developed.
  30.  
  31.                The program  is nothing fancy but  it saves me a  lot of key
  32.           strokes.  It  will work  for any  file  extension except  a blank
  33.           extension. Not sure I am ever going to change this limitation and
  34.           do   not  foresee  myself  archiving  a  lot  of  files  with  no
  35.           extensions.
  36.  
  37.                Starting with v2.5 the program now turns off the "read only"
  38.           archive bit  using DOS' ATTRIB.EXE  program. I did  this because,
  39.           perhaps like  me, some people might be copying files off of a CD-
  40.           ROM disc and archiving  them to send  to others. These files  are
  41.           normally  set to  "read only."  This way  the receiver(s)  of the
  42.           file(s)  does not  get "read  only" files.  This is  to  save the
  43.           hassal of not being able to delete them, etc.
  44.  
  45.                I have just found out during the testing of v2.5 that if you
  46.           use  the DOS Copy command, at least  with DOS 6.2, that DOS turns
  47.           off the "read  only" attribute during the copy process. I have no
  48.           idea  if DOS  did this  on earlier  versions. Good  ole Microsoft
  49.           should have left the attribute bits alone.  I have always used X-
  50.           Tree  for copying files and it  does nothing with the archive bit
  51.           during the copy process.
  52.  
  53.                DoFiles can process up  to 2000 records at one time. It uses
  54.           PKZIP.EXE  (copyright PKWare) to do it's archiving and it must be
  55.           somewhere in your path. It uses  PKZIP's maximum compression when
  56.           creating the archive using the command line options "-a -ex."
  57.  
  58.                While archiving with the  following extensions a FILE-ID.DIZ
  59.           file  is generated.  It is  then added  to the  archive with  the
  60.           following contents (after the equal sign):
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                     AU  = AU (Sun) sound file
  67.                     AVI = AVI animation file
  68.                     BMP = BMP graphic image
  69.                     CMF = CMF sound file
  70.                     CUT = CUT graphic image
  71.                     DL  = DL animation file
  72.                     FLI = FLI animation file
  73.                     GIF = GIF graphic image
  74.                     GL  = GL animation file
  75.                     IMG = IMG graphic image
  76.                     JPG = JPEG animation file
  77.                     MAC = MACintosh graphic image
  78.                     MID = MIDI sound file
  79.                     MOD = MOD sound file
  80.                     MOV = MOV/QT animation file
  81.                     MPG = MPEG animation file
  82.                     MSP = MSP graphic image
  83.                     MUS = MUS sound file
  84.                     PCD = PCD (Kodak) graphic image
  85.                     PCX = PCX graphic image
  86.                     QPG = QPEG animation file
  87.                     RLE = RLE graphic image
  88.                     ROL = ROL sound file
  89.                     SND = SND sound file
  90.                     TGA = TARGA graphic image
  91.                     TIF = TIFF graphic image
  92.                     VOC = VOC sound file
  93.                     WAD = WAD game file
  94.                     WAV = WAV sound file
  95.  
  96.                If  there are any other extensions that I have missed please
  97.           contact me so I can add them to the program. I  will add new ones
  98.           as I  find them. The first  release with this new  feature has 29
  99.           file extensions. The descriptions are nothing fancy and I am sure
  100.           many sysops will appreciate  even these simple descriptions. Many
  101.           BBS programs extract the FILE_ID.DIZ  information and use it  for
  102.           the  description on  uploaded files.  I have  one in  all my  own
  103.           software  that I release to  the general public  (see the DoFiles
  104.           archive for it's copy).
  105.  
  106.                All  you have  to do  is unarchive  files or copy  them from
  107.           other  directories or diskettes,  change to that [drive]directory
  108.           and do the following:
  109.  
  110.                Syntax: DOFILES ext [destination directory]
  111.  
  112.                Where "ext"  is the  file extension  you  are working  with.
  113.           Currently  the program  only  works from  the current  directory,
  114.           which might be changed in a future release. Just easier  to do it
  115.           this way  since it reduces mistakes.  The "destination directory"
  116.           is optional and if not used the archived files are written to the
  117.           current directory.
  118.  
  119.                The  program searches  the  directory for  all "ext"  files,
  120.  
  121.  
  122.  
  123.  
  124.  
  125.           sorts the file names and then as it archives each  file it checks
  126.           the destination location for the finished archive. If the archive
  127.           exists then  and only then does it erase the original file in the
  128.           current directory. That way as it  archives a file it then erases
  129.           the unarchived file freeing up hard drive space. Besides that the
  130.           original file is  not needed if  it is archived.  You can  always
  131.           unarchive the file(s).
  132.  
  133.                DOFILES ROL D:\ROL
  134.  
  135.                This  will archive  all  the  *.ROL  files  in  the  current
  136.           directory  and write them to  D:\ROL deleting each  *.ROL file in
  137.           turn after confirmation of archive.
  138.  
  139.                DOFILES MOD
  140.  
  141.                This will archive all *.MOD  files in the current directory,
  142.           writing them to the current directory, and delete each *.MOD file
  143.           in turn after confirmation of archiving.
  144.  
  145.                As  the program  is running  it displays  the file  (record)
  146.           number  it is working on, actual  file name, and if a FILE_ID.DIZ
  147.           is generated that information is also displayed. When the program
  148.           is finished with all files it displays the start and end times to
  149.           show you how long it took. The archiving can be lengthy depending
  150.           on the  size and number  of files,  memory size, system  and hard
  151.           drive speeds.
  152.  
  153.  
  154.                                    From the Author
  155.  
  156.                I  am  not asking  for  any money  for this  program.  It is
  157.           Freeware!  If you insist on sending  me something for my time and
  158.           effort as  well as  encouragement in  writing other programs  the
  159.           contribution will not be refused and will be greatly appreciated,
  160.           but  it  is not  necessary. It  is my  hopes  that you  find this
  161.           program useful. If you have questions or suggestion please write.
  162.           If you expect a reply please include return envelope and postage.
  163.  
  164.                            James Huckabey
  165.                            3621-A Fraser Street
  166.                            Bellingham, WA 98226-2473 U.S.A.
  167.                            (206) 671-2868 (voice, Pacific)