home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / utility / archiver / unar241c / whats.new < prev   
Text File  |  1993-09-08  |  13KB  |  293 lines
  1.                                What's new?
  2.                                ~~~~~~~~~~~
  3.  
  4.     EVERYTHING !!
  5.  
  6. ---<cut here>------------------------------------------------------------------
  7.  
  8.  
  9.  
  10.                     Speed and other important issues
  11.                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  12.  
  13. Well, you can be happy, since this is definitely the FASTEST
  14. UNARJ.TTP-depacker on the ST series. (Every depacker we could locate showed
  15. ratings which differed by at least a factor 1.5 so it's advisable to
  16. kill those if you have this one.
  17. We support all regular UNARJ.TTP-options (except from Garble & Security
  18. Envelope, which neither are supported by any other tool we know of.)
  19.  
  20. If you have had the pleasure to meet our previous release (UNARJ230),
  21. you'll be very pleased to hear we are pushing that one right off the
  22. road. (Speed-factor > 5 !!!) In fact, this thing a complete rewrite which
  23. shares no code with the previous UNARJ versions which came from Insh_Allah's
  24. hand. Mr Ni! from the TOS crew has optimized the decompression routines
  25. severely; I believe we are the fastest ARJ-decompressor araound at the time
  26. of this writing...
  27.  
  28. Unfortunately the depacker has grown another 20K but I think that won't
  29. hurt all you HD-users. In exchange for this extra 20K code you have the
  30. complete manual inside the .TTP (Still there are a lot of cocksuckers
  31. that dare to copy the executables without adding the proper
  32. documentation which was supplied with the original: this way you can
  33. derive the documentation every time again and again!)
  34. If you want a smaller executable (lunatic or disk-only user) we have a
  35. Junior Version available in which we cut down on the options-palette for
  36. both German & English lunatic/disk-only users.
  37. Please note that the German version may contain even more typo's and
  38. other editorial-related bugs/errors/features than the English version,
  39. since the German language isn't our native language.
  40. (We only included it since Germans seem to suffer from a sufficient
  41. understanding of English.)
  42.  
  43. (For French people: recompile with -DLANGUAGE=FRENCH ;-))
  44.  
  45.  
  46.  
  47.  
  48.         Some crap about copyright, warez and all that sort of shit
  49.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  50.  
  51. This package (UNARJ*.*) is mind-warez (You should at least feel guilty
  52. when you don't send us a message or a postcard).
  53. Everything you do or don't is your own problem: blowing fuzes and
  54. melting Atari computers are not included in the insurrance policy.
  55. Anything else is neither. (You may praise who/what-ever you believe in
  56. when you get this to work ;-)))
  57. However we feel 'backing up your system before installing UNARJ' would
  58. be a bit overdone...
  59.  
  60. Sources for this thing are available on request: we (both Mr Ni! and
  61. myself) put in a lot of time in this product so we would appriciate any
  62. donations (needn't be money, though! Extra processing power/devices are
  63. welcomed too!) in exchange for the complete C/ASM-source release.
  64. (Just write us a note when you're interested)
  65.  
  66.  
  67.  
  68.                         Future developments
  69.                         ~~~~~~~~~~~~~~~~~~~
  70.  
  71. At the moment our biggest problem is the reverse-engineering of the
  72. various UNARJ.TTP compression modes. We only have access to some C-source for
  73. the depacker as distributed by Robert K Jung, however there's a good
  74. chance of implementing Mode 4 (FAST) compression anyway. (Scheduled for
  75. Dec. 1993) Huffman additions (Mode 1-3) will have to wait a little while
  76. for us to get the inspiration to do it... At the moment we can't say
  77. anything more about expacted compression speed & ratio's so you'll have
  78. to wait for that release (which would develop quite a bit faster if we
  79. could get our hands on some C/ASM/Pascal(?! yuck!) source. (If you have
  80. a UNARJ.TTP-archiver-source written in APL or any other language we would be
  81. happy to learn the language anyway ;-)))
  82.  
  83. This is a Alpha-release since we haven't had the time to check all
  84. options extensively. Besides, we like to keep this a non-final version
  85. until it can be distributed with our ARJ241α.
  86. If you  find anything which doesn't match our documentation,
  87. please notify us through our contact addresses or support BBS in The
  88. Netherlands (MBH BBS, for telephone number see the end of the document);
  89. we will try to fix any problems a.s.a.p.
  90.  
  91.  
  92.  
  93. This distribution is dedicated to:
  94.  
  95.  
  96.             ALL VIRGINAL HARDDISKS OUT THERE
  97.  
  98.      (unarj x -~xd \*.UNARJ.TTP    was made for you, my dear!)
  99.  
  100.  
  101.  
  102.  
  103.                      Redirection issues
  104.                      ~~~~~~~~~~~~~~~~~~
  105.  
  106. If you peeked at the commandline options, you'd sure seen the
  107. 'redirection' text there: many people start to tremble when they see
  108. this: Will my marv' shell be put out of bizz?!
  109. No!
  110. If you run a shell or anything that takes over redirection (by parsing
  111. our commanline first!) we won't see the redirection commands given, thus
  112. allowing the system to have it it's own way.
  113. you should however note the fact that we don't differentiate between
  114. STDOUT and STDERR in that case! (Well.... hm.... we do write STDOUT to
  115. GEMDOS handle 1 (stdout) while STDERR is sent to GEMDOS handle -1
  116. (non-redirectable (they say ;-)) stdout)
  117. This is not so much a bug introduced by us a it is a system-wide
  118. problem: TOS hasn't ever had a seperate stderr channel as has UNIX. So
  119. the risk is high you will redirect both out STDOUT *and* STDERR messages
  120. when redirecting.
  121. Here are the 'undocumented features (now documented ;-))' that touch the
  122. redirection issue:
  123. * STDOUT and STDERR will most probably not be recognized as seperate
  124.   output streams when redirecting.
  125. * Keypress requests and all that sort of shit is NOT (repeat: NOT!)
  126.   suppressed when the system takes over redirection: we don't have a
  127.   method included (yet) to recognize external redirection. Therefore you
  128.   should use the appropriate command-options to disable every possible
  129.   request done by UNARJ.TTP
  130. * Redirection used with TOS-versions before 1.4 could very well fail.
  131.   (As it would with other toolz)
  132.  
  133. If you use UNARJ's internal redirection routines however, there's a
  134. difference between STDOUT and STDERR. Also we will message you about the
  135. fact that output is redirected: most novice users get the shivers when
  136. they don't see screen-output for more than five minutes...
  137. If redirection attempts fail, you will be told about that fact too!
  138.  
  139. 4DOS users will have noticed we use the 4DOS way of redirecting STDERR
  140. ('>&') instead of the UNIX way ('2>'). If you don't like it: don't use
  141. it.
  142.  
  143.                             Environment
  144.                             ~~~~~~~~~~~
  145.  
  146. UNARJ.TTP will first look for an environment variable named ARJ_SW and
  147. use its value as switch options for UNARJ.TTP.
  148.  
  149. You can inhibit UNARJ.TTP from using this environment variable by using
  150. the "-+" option.  You can also set the name of the environment
  151. variable with the "-+" option as in
  152.   UNARJ.TTP x -+ARJCFG archive
  153.  
  154. Use some environment editing/setting tool to create an environment on
  155. your Atari. (Most shells could use some script-file or seperate command
  156. to do it...)
  157.   SET ARJ_SW=<switches>
  158.  
  159. Example:
  160.   SET ARJ_SW=-~arj- -jy+ -~k -e -v+ -~acv
  161.  
  162. Do NOT add any blanks after the variable name ARJ_SW.  As in LHARC,
  163. command line switches can be selected to override ARJ_SW settings.
  164.  
  165. UNARJ.TTP will allow you to use a different switch character "-" or "/"
  166. in ARJ_SW and in the command line.
  167.  
  168. If the ARJ_SW environment variable specifies a filename (text not
  169. beginning with a switch character), UNARJ.TTP will open that filename and
  170. scan it looking for a line of text that begins in column 1 with the
  171. same letter as the UNARJ.TTP command being executed.  The following text
  172. is processed as the ARJ_SW switches.  This allows each UNARJ.TTP command
  173. to have its own switch settings.  In addition, UNARJ.TTP will also look
  174. for the "+" (plus) symbol in column 1 to use as a miscellaneous
  175. switch string.  This string will be added to any command switch
  176. string found if any.  If no command switch string is found, UNARJ.TTP
  177. will use the miscellaneous switch string as the ARJ_SW switch
  178. settings.  NOTE that the "+" switch settings will NOT be used
  179. if the "+" string occurs below the command switch string.
  180. Please note that we included the <-~ac> ('Assume Command') option for
  181. this '+' line specially! This way you are able to specify default
  182. behaviour af UNARJ (even when in complete ARJ compatibility mode
  183. (<-~arj>))
  184.  
  185. SET ARJ_SW=C:\UNARJ\UNARJ.CFG
  186.  
  187. C:\UNARJ\UNARJ.CFG contains:
  188. a -jm1 -ja -i1
  189. c -zcomment.txt
  190. + -~v1
  191. l -jp
  192. e -i1
  193.  
  194. AND is equivalent to:
  195. a -jm1 -ja -i1
  196. c -zcomment.txt
  197. l -jp -~v1
  198. e -i1 -~v1
  199. f -~v1
  200. v -~v1
  201. all other commands
  202. .
  203. .
  204. .
  205.  
  206. In the above example, any UNARJ.TTP "l" commands will use "-jp -~v1"
  207. as the ARJ_SW switch options.
  208. Please note you can list ARJ commands here (so use your PC ARJ.CFG
  209. setup!) but those lines will be skipped by UNARJ.TTP!
  210.  
  211. The ARJ_SW variable or the ARJ_SW configuration file switch
  212. settings may *have* quoted switches such as "-vasformat a:". This is
  213. opposite to the ARJ.EXE conditions.
  214.                      
  215.  
  216.  
  217.                          Commandline usage
  218.                          ~~~~~~~~~~~~~~~~~
  219.  
  220. The only thing that has been and will be a constant factor for
  221. UNARJxxx.TTP from th authors Insh_Allah/Mr Ni! is the ARGV & xArg
  222. support.
  223.  
  224. Anybody using TeraDesk (from W. Klaren of the TOS-Crew) or TOS 2.xx or
  225. above can install UNARJ.TTP with an option list. (Install Application)
  226. Be sure to change this if it was previously set up for UNARJ230 or older
  227. versions, since our commandline options have changed significantly.
  228.  
  229. As a bonus, an ICON (ICON.RSC, ICON.H) is included in this distribution
  230. for use with the TeringDesk ICON.RSC file: use some RSC-editor to include
  231. this icon in your collection.
  232. When you want this tool to depack your UNARJ.TTP archives to a sepearate
  233. directory each, you could specify
  234.   x -rayv+ %f h:\unarjed\%f\
  235. as the 'Install application' commandline. Please note the trailing
  236. backslash '%f\' or UNARJ won't recognize %f to be a sepearate subdir.
  237. (resulting in beksmash)
  238. (TeraDesk puts the UNARJ.TTP archivename at the %f location!)
  239. *THIS IS AN IMPORTANT CHANGE* from previous versions!
  240.  
  241. For those among you that learned to live with the absolutely weird
  242. options contained in UNARJ210/220/230 there's yet another major change:
  243. from today we will be UNARJ.TTP.EXE (from R.K. Jung) compatible at all levels.
  244. However there are some discrepancies here:
  245. * added options for ST users. (-~___ shifted switch options)
  246. * toggle-behaviour of UNARJ.TTP.EXE is NOT emulated to the extend of toggling
  247.   by multiple occurences of (Example:) -ja command-options.
  248.   We do support -ja-/-ja+ toggling, but <-ja -ja> will NOT reset the
  249.   <-ja> option flags as UNARJ.TTP.EXE would do, since <-ja> is treated equal
  250.   to <-ja+> inside UNARJ241.TTP.
  251. * very strict checking when using multiple volumes: UNARJ.TTP.eXE only checks
  252.   the time-stamp and verifies the file-size (which *should* *be* *large*
  253.   *enough*) where UNARJ241.TTP does the same, except it will issue a
  254.   warning when the existing part of a multiple-volume file is found to
  255.   be larger than requested.
  256.   This habit is better in most circumstances (as we view it) but fails
  257.   when multiple volumes were created by UNARJ.TTP.EXE using TEXT-mode (<-t1>,
  258.   <-t1f>, <-t1g>): UNARJ.TTP.EXE switches back to binary mode  for the second
  259.   part of the split-vol file while keeping the file-offset *value*.
  260.   (for technical oriented people: UNARJ.TTP.EXE uses stdio/stdlib fwrite() and
  261.   fseek() which will behave different for TEXT & BINARY mode:
  262.   file-offsets differ!)
  263. * directory-recognition is a bit worse: directories MUST be terminated
  264.   by a \ to be recognized as such: this alpha-release does not yet contain
  265.   code to check if the specified path ends with a directory- or filename.
  266.   This is true for both .UNARJ.TTP-sourcespecification and basedir-spec.
  267.  
  268. -<cut here>--------------------------------------------------------------------
  269.  
  270. We hope you like this new UNARJ package for its speed and its
  271. versatility. Furthermore we hope to have ARJ (ST) ready for you a.s.a.p.
  272. Meanwhile; have phun using UNARJ241α for Atari ST/e/TT/Falcon.
  273.  
  274.  
  275.  
  276. Standard options and commands are checked and no bugs were found on:
  277. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  278.  
  279. Atari ST (TOS 1.4) (1MB / 2.5MB / 4MB)
  280. Atari ST (Kaos TOS 1.4.2) (1MB / 2.5 MB / 4 MB)
  281. Atari TT (TOS 3.0x) (2 MB)
  282. Atari TT (Mint/MultiTOS) (2 MB)
  283. Atari Falcon (TOS 4.0x) (4 MB)
  284. Atari Falcon (Mint/MultiTOS) (4 MB)
  285.  
  286.  
  287. With special thanx to the TOS-crew (Insh_Allah & Mr Ni!(the Great))
  288. Thank you for using the ATARI ST-version of UNARJ 2.41α (rev. I_A/Ni! 1.01α) 
  289. converted by M()ir Brandts Honk/Insh_Allah/Mr Ni!(the Great) (created @ Aug 31 
  290. 1993 2:51:42).
  291. For more info call MBH @ +31-70-3457929 / +31-70-3461215
  292.  
  293.