home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / arj2_262.exe / arj / README.TXT < prev   
Text File  |  1999-01-09  |  14KB  |  296 lines
  1.  
  2.    ARJ for OS/2 version 2.62 Release Notes                January, 9, 1999
  3.  
  4.  
  5.    This product is an  OS/2-hosted add-on for  ARJ 2.6x for DOS. It may be
  6.    used  separately  from  the DOS  package  but  it doesn't  contain  the
  7.    documentation and utility files found in DOS release.
  8.  
  9.    ***********************************************************************
  10.    ***                                                                 ***
  11.    ***  THIS PRODUCT IS DEVELOPED  SEPARATELY FROM THE MAINSTREAM ARJ  ***
  12.    ***  PACKAGE AND  THEREFORE IS NOT  UPDATED SYNCHRONOUSLY WITH ARJ  ***
  13.    ***  FOR DOS. SHAREWARE REGISTRATION FOR  ARJ/2 IS NOT PROVIDED BY  ***
  14.    ***  ARJ SOFTWARE, INC.                                             ***
  15.    ***                                                                 ***
  16.    ***********************************************************************
  17.  
  18.  
  19.    LEGAL NOTICE
  20.  
  21.       Since this  is a beta version, no warranties of any kind are made.
  22.       In no event should  ARJ Software Russia  be liable for  any damage
  23.       resulting from use or misuse of this product.
  24.  
  25.       You have a royalty-free  right to  distribute ARJ/2 package in any
  26.       form. Commercial  use of  this product  must be  approved  by  ARJ
  27.       Software, Inc.
  28.  
  29.       The information in this document is  a subject  to change  without
  30.       notice.
  31.  
  32.  
  33.    INTRODUCTION
  34.  
  35.       As the OS/2 lacks a multifunctional compression utility, a version
  36.       of ARJ for  OS/2 has  been  developed  by ARJ Software Russia. The
  37.       aim  of  the  porting  was   to   retain  the   functionality  and
  38.       compatibility with ARJ for DOS but  several exceptions occur. They
  39.       are covered later in this document.
  40.  
  41.  
  42.    SYSTEM REQUIREMENTS
  43.  
  44.       *  OS/2 version 1.2 or higher, or Windows NT v 3.10 or higher.
  45.    For OS/2 systems:
  46.       *  A 80286 or higher CPU.
  47.       *  512K of memory is needed for operation.
  48.    For WinNT systems:
  49.       *  1024K of memory is needed for operation.
  50.  
  51.  
  52.    DIFFERENCES WITH THE DOS VERSION
  53.  
  54.       ("-" indicates a missing feature, "*" - a different operation and
  55.        "+" stands for a feature unique to ARJ/2)
  56.  
  57.       -  The "-$" option (volume label handling) is disabled. You still
  58.          can process any archives  which contain  volume labels but you
  59.          can't set or query a volume label for a drive.
  60.  
  61.       -  The "+<var>" option  has  no  effect  under OS/2. To  conserve
  62.          memory, we  pass  only  the  COMPSEC  and  ARJ_SW  environment
  63.          variables to ARJ functions.
  64.  
  65.       -  We've been experiencing problems with porting ARJSFXV 2.62. In
  66.          this  package, version 2.61.6 of  ARJSFXV/2 is  included (this
  67.          means you'll  not be  able  to retrieve  files with  retaining
  68.          DTA/DTC properties by running ARJSFXV executables although you
  69.          still can use ARJ to extract them retaining the properties).
  70.  
  71.       -  The   GOST  28147-89   encryption  procedure,  provided   with
  72.          ARJCRYPT.COM utility, is not  available in  OS/2  version. You
  73.          can use "-hg!" option under OS/2, however.
  74.  
  75.       -  Spaces in long filename specifications on the command line are
  76.          not permitted.
  77.  
  78.       *  ANSI pictures in comments are  shown 80 columns  wide. This is
  79.          mainly for compatibility reasons, as many of OS/2 users prefer
  80.          video  modes other  than 80x25, while DOS  usually stays in 80
  81.          columns.
  82.  
  83.       *  ARJ/2  sets  the  "Host OS"  to  "OS/2" (or  "WinNT")  on  its
  84.          archives. When  extracting any such  archive with ARJ for DOS,
  85.          some unusual behavior may occur. Versions of ARJ prior to 2.50
  86.          convert high-ASCII characters in filenames to 7-bit characters
  87.          by ignoring the  high  bit. So, the  filename "▒TEST▒" will be
  88.          converted to "1TEST1" on  extraction. ARJ/DOS also strips high
  89.          bit from archive comments, but only if the archive was created
  90.          by ARJ/2. Archives  created  with ARJ/DOS  and  then processed
  91.          under OS/2 are not affected.
  92.  
  93.       *  ARJ/2 uses the  default OS/2 error  handler that will normally
  94.          display pop-up menus  prompting  for action. The -&  option is
  95.          not  effective in ARJ/2. Moreover, the  ampersand character is
  96.          used  in OS/2 to start  two  processes  consequently, so  this
  97.          switch will actually split the command line.
  98.  
  99.       *  ARJSFX and  ARJSFXJR archives  will display  ANSI sequences if
  100.          the ANSI support is enabled in the  current OS/2 session (it's
  101.          enabled by default in OS/2).
  102.  
  103.       *  There's a bug in ARJ/DOS v 2.61/2.62: if an "ARJ M" command is
  104.          entered, and no files are added, a temporary  file remains. It
  105.          seems to have been fixed in ARJ/2 v 2.61.12 and ARJ/2 v 2.62.
  106.  
  107.       +  The new "-h2d" option  will force the stamping  of "MS-DOS" as
  108.          host  operating system for  the archives created by  ARJ/2. It
  109.          may be  used  for  compatibility, to  avoid "binary file  from
  110.          another OS" warnings.
  111.  
  112.       +  "-h2p<n>" can  be  used  to set  the  priority  of  ARJ/2. The
  113.          knowledge  of OS/2 scheduling system  is required to  use this
  114.          option. It can dramatically increase performance but slow down
  115.          other processes. The <n> can be equal to 1, 2, 3 or 4:
  116.  
  117.           1 = idle-time priority
  118.           2 = regular priority
  119.           3 = time-critical priority
  120.           4 = fixed-high priority
  121.  
  122.          Priority  delta  values  are not  supported.  We  don't see  a
  123.          strong requirement for them.
  124.  
  125.       +  The "-h2a"  option  is implemented  in ARJ/2 due  to a popular
  126.          demand from  FidoNet system  operators. Basically it acts like
  127.          "-jo",  with  the  exception  that  file  names, and  not  the
  128.          extensions, are  "serialized". Consider  having a  file called
  129.          "FILE995N.TXT" and an archive that contains the  same file. If
  130.          extracted with the "-h2a"  option, the file will be written to
  131.          to "FILE9950.TXT", if  you extract it  again, it'll be  called
  132.          "FILE9951.TXT",  and   so   on  up   to  "FILE9959.TXT",  then
  133.          "FILE9960.TXT". And after "FILE9999.TXT" ARJ/2 will start with
  134.          "FIL00000.TXT". This option allows you to extract  one file to
  135.          100000000 unique  names.  It's  essential to  system operators
  136.          since multiple mail packets with the same  name may  come from
  137.          different systems.
  138.  
  139.          NOTES:
  140.            1. It'll be wise to include  this option in the  script that
  141.               unpacks the ARCmail packets and NOT in ARJ_SW environment
  142.               variable. This option is a  security measure  for systems
  143.               running in unattended mode, and will  only confuse you if
  144.               enabled by default.
  145.            2. There's a security hole: a file  called "9999.XXX" or so,
  146.               will not be  overwritten. However, all  subsequent writes
  147.               will be  redirected into  file "0000.XXX". So, files with
  148.               9s in the beginning have less chances of being preserved.
  149.               Hopefully such situation is unlikely for FidoNet systems.
  150.            3. ARJ/2 v 2.62 has  a similar  option, "-jo1", to serialize
  151.               filenames, however its operation is different. The volume
  152.               must support long filenames in order to use  this option,
  153.               moreover,  it's  not  suitable for  dealing with  FidoNet
  154.               ARCmail.
  155.  
  156.       +  ARJ/2 has  no  shareware volume  size  limitation  for ARJSFXV
  157.          archives, because the self-extractor itself consumes a  lot of
  158.          disk space.
  159.  
  160.       +  ARJSFXJR does  not  support  long filenames  under Win95  DOS.
  161.          ARJSFXJR in ARJ/2 supports OS/2 long filenames.
  162.  
  163.  
  164.    KNOWN PROBLEMS
  165.  
  166.       *  ARJ 2.62 archives have a malformed header. This is the problem
  167.          of ARJ/DOS v 2.62  and ARJ32 v 3.00 alpha, since both  of them
  168.          introduce  new header  format (revision 9) and, unfortunately,
  169.          they incorrectly create the  headers. The archives are safe to
  170.          process with ARJ  but you  may lose the  header comments. Many
  171.          utilities  that process  ARJ archives will  incorrectly handle
  172.          ARJ/2 v 2.62 archives because of the new header format and the
  173.          bugs (FileCommander/2 v 2.10a is known to behave incorrectly).
  174.          Use the "-j$" option to disable handling of DTA/DTC properties
  175.          (we recommend  ARJ/2  2.61 for those  who  don't need  DTA/DTC
  176.          handling).
  177.  
  178.       *  ARJ/2 refuses to process archives accessed via NFS.
  179.  
  180.       *  The high bit is stripped from the comments of archives created
  181.          under  Windows NT. A  simple workaround  is to  use the "-h2d"
  182.          option.
  183.  
  184.       *  Microsoft OS/2 v 1.21 may  be errorneously identified as WinNT
  185.          under certain  circumstances. It  affects the stamping  of the
  186.          "Host OS" descriptor  and  results in  the  problem  described
  187.          above.
  188.  
  189.       *  ANSI comments may be incorrectly displayed in ARJ/2 v 2.62.
  190.  
  191.       *  On FAT volumes under Windows NT, both long filenames and short
  192.          filenames may be used. If you refer to a long filename  with a
  193.          short filename (for example, type "ARJ a lntest LONGFI~1.TXT),
  194.          the short filename will be stored as entered from console. So,
  195.          no LFN equivalent is placed  into the  archive, and if  a file
  196.          with a  similar long  filename exists in the  archive, it will
  197.          not be replaced.
  198.  
  199.  
  200.    FREQUENTLY ASKED QUESTIONS
  201.  
  202.       Q: Does ARJ/2 support EAs?
  203.       A: No. You'll need to split  EAs from the  source files with  the
  204.          EAUTIL program and then rejoin them.
  205.  
  206.       Q: Why ARJ/2 is a 16-bit executable?
  207.       A: There are several reasons for it. First, the  Huffman encoding
  208.          is written in pure 8086 assembler. That's why ARJ 2.x is  many
  209.          times faster than ARJ 1.x, and ARJ32 is quite slow compared to
  210.          ARJ/2. Second, OS/2 16-bit binaries do NOT run in VDMs and are
  211.          actually as fast and reliable as 32-bit ones. So-called 16->32
  212.          thunks are called when OS/2 API is accessed but it's misery -
  213.          ARJ/2 does  Huffman encoding  most of the time, not  involving
  214.          any kind of external API.
  215.  
  216.       Q: Will you release a 32-bit version of ARJ/2 some day?
  217.       A: When ARJ32 will replace ARJ/DOS as a mainstream product, we'll
  218.          port   it   to   OS/2   to  give   the   same   functionality.
  219.          However, 16-bit versions will be favored until that moment.
  220.  
  221.       Q: What is ARJLX?
  222.       A: It's  the  same  program  as  ARJ/2,  compressed  with  LXLITE
  223.          utility. It requires  OS/2  v 3.0 or  higher to  run. You  may
  224.          encounter some compatibility problems with  it (it's unable to
  225.          register ARJLX with REGISTER.EXE, and so on...)
  226.  
  227.       Q: How can I create an installer for my OS/2 product with ARJ?
  228.       A: ARJSFX/2 is able to run OS/2 commands after unpacking archive.
  229.          Try this: create a script you want to to be  invoked after the
  230.          installation completes.
  231.  
  232.          e.g., INSTALL2.CMD:
  233.          =======
  234.           /* REXX */
  235.  
  236.           if RxFuncQuery('SysLoadFuncs') then do
  237.            call RxFuncAdd 'SysLoadFuncs', 'RexxUtil', 'SysLoadFuncs'
  238.            call SysLoadFuncs
  239.           end
  240.  
  241.           say "Installation has completed, creating desktop object..."
  242.           call SysCreateObject ....
  243.          ========
  244.          and so on...
  245.  
  246.          Now create an archive comment with the first line as follows:
  247.          )) \InstallDir\ -b -x -y -!INSTALL2.CMD
  248.  
  249.          Call it, for example, CMT.ANS. Now create an ARJSFX archive:
  250.  
  251.          ARJ a PACKAGE.EXE -je -r -a -jm -zCMT.ANS -xCMT.ANS -j$
  252.  
  253.          The -j$ switch  is essential  because the  header comments are
  254.          mishandled otherwise.
  255.  
  256.          You'll  get a  self-extracting archive  with an  automatically
  257.          invoked installation program.
  258.  
  259.          Note that 5-second  delay that occurs  when the self-extractor
  260.          starts is  specific to shareware  version of ARJ. You may  not
  261.          commercially distribute these packages.
  262.  
  263.  
  264.    PRODUCT INFORMATION
  265.  
  266.       ARJ/2 has been developed by ARJ Software Russia with  the most of
  267.       original ARJ code left intact. It has been briefly tested on OS/2
  268.       v 2.0, 2.1,  3.0 and 4.0, and  Microsoft  Windows NT  Workstation
  269.       v 3.51.
  270.  
  271.       The ARJ/2 development team:
  272.  
  273.                       Programmed  by  Andrew Belov
  274.                     Testing lead  by  Viatcheslav Odintsov
  275.  
  276.       Source code is not available for public use.
  277.  
  278.  
  279.    REVISION HISTORY
  280.  
  281.       (only general availability versions are listed)
  282.  
  283.       2.61.10   21/11/1998   Initial release.
  284.       2.61.11   26/11/1998   ARJ/2 2.61.10 would cause exception 0Dh if
  285.                              ARJ$DISP is killed from the task list. The
  286.                              "clear screen" ANSI sequence now works.
  287.       2.61.13   13/12/1998   "ARJ M" fixup, decreased the size of EXEs,
  288.                              ARJ/2 now also works under Windows NT.
  289.       2.61.14   31/12/1998   Minor fixes. It is the last build of ARJ/2
  290.                              v 2.61.
  291.       2.62.02   09/01/1999   G.A. version. Minor fixes  in the  message
  292.                              section. ARJSFX  now properly supports the
  293.                              "-!" option.
  294.  
  295.       End of document
  296.