BSA command modifiers

-v  - Volume splitting (bsn)

     This switch makes it possible to split the archive into a number of
different diskettes, e.g.:

a -v100K    - volume size up to 100K
a -v360000  - volume size up to 360000 bytes
a -vf       - each volume will occupy the whole free space on a disk
              (diskette)

     Archives cannot be modified in multivolume mode.

-b   - block mode (bsn)

     All files specified in the switch are regarded as a single file and are
packed by a single block. If the file sizes are not large, it permits to
decrease the archive size (sometimes significantly). The archive thus
created can be used only in "read only" mode. If you keep it in mind, you
can do with files whatever you like: you can extract any file, verify it,
look though its contents. At the extraction operation all files in the
archive will be verified.

     Multivolume archives cannot function in block mode.  You can only
create archive this way, but not freshen it or update.

Examples:
1. bsa a -b src *.[ch]

     This command creates archive in block mode src.bsn and adds to it files
with extension *.c and *.h from the current directory.

2. bsa t src zzz.c

tests file  zzz.c from archive src.bsn created in the preceding example.

-n  - create a new archive (and delete the existing one)

     This modifier is used for block mode and batch files.

-r  - recursive (with sub-directories)

     The command is executed not only with the current directory but with
all its sub-directories recursive.  During extraction operations this
modifier assures that the matching is done with full names saved in the
archive.

-e   - exclude files from operation

     The file name (ot its mask) to be excluded is entered right after the
modifier.

Example:
bsa -a -r all * -e*.bak -e*.tmp

     This command will add all files from all directories to the archive
all.bsn, save files with .bak and .tmp extensions.

-+  - Extra compression

     The command allows the user to fine tune the speed of operation and/or
compression ratio of the files.

-+    ensures maximum compression with possible operation slow-down,
-+1   a bit faster, but possibly less compact,
-+2   normal operation (as if no switch is applied),
-+3   approximately 1.5 times faster,  but about 0.5% less compact,
-+4   about 2 times faster but about 2% less compact.

-y   - without any queries (assume 'Y')

-s    - silent operation

     Echo-free operation sometimes is needed for command files or for
detached processes.

-q   - with confirmation

     This will demand confirmation for all operations which might introduce
changes to the archive structure.

-f    - fresh only

     This modifier can be used for extraction files from archive and adding
files to archive (the command "f" is in fact equivalent to the command "a
-f").  Only files which are already present on the disk and have the later
date in the archive will be extracted from the archive.

-u    - fresh and new

     This modifier can be used while extracting from the archive and adding
to it (the command "u" is equivalent to "a -u").  Only files which do not
exist  on the disk or those with the latest date of creation will be
extracted from the archive.

-m    - move files if success

     This modifier allows the user to delete files which have succeeded in
participating in an operation, i.e. delete files successfully archived, in
case this modifier is used in conjunction with operations to modify the
archive and to remove files from it upon their successful extraction.

-t  - test archive after an operation

     This modifier puts a just modified archive to integrity test prior to
its renaming.

Example:
bsa a -m -t src *.[ch] makefile

     In this case:

1) A new archive will be created containing files from the command line and
   the rest of the files from the old archive scr.bsn.
2) If there were no errors the new archive will be verified for integrity
   (ALL files will be verified, not only those specified in the command
   line).
3) In case there were no errors the old archive will be renamed as a backup
   one, while the new one moves into its place (renamed, if it is possible,
   or otherwise copied).
4) If there were no errors the backup archive is deleted, if needed, and
   files which participated in the operation are deleted.

-/    - remove the first "/" from names

-z    - do not compress archives

     Files with extensions *.bsa *.bsn *.arc *.arj *.zip *.zoo will be
copied into the archive without compression.

-iXXX  - handle archiver XXX (bsn, bsa, arj, tar, cpio)

     Usually the archiver's type is determined by extension, and then by the
beginning of file. This modifier allows the user to install an archiver's
type manually.

Example:
bsa l -iarj test.exe

shows contents of the self-extracting archive test.exe created by the
application arj.

-wDIR   - assign Work directory for temporary file(s)

Example:
bsa a -wf: src *.[ch]

creates an intermediate archive on disk f:  (possibly it is a virtual one or
the current disk has not enough free space).

-oDIR   - assign output directory for extracted files

Example:
bsa x -ob:\src

     This command extracts all files from the archive src, starting with the
root directory of diskette b:. If there is no specified directory it will be
created. Its name may or may not end  with "/" or "\" (this is,  in fact,
the main difference of this modifier from the parameter "base_dir/" in the
command line, where the final slash is obligatory).

-js   - create self-extracting archive

Example:
bsa a -js test_arc *.[ch]

     This command will create test_arc.exe file which can then be executed
or renewed, tested, viewed, etc. (in other words it behaves as an ordinary
archive).

     If you simply want to transform an archive to a EXE-archive, enter:

     bsa f -js test_arc nul

     As a result, you will get both test_arc.bsn and test_arc.exe files.

-ju  - permit use *?[] in names of modified archives

Example:
bsa d -ju *.bsn *.bak

     This command deletes all files with extension .bak  from all
bsn-archives in the current directory.  If this modifier were not used we
would get a message reminding that you cannot use *?[] in modified archives
names.

-cl  - (local comment) comment on files (bsn)

     Comment on files taking part in adding operations. You will be asked:

     Comment on XXX:

which would enable you to input the comment line to the file.  The comments
would be given to the right of the file's names when using listing commands.

-cg  - (global comment) comment on the archive (bsn)

     By setting this modifier you get the possibility to comment on the
archive as a whole.  These comments will be output every time when the
archive is "opened". The commentary size is not limited but it should not
exceed a screen size.

-cs   - don't display comments (bsn)

     This modifier (comment silent) forbids displaying any commentaries,
both local and global.  Take a note that the modifier "-s" will have the
same effect (more than that: it would display nothing at all).

-ß@FILE - file with comments (bsn)

     This option lets you avoid the necessity of typing comments every time
you want them. It would be enough to create a file with comments in the
following format:

Sample: comment....

     A sample can serve both as file name and as any pattern.

Example of a file with comments:

test.c:control version
ari.[ch]:class "arithmetic coder"
markov.[ch]:class "coding a la markov".


ATTENTION: Take care not to cram the command letters together,
           i.e. -am IS SOMETHING QUITE DIFFERENT FROM -a -m !!!