home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / PROJUP.ZIP / PROJUP.DOC < prev    next >
Text File  |  1991-03-24  |  3KB  |  67 lines
  1. ProjectUpdate v1.10 Documentation
  2.  
  3. ProjectUpdate updates a source and target directories so that all of the
  4. target directory files are synchronized with the source directory. The list
  5. of files on the target directory are found and compared with the
  6. corresponding files on the source directory.  If no source file exist the
  7. target file is "fetched" to the source directory.  If the target file is
  8. newer the source file is "replaced".  If the source file is newer the target
  9. file is "replaced".
  10.  
  11.  
  12. - Command Line Options -
  13.  
  14. If no options are specified the Environment variable PROJUP is used to supply
  15. the options. The default options "/S*.* /Ta:\" are also used.
  16.  
  17.   -s  source path (don't include file name) <defaults to "*.*">
  18.   -t  target path (file name with wild cards only) <defaults to a:\>
  19.   -a  don't ask before updating source.
  20.   -u  don't update the source directory
  21.   -c  don't copy files that are on target but not on source
  22.   -r  don't update target.
  23.   -b  beep when done
  24.   -v  visualize the process only, don't actually copying anything
  25.   -d  don't show date time of changed file
  26.   -e  use environment options with these options, environment has precedence
  27.   -j  journal file, create journal file of copies <defaults to projup.jnl>
  28.   -n  journal file, append to journal file
  29.   -f  journal fetches not allowed
  30.   -l  display License
  31.   -h  display help
  32.  
  33.   example : projup /j/cb /Ta:\projup
  34.  
  35.  
  36. - Target Directory Options -
  37.  
  38. Because most projects are managed with a version control system,
  39. ProjectUpdate supplies some features that simplify managing files in a
  40. project that are not logged.  Normally .obj, .exe, .lib and other files are
  41. not logged in with the version control system since there is no point in
  42. managing changes to these files.  However, it is often useful to store these
  43. files on the file server so that each programmer does not need to rebuild
  44. them.
  45.  
  46. One way to deal with this problem is to have ProjectUpdate manage these
  47. files.  The following example shows a batch file that manages updating a
  48. small project.
  49.  
  50. -----------------------------------------------------
  51.  
  52. projup /J/EA  /S\ver.%ver%\source1 /Td:\ver.%ver%\source1\*.obj,*.res,*.exe 
  53. projup /N/EAR /S\ver.%ver%\source1 /Td:\ver.%ver%\source1
  54. projup /N/EA  /S\ver.%ver%\source2 /Td:\ver.%ver%\source2\*.obj,*.res,*.exe 
  55. projup /N/EAR /S\ver.%ver%\source2 /Td:\ver.%ver%\source2
  56.  
  57. type ProjUp.jnl | more
  58.  
  59. -----------------------------------------------------
  60.  
  61. The preceding example would copy built-up files to the target (probably a
  62. network drive) and bring down any source or built-up files that are newer than
  63. those on the source directory.  It would also produce a journal file that is
  64. displayed at the end that lists what happened.  An added benefit of this
  65. process is the list of files that can't be copied to the target, but probably
  66. should be "put" with the version control program.
  67.