home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 101 / af101sub.adf / DoVer.LZX / DoVer / DoVer.doc < prev    next >
Encoding:
Text File  |  1997-06-27  |  4.3 KB  |  117 lines
  1.  
  2.         $VER: DoVer V1.8 (26.06.97)
  3.               =====================
  4.  
  5. Introducing
  6.   DoVer searchs version strings ("$VER...") in files. Optional the version
  7.   string will written to the file comment.
  8.   If xfd.library is available files will unpacked before scanned.
  9.   If xfd.library is available executable files without a "$VER" will
  10.   relocated and scanned for a resident structure ($4AFC), this will find
  11.   the version of libraries, devices and handlers.
  12.   
  13.   The idea of copying the version string to the file-comment is not from me,
  14.   but from Drago Fiser's tool v2c (aminet:util/cli/v2c.lha), thanks to you !
  15.   
  16.   
  17. Requirements
  18.   Kickstart 2.0 (V37) or better
  19.   
  20.  
  21. Disclaimer
  22.   This software is subject to the "Standard Amiga FD-Software Copyright Note"
  23.   It is Freeware as defined in paragraph 4a.
  24.   For more information please read "AFD-COPYRIGHT" (Version 1 or higher).
  25.  
  26.  
  27. Installation
  28.   just copy DoVer anywhere you like (e.g. C:)
  29.   for decrunching and relocating the xfd-package must be installed
  30.   (currently aminet:util/pack/xfd115.lha)
  31.  
  32.  
  33. Using
  34.   - open a Shell and type in "DoVer <name_of_file>"
  35.     DoVer will load the file and output the version string if found
  36.   - DoVer is PURE and can made resident
  37.   - see CLI-Convention for further details
  38.  
  39.  
  40. The CLI-Convention
  41.   - Template :
  42.         DoVer   FILE/A/M,FMT/K,DEFAULT/K,FORCE/S,APPEND/S,PREPEND/S,
  43.                 QUIET/S,NOCOMM/S
  44.  
  45.         FILE/A/M        the name of the files to search in
  46.                         (you can specify multiple files !)
  47.         
  48.         FMT/K           with this you can create your own version format
  49.                         specify a format string using these special keys:
  50.                                 %n - program name (first word in $VER)
  51.                                 %v - version (second word in $VER)
  52.                                 %d - day of the datestamp (1..31)
  53.                                 %m - month as number (1..12)
  54.                                 %M - month as string (Jan..Dec)
  55.                                 %y - year as short number (0..99)
  56.                                 %Y - year as long number (1978..2077)
  57.                                 %e - extra (all after the date)
  58.                                 %% - to get a '%'
  59.                         between the "%" and the keychar you can insert an
  60.                         integer which sets the minimal length of the inserted
  61.                         field in the version string
  62.                         if the first char of the integer is a '0' the area is
  63.                         filled with '0' otherwise with ' '
  64.                         if DoVer cannot convert the $VER the format will
  65.                         ignored and the unmodified $VER is written
  66.         Examples:
  67.         orginal version string = "DoVer 1.6 (08.09.96) by B.Jahn"
  68.         FMT="%n %v (%d.%m.%y)"          -> "DoVer 1.6 (8.9.96)"
  69.         FMT="Version %v at %d.%M.%Y"    -> "Version 1.6 at 8.Sep.1996"
  70.         FMT="%5v (%02d %M%3y) %n %e"    -> "  1.6 (08 Sep 96) DoVer by B.Jahn"
  71.         
  72.         DEFAULT/K       if no version will found this is the default
  73.                         string for SetComment
  74.  
  75.         FORCE/S         overwrite exist comment
  76.         
  77.         APPEND/S        the version will appended on exist comment
  78.         
  79.         PREPEND/S       the version will inserted in front of exist comment
  80.         
  81.         QUIET/S         make no output except error messages
  82.         
  83.         NOCOMM/S        set not the comment
  84.         
  85.     the keyword SHORT is removed starting at version 1.5 use FMT/K instead
  86.     the keyword CONVERDATE is removed starting at version 1.5 use FMT/K instead
  87.     only one of FORCE,APPEND,PREPEND can specified at the same time
  88.  
  89.   - My personal use in DOpus (4.12) :
  90.     "DoVer write"
  91.         C:DoVer FMT="%5v (%2d %M %y) %n" DEFAULT="    -" FORCE QUIET {O}
  92.         (Options: "CD source" "Do all files" "Reload each file")
  93.     "DoVer show"
  94.         C:DoVer NOCOMM {O}
  95.         (Options: "CD source" "Do all files" "Output window")
  96.  
  97.  
  98. Bugs
  99.   - version strings larger than 255 chars will cut for display
  100.     the string for the comment will be cut to 79 chars
  101.  
  102.  
  103. Thanks to
  104.   Bill Boegelein, Rudolph Riedel, Tobias Haase for suggestions and comments
  105.  
  106.  
  107. Contact me for bugs, improvements, comments ...
  108.  
  109. EMail:  jah@fh-zwickau.de
  110. WWW:    http://www.fh-zwickau.de/~jah/
  111. Mail:   Bert Jahn
  112.         Franz-Liszt-Straße 16
  113.         Rudolstadt
  114.         07407
  115.         Germany
  116.  
  117.