home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / f / filup302.zip / FILUPDAT.DOC < prev    next >
Text File  |  1993-02-01  |  4KB  |  105 lines
  1. FILUPDAT.DOC
  2. 02/01/93
  3.  
  4.  
  5. Introduction:
  6.  
  7. This program is designed to make updating of files and source code both easier
  8. and quicker.  It compares a list of files in a source directory to a list of
  9. files in a destination directory and copies any files that are newer than the
  10. ones found in the destination directory.  This is quicker than copying all of
  11. the files with DOS wildcard commands and cleaner than copying everything when
  12. you only want some of the files in the destination area.
  13.  
  14.  
  15. The control card file:
  16.  
  17. FILUPDAT requires an ASCII control card file to be created.  The control card
  18. file can consist of five types of records:
  19.  
  20. comments:  These records start with semi-colons or colons or are blank.  They
  21. are available primarily for documentating what you're doing.
  22.  
  23. source directory:  These records start with "-S" (or "-F" for "from") followed
  24. by the path to copy the files from.  Something like "-SC:\QB45" works fine.
  25.  
  26. destination directory:  These records start with "-D" (or "-T" for "to")
  27. followed by the path to copy the files to.  For example, "-DG:\EBBNEW\DOCS".
  28.  
  29. exclusion specification:  These records start with "-X" followed by a space and
  30. one or more filespecs (typically with wildcards).  For example, your main file
  31. specification may be "*.*" but you can exclude any QuickBASIC source code files
  32. or object modules by including a "-X *.BAS *.OBJ" statement.
  33.  
  34. files:  These records have a single file name (e.g.  "EBBFFILE.WP") that is to
  35. be copied from the source directory to the destination directory.  File
  36. specifications can include standard DOS wildcards ("*" and "?").  A comment can
  37. follow the file name provided the comment starts with a colon or a semi-colon.
  38.  
  39. Source and destination cards can be changed throughout the control card file.
  40. Files are copied based on the most recent source/destination card before the
  41. file card.  Changing either the source or destination will reset the exclusion
  42. specification so you have to respecify the -X card if desired.
  43.  
  44. Also note that cards are processed sequentially.  The exclusion specification
  45. card only affects file name card(s) which occur after it.
  46.  
  47. A sample control card file might look like this:
  48.  
  49.         ; Sample file
  50.         -SC:\PDOX
  51.         -DG:\EBBNEW\PRGS
  52.         CUSTOM.SC
  53.         ADDRESS.SC
  54.         ZIPCODE.SC
  55.         ; Specifying another source file path; destination still the same
  56.         -SC:\MINE
  57.         NEWUSER.SC
  58.  
  59.  
  60. Invoking the program:
  61.  
  62. The program accepts several parameters:
  63.  
  64.     FILUPDAT control_file
  65.       [ /Flist_file [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ] ]
  66.       [ /FULL ] [ /ALL ] [ /Q ] [ /? ]
  67.  
  68. where:
  69.  
  70. "control_card_file" is the name of the control card file.  It can include path
  71. information if necessary.
  72.  
  73. "/Flist_file" says you want a text file created which tells you what files were
  74. considered and what happened to each of them.  The "list_file" is the name of
  75. the file.  This is primarily used for checking the operation of the utility.
  76. The file name can include path information if necessary.
  77.  
  78. "/OVERWRITE" says that if the list_file already exists, don't prompt before
  79. overwriting it.
  80.  
  81. "/APPEND" says to append to the list_file if it already exists.
  82.  
  83. "/-OVERWRITE" says to abort if the output file exists already.
  84.  
  85. "/OVERASK" says to prompt if the output file exists already.  This is the
  86. default.
  87.  
  88. "/FULL" says to write out full comparison information in the list_file.  This is
  89. primarily for debugging purposes but it includes the numeric representation of
  90. the date and time for both the source and destination files.
  91.  
  92. "/ALL" says to copy all files in your control_card_file regardless of relative
  93. ages.
  94.  
  95. "/Q" turns off the file-by-file status reporting.
  96.  
  97. "/?" or "/HELP" or "HELP" gives you syntactical help.
  98.  
  99.  
  100. Program written by Bruce Guthrie.  Comments and suggestions can be sent to:
  101.  
  102.                 Bruce Guthrie
  103.                 113 Sheffield St.
  104.                 Silver Spring, MD 20910
  105.