doc/test/subwcrev2.txt

   1 SubWCRev  -  A Working Copy Status Tool for Git\r
   2 ------------------------------------------------------\r
   3 \r
   4 SubWCRev is Windows console program which can be used to read the status\r
   5 of a Git working copy and optionally perform keyword substitution\r
   6 in a template file.\r
   7 \r
   8 usage: SubWCRev WorkingCopyPath [SrcVersionFile] [DstVersionFile] [-n|-d]\r
   9 \r
  10 Params:\r
  11 WorkingCopyPath    :   path to a Git working copy\r
  12 SrcVersionFile     :   path to a template header file\r
  13 DstVersionFile     :   path to where to save the resulting header file\r
  14 -n                 :   if given, then SubWCRev will error if the working\r
  15                        copy contains local modifications\r
  16 -d                 :   if given, then SubWCRev will only do its job if\r
  17                        DstVersionFile does not exist\r
  18 \r
  19 \r
  20 SubWCRev reads the Git status of all files in a working copy, excluding\r
  21 externals. It records the highest revision number found, and the commit\r
  22 timestamp of that revision, and also whether there are local modifications in\r
  23 the working copy. The revision number and mod status are displayed on stdout.\r
  24 \r
  25 If a source and destination files are supplied, SubWCRev copies source\r
  26 to destination, performing keyword substitution as follows:\r
  27 \r
  28 $WCREV$ is replaced with the highest version number in the working copy.\r
  29 \r
  30 $WCDATE$ is replaced with the commit date/time of that revision in\r
  31 international format, ie. yyyy-mm-dd hh:mm:ss\r
  32 \r
  33 $WCMODS?TrueText:FalseText$ is replaced with TrueText if there are\r
  34 local modifications, or FalseText if not.\r
  35 \r
  36 $WCURL$ is replaced with the repository URL of the working copy path\r
  37 passed to SubWCRev.\r
  38 \r
  39 Finally, an optional switch may be added to abort SubWCRev if certain\r
  40 conditions are not met.\r
  41 \r
  42 The -d switch causes SubWCRev to abort with ERRORLEVEL 8 if the destination\r
  43 file already exists.\r
  44 \r
  45 -------------------------------------------------------------------------------\r
  46 SubWCRev was written by Stefan Küng for the TortoiseGit project.\r
  47 Visit our website at http://TortoiseGit.tigris.org\r
  48 -------------------------------------------------------------------------------\r
  49 \r