                                 Help on ARI,
                             Archiver by RAO Inc,
          World Champion Since 1994  In The Art, Sport And Science Of
                (real-time  most popular PC format  lossless)
                              Data Compression

                    (among programs using base 640k only)

                        version 1.13v from 19-08-1996


         Contents:                                                       line

 1. Most Important Details                                                 37

 2. Commands                                                               80
      1a. Adding files to archive       (A,M,U,F,O)                        85
      1b. Extracting files from archive (E,X,T,S,W)                       109
      1c. Modifying files in archive    (D,G,R)                           132
      1d. Listing files in archive      (L,V,N)                           146

 3. Options                                                               162
     2a. For All commands                              (20 options)       162
     2b. For Adding,Extracting,Modifying commands only (G,K,L,HB,HK)      238
     2c. For Adding and Extracting commands only       (D,O,I,J,HU,HC,HO) 257
     2d. For Adding commands only                     (P,M,C,T,Z,E,HN,HL) 315
     2e. For Extracting commands only                  (!,HP,M0)          351

 4. Frequently Asked Questions                                            365

 5. Distribution Policy                                                   506





ͻ
 1a. Usage:  
ͼ
      ARI <command> [-<option1> ...  -<optionN>] <archive_name>[.ARI]
          [<-ulist_name>|<path_name>|<wild_name>...] [-x[path_name][wild_name]]

        <a|b> means you HAVE to use one or more of the choises.
        [a] means you can but don't have to use this parameter.

     Spaces after options with no parameters can be skipped: -c-t-l-hk-bd-e256.
     Upper/lower case doesn't make difference except when in password or string
     to search for by command W.

  1b. Main defaults:
           Save path information in archive       (no -I)
           Don't save drive and root information  (no -HF)
           Prompt before overwriting output files (-Oq)
           Use maximum compression                (-m5)
           Assign binary file type                (-h1)
     * Sorry, but in this demonstration version You can't change to text file
     * type (technically: from "sliding" dictionary to "finite once created").

  1c. User prompt responses (enter first symbol):
           Yes     - yes
           No      - no
           Always  - always assume yes for current type of query
           Skip    - always assume no for current type of query
           Global  - always assume yes for all queries
           Quit    - abort out of ARI

  1d. Recommended options for everyday usage: -m3-hk-bD
      Configuration when packing better than existing archivers: -m2,even -m1.

   WARNING: ARI doesn't copy archive to new disk place every time and therefore
   doesn't keep temp archive on error (no -hk by default)
   NOTE: to join archives to archive- DOS command: COPY/B Archive+archive1+...

   MAIN: copressing/decompressing routines are BUG FREE! since 1994.

                All trademarks/registered names acknowledged.



ͻ
 2. Commands 
ͼ

Command       Meaning                          Example

 A   Add specified files to archive         ARI A myarchiv myfil*.*
     (A -oq-d01  gives the same result)

 M   (A -oq-d)   Move files to archive      ARI M arcnam file1 file2
     add specified files, deleting          moves two files to ARCNAM
     after each successfully added file

 U   (A -on-d01)   Update files in archive  ARI U archname dirname\
     add those of specified files, which    updates ARCHNAME with
     are older or don't exist in archive    files from specified directory

 F   (A -o0n-d01) Freshen files in archive  ARI F myprogs *.pas
     add those of specified files, which
     are older in specified archive

 O   Optimize specified files to archive    ARI O myarchiv
     (O -oq-d01)
    To enhance compression if specified files were added with switches
    -c and/or -t a/o -m.   The same result if these files exist on disk or not.

Possible options for Adding commands: see options in groups 3a,3b,3c,3d.



 E   (E -oq-d01)  Extract specified files   ARI E tu *.exe dir\name1 name.*
     from SPECIFIED archive's directories   extracts *.exe and NAME.* from TU's
     to same DOS directories                default directory, NAME1 from DIR\

 X   (E -r-s-oq-d01) eXtract specified      ARI X tpascal *.exe
     files from ALL archive's directories   to extract all *.exe files
     to same DOS directories                from archive TPASCAL

 T   (T -i-o-d01) Test specified files      ARI T borlandc \bin\*.exe \doc\
     in specified archive's directories

 S   (S -i-o-d01)  Sample specified files   ARI s bc *.me \doc\*.me
     from specified archive's directories
     to screen  with pauses

 W   (W -i-o-d01)  Sample lines containing  ARI w bc *.me \doc\*.me uninstall
     specified string from specified files
     to screen  with pauses                 ARI w bc *.me \doc\*.me " install "

Possible options for Extracting commands: see options in groups 3a,3b,3c,3e.



 D   Delete specified files                 ARI d 24dirs \doc\ tmp\
     from specified archive's directories   deletes two directories from 24DIRS

 G   Garble specified files                 ARI g -g9393036 24dirs my*.* \work\
     in specified archive's directories

 R   Remove paths from specified files      ARI r 24dirs \tmp\
     move specified files from specified
     archive's directories to default

Possible options for Modifying commands: see options in groups 3a,3b.



 L   (L -hf) List specified files           ARI L 24dirs *.bas tmp\*.tmp
     in specified archive's directories

 V   (L -r-s-hf) View specified files       ARI V allHD windows\
     in all archive's directories           to list files in directory WINDOWS\
                                            and all subdirectories
 N   (N -hf) reName specified files
     in specified archive's directories     ARI N progs *.bas

Possible options for Listing commands: see options in group 3a.





ͻ
 3a. Options for All commands (begin to work before ListFile is created) 
ͼ
 ha<path> assign bAse directory name        ARI a -ha\work\ b:z *.pas *.bak
          change DOS default directory      ARI x \o\deleteme -i-ha\tmp\
          till the end of the work          extracts all files to \tmp\

 hw<path> assign Work directory             ARI a -hw\tmp\ qbasic
          were ARI's tempfiles are created

 hs<NS>   don't put firSt NS of specified   ARI a -s-ht999 CCC c:\
          files to listfile but ignore them

 ht<NT>   puT only NT of specified files    ARI a -s-hs999-ht999 CCC \
          to listfile                       ARI V -ht46 CCC

 u<file>  Use list name file                ARI e 24dirs -u4me.lst
          from WORK directory (DOS default  uses 4ME.LST from default directory
          directory until no -hw<path>      ARI e 24dirs -hw\me\ -u4nc -hw\tmp\
          in ARI_SW or command line)        to use \ME\4NC as list file

 f<file>  generate list name File           ARI a -s-o01-flistc nul \
          in WORK directory (DOS default
          directory until no -hw<path>      ARI a -+-s-o01-hw\users\ -flstc n \
          in ARI_SW or command line)        generates LSTC in \users\

 x<file>  eXclude specified file            ARI a -s driveD d:\ -xd:\tmp\
              this option works only if     ARI a aaa d:path\name -x-uxcl
              at the END of command line    excludes files specified in XCL

 v[?][<Length>]  enable multiple Volumes    ARI a -v?1450k b:\work\mywork
     v?    to prompt between volumes        creates 1450 kilobytes volumes
     v999k to build 999 kilobytes volumes

 r[x]  Recurse subdirectories under base    ARI a -r mains *.bas d:bc\*.c
       -rx turns off -r (Adding commands)   add *.C from D:BC\ only, *.BAS from
                                            default directory & subdirectories
       If file's name doesn't contain path,
       file will be taken from default
       directory and all subdirectories

 s[x]  recurse subdirectories under         ARI t -s progs1 text\*.txt *.c
       Specified                            test *.C in default directory only,
       -sx turns off -s (Adding commands)   *.TXT in TEXT\ and subdirectories
       If file's name contains path,
       file will be taken from specified
       directory and its subdirectories

 a   allow Any archive extension            ARI v -a multiwrk.a01

 b@  create temp files on drive @           ARI a -bd mids *.mid

 +   inhibit ARI_SW usage                   ARI a -+-r-bd drivec
     this option works only if it is
     BEFORE <archive_name> in command line

 w<h,s,r,&>  exclude hidden/system/readonly ARI m -wh db b:
                    files/volume label      exclude hidden files from listfile
       -w*x disables -w for all further     ARI v -w&x diskB13
       filenames/wildnames                  view all files and volume label

 q   don't exclude doubled files from list  ARI v -q -w&x myarc
     file (to View and reName after Remove) to view all files existing in MYARC

 n   don't print path with fileName         ARI x -n 12dirs

 -   disable option character               ARI m rare d: \bc\*.c -s -- -music\

 y   accept single keY when quering         ARI m -y pict -s c:\pic\ -sx d:wrk\

 hy  assume Yes on all queries              ARI x -v-hy drivec

 hf  store/use Full specified drive and     ARI a -hf usr c:\users\ d:\users\
     default directory information


Ŀ
 3b. Options for Adding, Extracting and Modifying commands only 

 g<password>  assign password               ARI m astlogos -s-gSilneeVetvej! a\
      upper/lower case makes difference!
      first space symbol " " ends password

 k   Keep original .ARI file date           ARI x -o01 -dq -k work *.bak
     as it was before modifying this time

 l   set .ARI date to the Latest file       ARI m -oq -l saves *.pas
     of all existing in archive

 hb  keep a .Bak of ARI archive             ARI u -r -hb progs *.bas

 hk  Keep temp archive on error             ARI d -r wind *.bak *.tmp
     (keep a .bak and delete it on exit)


Ŀ
 3c. Options for Adding and Extracting commands only 

 o   Overwrite destination file (DF)        ARI x -o DriveD
     by the source file (SF) always         extract,never query for overwriting
 o0 skip if DF doesn't exist                ARI a -o1 -d1 ma2 *.pas
 o1      if DF exists                       move only not-existing in MA2 files
 oO skip if DF is Older than SF             ARI X -on august \win\
 oN         DF is same or Newer than SF     update files in directory \win\
 oT skip if DF is not the same Time         ARI A -r-oa letsdoit l*.*
 oA            is the sAme date and time    add only new, older or newer files
 oS skip if DF is Shorter than SF           ARI A -r-o0l tres *.bas
 oL               same or Longer than SF    add files which are shorter in TRES
 oD skip if DF has Different size
 oE               the samE size with SF
 oR skip if SF is oldeR than SpecDate (SD)  ARI m -s-ow dskc \
 oW               same or neWer than SD     move older-than-today files to DSKC
 oI skip if SF is not the same tIme as SD   ARI A -s-oimq DiskC \
 oM            is the saMe date and time    add only todays files after quering
 oH skip if SF is sHorter than SpecLEN (SL) ARI x -oh archname
 oG               same or lonGer than SL    extract files only longer than 10k
 oF skip if SF has diFFerent size than SL   ARI x -oz@13k 12dirs
 oZ               the same siZe as SL       extract skiping files with size 13k
 o!<Sdate> assign SpecifiedDate, default is
          today, format is YYMMDDHHMMSS
 o@<Slength> assign SpecifiedLength,        ARI a -or!930101000000 from93on d:\
             default is 10k (10240 bytes)   add files newer than 01.01.1993
 o*q query in case *

 d   Delete source file always              ARI e -d deleteme *.doc
     syntax to skip deleting is             moves specified files from archive
     the same as with "o" option
 d!  gives the same result as o!            ARI E -d0n -o0n A:atAlice
 d@  gives the same result as o@            freshen files in default directory

 i   Ignore directory structure             ARI x -i name.ari
     in destination directory               extracts whole archive NAME
                                            to DOS default directory
                                            ARI A -i -s use us\
                                            puts all files from US\ and subdirs
                                            to default directory of archive USE

 j<h,s,r,&>  mask specified files           ARI m -r-jhsr doit
             in destination directory       moves files turning hidden, system
                                            and read-only attributes off
                                            ARI e -d-jhsr drivec *.sys

 hu<file(s)> use specified file(s) as       ARI e -huARI-DOCE.DIC deleteme *.me
             dictionary                     use file ARI-DOCE.DIC as dictionary

 ho  use previous files as dictionary       ARI a -+-ho-hu1 myDocs *.txt
     (work with SOLID archive)

 hc<WordSize> change word size              ARI e -hc63k ari-113v tm-hc63k.bmp
     may enhance compression up to 10 times
     include changed WordSize in comments!


Ŀ
 3d. Options for Adding commands only 

 p   don't show Progress indicator          ARI o -r-p bc
     -nnnK, nnn = how many kilobytes done

 m<0...5>  set compression Method           ARI a -z bases *.bas
     0-store ... 5-maximal,default
         For some files -m1 may result in
        no compression ratio loose, though
          working up to 10 times faster!

 c   Compress but don't optimize            ARI m -c bases *.bas
     slightly less compression,
     up to 2 times less time

 t[<P1>]  seT division size=P1              ARI u -c-t8 bases *.bas
       63 by default, less than 63 means
       less time, slightly less compression

 z[<P2>]  set main siZe=P2                  ARI a -y-hk-c-t8-z2 bases *.bas
       5 by default, less than 5 means
       less time, less compression

 e[<P3>]  sEt dictionary size=P3            ARI a -c-t8-z2-e99 docs *.doc *.wri
       64k by default, less than 64k means
       less time, slightly less compression

  hn<N> skip first N bytes in each file     ARI a -hn1024k-m0 all \

  hl[N] take only N bytes from each file    ARI a -s-hl! windir \Windows\
  hl!  store original file length           store only filenames, dates
       This helps you to control the        and lengths in archive WINDIR
      changes made on any disk or directory
      without any comression

Ŀ
 3e. Options for Extracting commands only 

 !  don't beep on error                     ARI x -!-o-bd disk3

 hp<PS>  assign page size=<PS> lines        ARI s -hp48 boris *.txt
       for commands S,W only, default is 23

 m0 extract comressed files "as is",        ARI x -m0 wopeuiq tourani.dll
    without decompression. Ignore CRC error




ͻ
 4. Frequently asked questions 
ͼ

  4.1  "Why should I use ARI.EXE instead of popular existing archivers?"

       This question generally has a slightly other form:
       "Why should I use ancient second-sort programs that are unable
       to compress as good as ARI does? Due to their popularity?
       Hundreds of options or high speed with low intellect?"

       Use ARI to gain better compression  (from 1% to 50%, 5% as a rule,
       in comparison with the best of all other archiver's achievements).
       Thus You'll save at least 5% of money You spend on data storage
       and transmitting.

  4.2. "What should I do if I am not satisfied with the compressing speed?"

       1st way (quickest, easiest and cheapest): Use  Windows 95!
               Make it (compressing) a background process, as You do with
               music, network, etc.: "Run and forget till it is finished".
       2nd way (most encouraged, maybe cheapest, though not the quickest):
               Subscribe to all software by RAO Inc. and get latest versions
               of ARI.EXE, ARI!FAST.EXE and all other software not later
               than in a month after Your letter with check is received.
       3rd, universal for such problems:
               get a better PC, the main things are faster CPU and hard disk.
               (don't forget that sometimes this can be enhanced by BIOS Setup)

  4.3. "What should I do after message 'Free memory too small.' ?"

       Run MEMMAKER to correct.
       If You are an Experienced Software User (or don't have this DOS utility)
       try to lessen number of resident programs in lower memory by Your own
       (maybe, You'll have to correct CONFIG.SYS and AUTOEXEC.BAT)
       as ARI v1.13v requires approximately 540K while adding files, 348K while
       extracting, 96K for viewing or modifying (or storing/restoring).

  4.4. "Why? Can't I even view more than one archive while one ARI running ?"

     Yes, this is the 15th limitation in ARI v1.13v demonstration version.
     The other 14 are: no 2 commands, no 8 options, options o,d,hu,ho not full.
                            ** 01.96: and no full-screen interactive interface!


  4.5. "What do options  c,t,z,e,hc  do with  m0...m5 ?"

       "-m0"    means    store files
       "-m1" is equal to "-c-t4-z0-e4" or simply "-c-t-z-e"
       "-m2" is equal to "-c-t-z1-e22"
       "-m3" is equal to "-c-t-z2-e66"
       "-m4" is equal to "-t-z2-e222"
       "-m5" is equal to "-t63-z5-e65535"  and equal to  "no -c,-t,-e,-z".
     -hc<NewWS> - You'd better don't use it, though You may once configure all
     five options for best results with Your most typical files, if You wish.

     So, "-m2-e222" is equal to "-c-t-z1-e222",but "-e222-m2" is equal to "-m2"


  4.6. "Why do I see message 'Nothing to do!' after 'ARI L archname' ?"

       You may see this after 'ARI t archname' or 'ARI e archname' or any other
       extracting,viewing or modifying command, though the archive is not empty

       Because in ARI's archive the directory structure is exactly like in DOS:
       there's a default directory, a root directory,subdirectories under root:
       [<drive>:]\path\  and subdirectories under the default: [<drive>:]path\.
       For example, DOS command "dir work\*.*" is not equal to "dir \work\*.*".

       So,as You can get message "0 files found" after DOS command "dir",though
       the disk is not empty, the same happens after command "ARI l archname".
       The default directory is empty, while the archive is not empty.
        "ARI t -r archname"    will test all files in ARCHNAME;
        "ARI t archname \win\"   will test files in directory \win\ only;
        "ARI t -s archname \win\"  will test files in \win\ and subdirectories;


  4.7. "Why are files *.bak added after command 'ARI a archname -x*.bak' ?"

       You think this command is equal to "Ari a archname *.* -x*.bak"?
       NO, it is equal to                 "Ari a archname -x*.bak *.*".
       As it was mentioned before, option "-x" works only if it is at the end.


  4.8. "Why are files *.bak added after command 'ARI a archname \I\ -x*.bak' ?"

       Probably, You meant 'ARI a archname \I\ -x\I\*.bak' ?


  4.9. "Why problems after 'ARI e archname -ha\dirname\ filename' ?"

       In this case, You must specify the archive location's directory:
       ARI e path\archname -ha\dirname\ filename
       as (see line 165) option -ha changes DOS default directory till the end
       of the work.


  4.10."Why 'Can't find file 4c.lis' after 'ARI a arcname -hu\dirname\4c.lis'?"

       Because (see line 178) listfile is taken from ARI's WORK directory
       (DOS default directory until no -hw<path> in ARI_SW or command line).
       The same with option -f.


  4.11. "Why 'Can't open 2048 as source' after 'ari a -c2048 qq w\*.c' ?"

       Maybe, You meant 'ARI a -Hc2048 qq w\*.c' ?
       Spaces after options with no parameters can be skipped: -c-t-l-hk-bd-z3
       This is valid for the last space between last option and <archive_name>:
       for example, 'ari a -hkArchname w\.c' .


  4.12. "Why  * * * * * * * ?"   (any other question)

       Version 1.13v  is an OLD silly slow
       (CPU i8086/8088 and MS-DOS 1.00)-compatible demonstration version.
       Probably, invalid command line or strange DOS version (PC-DOS,VR-DOS?..)


  4.13. Where can I get more special dictionaries?

       TO SUBSCRIBE to all software by RAO Inc.
       (including special dictionaries,  Ari-DM.exe - Dictionary Maker utility,
       latest ARI.exe versions supporting 80386 or higher CPU and working twice
       faster, ARI!fast.exe -compressing  as '-m3' though up to 3 times faster,
                            ** 01.96: with full-screen interactive interface!
       all software and manuals translated to Your native language)

       REMIT 19 USD or more to  account 890-0059-982 with Bank of New York, USA
       for account 3800170500758 with Moscow Saving Bank Kievskoe 5278, RUSSIA,

       SEND check with Your post or E-mail address with any words to:
       RAO Inc., A1216, MSU, Moscow, RUSSIA.

       For technical or any other support contact by E-mail:
                                                ras@okibox.iae.nsk.su
                                                khamenya@module.vympel.msk.ru
       All help is free till 01.01.2001.



ͻ
 5. Distribution Policy 
ͼ
         Nobody will never be obliged to pay for this peace of real Art.
             Though...
         We hope that You'd sooner pay for Real Programmer's Art than for
         megabytes of never used data.
         Only 19 USD for ALL software if You subscribe before 01.01.1997.
         Hope You don't forget about it in December 1996!

[End of file ARI-113V.TXT]
