home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 6 / AACD06.ISO / AACD / System / Resources / VersCheck2 / Doku / NewInThisVersion < prev    next >
Text File  |  1999-12-15  |  11KB  |  266 lines
  1. New in this Version: (V 2.19 / 15.12.1999)
  2. ==========================================
  3. (at the end you find info's about printout's and special's ( *-> ) 
  4.  
  5.  
  6.  
  7. New version identification:
  8. ---------------------------
  9. The search for version numbers work's now nearly perfect. Based on a
  10. new idea I rewrite the search and analyse of the $VER-string.
  11. This new function is faster and find such versions, they are not found
  12. bevor. Only in one reason, the search failed: If the version is not
  13. numeric or has a VERSION.REVISION as MINIMUM! More ok, shorter: NO!
  14. I know only TWO file where this is so. In one is the version 1.L (what
  15. causes much problems in c:version!). The second is a library with
  16. the version V1. Great! Check it with c:version and this program don't
  17. know, what cat it do. So it do VERSION name FULL or simple: It cry's
  18. for help!
  19. What do, if such libs found?
  20. MOVE to STORAGE to check out with program such library use. Often, the
  21. program dosn't exist anymore or is updated and don't use this lib in the
  22. actual version. If you can be 100% shure that don't need this library,
  23. delete and bann them from your system. If you find put that the library
  24. is in use, inform the author of the library, to correct the resident tag
  25. and the $VER: to a correct format. Inform also the author of the application
  26. that use this library that he needs a library what isn't systemconform, and,
  27. e.g. do not correct work in systems with WB2.0. In future it is possible that
  28. new systems for Amiga and cloned systems also make problems with such
  29. header's.
  30. I ignore such single problems now for a faster and better function.
  31.  
  32.  
  33.  
  34. Statistic requester:
  35. --------------------
  36. Based of an idea, reached per eMail, from Michael Malyshev
  37. <michael_malyshev@mail.ru>, the compare has now a little statistic.
  38. The special is, at the end of a scan you see a comment, added by
  39. VersCheck. I hope, you have enough black humor for that.With -# can
  40. be used do deactivate the function. Default is set by environment or ON!
  41. More info's about this function? Check it out!
  42. P.S.: The requester is at the moment only in german or english!
  43.  
  44.  
  45.  
  46. Locale (.catalog's):
  47. --------------------
  48. Because the new function uses new catalog's, I've checkt all old function
  49. part's and put also older, forgotten text to the locale.
  50.  
  51.  
  52.  
  53. Environment:
  54. ------------
  55. Looking in ENV:VCheck you will find many little files. This are:
  56.  
  57. - VersIM1, VersIM2, VersIM3, VersIM4, VersDoc and VersDir:
  58.   This is the installer setup from last install as default at next update.
  59.  
  60. - VersCom
  61.   (default inside: VERSION). Needs to change name or path for external
  62.   version command. PLEASE DON'T USE VERSIONWB because this will force
  63.   problems in the CheckGuides!
  64.  
  65. - VersCOL
  66.   includes 16(+) line. Any line is the Ansi-setup for a output line from
  67.   verscheck. Discription below.
  68.  
  69. - The new default setup for the requester in VersCheck V2.19 (default is
  70.   NOT(!) compatible to older version):
  71.  
  72.   - VersIFS = info requester
  73.               0 = OFF
  74.               1 = ON  is the default
  75.               Argument '-!' toggle
  76.   - VersSTR = NO statistic requester
  77.               1 = no request
  78.               0 = show this requester is the default
  79.               Argument '-#' toggle
  80.   - VersNRQ = NO requester
  81.               1 = no requester
  82.               0 = requester allowed is the default
  83.               Argument '-n' toggle
  84.   - VersHTM = html request return value
  85.               0 = no output
  86.               1 = create update forms is the default
  87.               Argument '-o' toggle
  88.   You can use this to change the default but the switches work's
  89.   than reverse! Be carefull. This is, what I mean with toggle:
  90.   If ENV: set to ON the argument set it to OFF.
  91.   If ENV: set to OFF the argument set it to ON.
  92.   And if the argument used more times, it goes ON/OFF.
  93.   The Argument DON'T change the ENV:
  94.  
  95.  
  96.  
  97. ANSI output (de-)activate and usage:
  98. ------------------------------------
  99. Long time ago, I begin the work an a little styling function. The
  100. functions are now useable and I have finished the work. No big help
  101. or doc (see AmigaDOS documentation for ansi, line discription here).
  102. All lines can now displayed negativ, highlighted, colored, big or in many other ways. Used is
  103. ANSI. Ansi exists in the DOS-CLI/-Shell. At this time you can only
  104. set the values at the begin of line, all other is hardcoded in
  105. VersCheck.
  106.  
  107. *** YOU MUST KNOW, HOW ANSI WORK! *** For insiders: **************
  108. CSI and m are fixed, value inserted from simple config file
  109. 'Env:VCheck/VersCOL'. You can set all value's that allowed between
  110. esc[ and m. Also from 0 upto 9 (attributes), 30 upto 37 foreground
  111. and 40 upto 47 for the background. Combination like 0;3;45 are
  112. accepted.
  113. ******************************************************************
  114.  
  115. You find a demo in configuration in the archive of this version.
  116. Deactivate: Simply remove the config file from ENV: and/or ENVARC:
  117. About the config: Useable with 4 color's and regulary WB color
  118. setting for the first four colors. If you are using a CLI with 8 or
  119. more colors you can use more colors.
  120. WARNING! This function takes, whatever in the file set. No check or
  121. such things. If you write bad strings, the function takes it and
  122. ansi will display it, but this forces broken or unreadable output.
  123. Second problem: If you set foreground and background to same values
  124. you will see nothing!
  125.  
  126. == LINES IN THE FILE: ==============================================
  127. ====================================================================
  128. Line  | descryption (without warranty):
  129. ------+-------------------------------------------------------------
  130.   1   | all line without setting, like ths --- line between the files
  131.   2   | version new: "file unknown in list"
  132.   3   | version ok
  133.   4   | version new (but in the list!)
  134.   5   | version old
  135.   6   | version line "problem with version"
  136.       |              (what to do: kill the file or the author or send
  137.       |               him a copy of the Rom Kernal Manual to read them)
  138.   7   | fileinformation and filename
  139.   8   | version line "VersCheck"
  140.   9   | version line "c:version"
  141.  10   | version line "list"
  142.  11   | system information (kickstart/workbench)
  143.  12   | output of a warn/xxx file
  144.  13   | help text if using -?
  145.  14   | error messages at program start
  146.  15   | LISTMODE: directory header
  147.  16   | filename in verbose, path see 19 (-v) 
  148.  17   | cli output of requester "you find the results in ram"
  149.  18   | system information (cpu/fpu/mmu/ppc)
  150.  19   | fullpath (-f) without filename! The name is print later
  151.       | and set with line 16 (because this function print add name!
  152.  
  153.  
  154.  
  155. Requester now ASL:
  156. ------------------
  157. The problem with the requesters from the older versions are fixed
  158. and the asl requester activated. ReqTools is not longer needed or
  159. used!
  160. WARNING for GERMAN! UPDATE the locale catalog files or you will see
  161. all new text in english!
  162.  
  163.  
  164.  
  165. Goodies:
  166. --------
  167. Check_Your_System changed to work correct with the ENV: settings.
  168.  
  169.  
  170.  
  171. Install script:
  172. ---------------
  173. After install V2.19 the system should be reboot or a program like
  174. FLUSHLIBS must be used to clear the old catalog files from memory.
  175. Of cource, if you have not started VersCheck bevor you make the
  176. new installation, this isn't need!
  177.  
  178. The script was changed for multiple things:
  179. - In the past ENV: was not updated, only envarc: so that after an
  180.   update the system has to reboot for correct environment. Now both
  181.   area's are updated.
  182.  
  183. - Add new information at the begin and the end of the installer script,
  184.   e.g., version and date.
  185.  
  186. - Change and add installing of the documents, because they are renamed
  187.   and new files added.
  188.  
  189.  
  190.  
  191. Bugfix: (memory fault):
  192. -----------------------
  193. Bugfix: Since using the new ppc-library-emulation the library check causes
  194. an error: 0 bytes allocated and after them max int bytes allocated.
  195. Then VersCheck crashes. I detect the library who forces this crash and
  196. locked in the binary for $VER:, to see what happens here.
  197. The problem: "$VER:<NULL>" gives a empty env-variable and this, read with
  198. getenv from vbcc crashes! Fixed. Now the function looking bevor read how
  199. many bytes the env count's. Read now only, if a minimum of 3 bytes are
  200. in the env.var!
  201. The new ppc.emu [ppc.library 46.21 (12.12.99) Emulation v0.7 by
  202. Frank Wille <frank@phoenix.owl.de>] found an other problem. If checking
  203. an elf.-file it isn't need to test the resident tag of m68k. But, even
  204. this was done in the past. Normally the function returns with a NOT FOUND
  205. and end's. But now a svppc driver exists who has the code for the resident
  206. tag without such a tag (in m68k is this forbidden, but this is a elf-PPC
  207. executable with totally other code). Result: MEMORY FAULT. Problem found
  208. and fixed.
  209.  
  210.  
  211.  
  212. Bad code cleared:
  213. -----------------
  214. The variable ENV:VCheck/VersCOM has read any time bevor the version was
  215. checked with the external program (c:version). This isn't need and now
  216. the variable is read at program start. This make the program faster and
  217. that is the better way to do it.
  218. I can't remember, why I programmed this so in the past. I think, I've
  219. only not realised that this is an multiple read.
  220.  
  221.  
  222. ^^^^^^^^^^^^^^^^^^^^^
  223. ^^^^ END OF NEWS ^^^^
  224. ^^^^             ^^^^
  225. ^^^^^^^^^^^^^^^^^^^^^
  226.  
  227. Additional information to the output: 
  228. ======================================================================
  229. === What will VersCheck say, if it display special things like *-> ===
  230. ======================================================================
  231.  
  232. 1.) Printline "VersCheck" , field "Name"
  233.     VersCheck prints a name like 'hello.library   hello'
  234.     This isn't a special, this is best view you can get! If you see
  235.     this, the resident tag is filled 100% correct in both alpha num
  236.     fields. Because this is in must library's NOT so, I take first the
  237.     field NAME and then the field VERSION and cat both strings to one.
  238.     Only, if both strings are correct filled the result like above can
  239.     displayed.
  240.  
  241. 2.) Line "VersCheck" and line "c:version" show different versions. And
  242.     at the resultline (old,new,ok) is a * at the beginning bevor ->
  243.     This mean's 'CAUTION!', the $VER: and the resident tag have
  244.     differnt versions. A function in VersCheck try to analyse this and
  245.     give the best result, VersCheck can find. In simple form's: both
  246.     version older as the list: must be older. Both newer as list, must
  247.     be newer. And so on. The full function is complexer but VersCheck
  248.     can so printing a hopefully right result. To say you, it can be a
  249.     wrong result the * is set to this lines. Normally a * isn't a char
  250.     in a directory or filename (ok, you can create such files, but this
  251.     brings only trouble). If you take the AllXXXX file and search
  252.     inside for a * you find all critical entry's and not more or less.
  253.  
  254. 3.) The line "VersCheck" or the line "c:version" is not displayed.
  255.     The line VersCheck" is normally every time displayed, but both have
  256.     the same reason: The function to find $VER: (or in VersCheck the
  257.     additional resident tag) are failed and so the entry is empty. And
  258.     this empty entry isn't displayed.
  259.     If both lines not displayed, the file seem's to be corrupt or is
  260.     very bad coded.
  261.     Check such files with a program that can expand packed files. This
  262.     can also be a reason, but then is the auto entpacking not working!
  263.     The check take CheckX from Aminet or every newer anti virus program
  264.     you like. They all can decrypt. For SAVE the decrypt file, I know
  265.     only CheckX has this function at the moment.
  266.