Home » Archimedes archive » Acorn Computing » 1995 01 subscription disc.adf » 9501s » PD/!MULTIARC/DOCS/MANUAL

PD/!MULTIARC/DOCS/MANUAL

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Acorn Computing » 1995 01 subscription disc.adf » 9501s
Filename: PD/!MULTIARC/DOCS/MANUAL
Read OK:
File size: 0B5F bytes
Load address: 0000
Exec address: 0000
File contents
                               !MultiArc (v1.03)
                               -----------------

Intoduction
-----------
This program allows entire directories of files or applications to be
archived automatically.  For each file/application a seperate archive is
created, this is useful (well I find it useful) for archiving batches of
files ready to uploaded to BBS systems.


Usage
-----
This program is simple to use, just drag the two directories onto the
white icons on the main window, then click 'start'.

A status window will appear showing the progress, clicking stop on this
window will stop the process.

From the icon bar menu an options window can be displayed.  This alllows you
to set the type of compression used, whether the files are moved or deleted
and whether the archives are in Arc or PC format.  Clicking save in this
window will make the current settings default.

 If the 'crunch' option is set to on the BBC compatible 'Crunch' compression
 will be used, otherwise 'Squash' compression will be used.

 If the 'move' option is selected the files will be deleted after they are
 archived, otherwise they will be left intact.

 By defualt the archives are in Archimedes format but if the 'PC Format'
 option is set then PKArc style headers will be used.  If this option is
 selected when just SparkFS is loaded then PKZip Imploding will be used.

 If the 'strip !' option is selected then when !MultiArc comes accross any
 applications, the '!' will be automatically removed from the archive name.
 So for example, if you were archiving the '!Edit' application it would be
 stored in an archive called 'Edit'.

During the archiving process it is not possible to access the icon bar menu
to prevent these options form being changed.

For a reminder of these options use the !Help application.


NB.  When both SparkFS and Spark are loaded, MultiArc will use Spark to do
     all the archiving.


Problems
--------
There are one or two small bugs/problems:

Care must be taken to ensure that there is sufficient disc space for the
new archives.  If during the archiving process the destination disc is filled
this is not reported because Spark doesn't seem to send any error messages.

It is not possible to archive to or from the root directory.  I don't really
see need for this option but if you want it I could add it.

Sometimes when the source and destination path names are too long Spark
crashes, I'm not sure if this is my fault or not.


Finally
-------
Thanks go to Lee Archer for pointing out several serious errors and testing
the new versions and Jonathan Martin for the info about 'EnumerateTasks'.

-----------------------------------------------------------------------------


If for any reason you should want to contact me, my address is:

S.D.Vincent
130 Baginton Road
Styvechale
Coventry
CV3 6FS

I can also be reached on Arcade (user #98) and Cryton (user #817).
00000000  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000010  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 21  |               !|
00000020  4d 75 6c 74 69 41 72 63  20 28 76 31 2e 30 33 29  |MultiArc (v1.03)|
00000030  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00000040  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000050  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00000060  2d 0a 0a 49 6e 74 6f 64  75 63 74 69 6f 6e 0a 2d  |-..Intoduction.-|
00000070  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 0a 54 68 69 73 20  |----------.This |
00000080  70 72 6f 67 72 61 6d 20  61 6c 6c 6f 77 73 20 65  |program allows e|
00000090  6e 74 69 72 65 20 64 69  72 65 63 74 6f 72 69 65  |ntire directorie|
000000a0  73 20 6f 66 20 66 69 6c  65 73 20 6f 72 20 61 70  |s of files or ap|
000000b0  70 6c 69 63 61 74 69 6f  6e 73 20 74 6f 20 62 65  |plications to be|
000000c0  0a 61 72 63 68 69 76 65  64 20 61 75 74 6f 6d 61  |.archived automa|
000000d0  74 69 63 61 6c 6c 79 2e  20 20 46 6f 72 20 65 61  |tically.  For ea|
000000e0  63 68 20 66 69 6c 65 2f  61 70 70 6c 69 63 61 74  |ch file/applicat|
000000f0  69 6f 6e 20 61 20 73 65  70 65 72 61 74 65 20 61  |ion a seperate a|
00000100  72 63 68 69 76 65 20 69  73 0a 63 72 65 61 74 65  |rchive is.create|
00000110  64 2c 20 74 68 69 73 20  69 73 20 75 73 65 66 75  |d, this is usefu|
00000120  6c 20 28 77 65 6c 6c 20  49 20 66 69 6e 64 20 69  |l (well I find i|
00000130  74 20 75 73 65 66 75 6c  29 20 66 6f 72 20 61 72  |t useful) for ar|
00000140  63 68 69 76 69 6e 67 20  62 61 74 63 68 65 73 20  |chiving batches |
00000150  6f 66 0a 66 69 6c 65 73  20 72 65 61 64 79 20 74  |of.files ready t|
00000160  6f 20 75 70 6c 6f 61 64  65 64 20 74 6f 20 42 42  |o uploaded to BB|
00000170  53 20 73 79 73 74 65 6d  73 2e 0a 0a 0a 55 73 61  |S systems....Usa|
00000180  67 65 0a 2d 2d 2d 2d 2d  0a 54 68 69 73 20 70 72  |ge.-----.This pr|
00000190  6f 67 72 61 6d 20 69 73  20 73 69 6d 70 6c 65 20  |ogram is simple |
000001a0  74 6f 20 75 73 65 2c 20  6a 75 73 74 20 64 72 61  |to use, just dra|
000001b0  67 20 74 68 65 20 74 77  6f 20 64 69 72 65 63 74  |g the two direct|
000001c0  6f 72 69 65 73 20 6f 6e  74 6f 20 74 68 65 0a 77  |ories onto the.w|
000001d0  68 69 74 65 20 69 63 6f  6e 73 20 6f 6e 20 74 68  |hite icons on th|
000001e0  65 20 6d 61 69 6e 20 77  69 6e 64 6f 77 2c 20 74  |e main window, t|
000001f0  68 65 6e 20 63 6c 69 63  6b 20 27 73 74 61 72 74  |hen click 'start|
00000200  27 2e 0a 0a 41 20 73 74  61 74 75 73 20 77 69 6e  |'...A status win|
00000210  64 6f 77 20 77 69 6c 6c  20 61 70 70 65 61 72 20  |dow will appear |
00000220  73 68 6f 77 69 6e 67 20  74 68 65 20 70 72 6f 67  |showing the prog|
00000230  72 65 73 73 2c 20 63 6c  69 63 6b 69 6e 67 20 73  |ress, clicking s|
00000240  74 6f 70 20 6f 6e 20 74  68 69 73 0a 77 69 6e 64  |top on this.wind|
00000250  6f 77 20 77 69 6c 6c 20  73 74 6f 70 20 74 68 65  |ow will stop the|
00000260  20 70 72 6f 63 65 73 73  2e 0a 0a 46 72 6f 6d 20  | process...From |
00000270  74 68 65 20 69 63 6f 6e  20 62 61 72 20 6d 65 6e  |the icon bar men|
00000280  75 20 61 6e 20 6f 70 74  69 6f 6e 73 20 77 69 6e  |u an options win|
00000290  64 6f 77 20 63 61 6e 20  62 65 20 64 69 73 70 6c  |dow can be displ|
000002a0  61 79 65 64 2e 20 20 54  68 69 73 20 61 6c 6c 6c  |ayed.  This alll|
000002b0  6f 77 73 20 79 6f 75 0a  74 6f 20 73 65 74 20 74  |ows you.to set t|
000002c0  68 65 20 74 79 70 65 20  6f 66 20 63 6f 6d 70 72  |he type of compr|
000002d0  65 73 73 69 6f 6e 20 75  73 65 64 2c 20 77 68 65  |ession used, whe|
000002e0  74 68 65 72 20 74 68 65  20 66 69 6c 65 73 20 61  |ther the files a|
000002f0  72 65 20 6d 6f 76 65 64  20 6f 72 20 64 65 6c 65  |re moved or dele|
00000300  74 65 64 0a 61 6e 64 20  77 68 65 74 68 65 72 20  |ted.and whether |
00000310  74 68 65 20 61 72 63 68  69 76 65 73 20 61 72 65  |the archives are|
00000320  20 69 6e 20 41 72 63 20  6f 72 20 50 43 20 66 6f  | in Arc or PC fo|
00000330  72 6d 61 74 2e 20 20 43  6c 69 63 6b 69 6e 67 20  |rmat.  Clicking |
00000340  73 61 76 65 20 69 6e 20  74 68 69 73 0a 77 69 6e  |save in this.win|
00000350  64 6f 77 20 77 69 6c 6c  20 6d 61 6b 65 20 74 68  |dow will make th|
00000360  65 20 63 75 72 72 65 6e  74 20 73 65 74 74 69 6e  |e current settin|
00000370  67 73 20 64 65 66 61 75  6c 74 2e 0a 0a 20 49 66  |gs default... If|
00000380  20 74 68 65 20 27 63 72  75 6e 63 68 27 20 6f 70  | the 'crunch' op|
00000390  74 69 6f 6e 20 69 73 20  73 65 74 20 74 6f 20 6f  |tion is set to o|
000003a0  6e 20 74 68 65 20 42 42  43 20 63 6f 6d 70 61 74  |n the BBC compat|
000003b0  69 62 6c 65 20 27 43 72  75 6e 63 68 27 20 63 6f  |ible 'Crunch' co|
000003c0  6d 70 72 65 73 73 69 6f  6e 0a 20 77 69 6c 6c 20  |mpression. will |
000003d0  62 65 20 75 73 65 64 2c  20 6f 74 68 65 72 77 69  |be used, otherwi|
000003e0  73 65 20 27 53 71 75 61  73 68 27 20 63 6f 6d 70  |se 'Squash' comp|
000003f0  72 65 73 73 69 6f 6e 20  77 69 6c 6c 20 62 65 20  |ression will be |
00000400  75 73 65 64 2e 0a 0a 20  49 66 20 74 68 65 20 27  |used... If the '|
00000410  6d 6f 76 65 27 20 6f 70  74 69 6f 6e 20 69 73 20  |move' option is |
00000420  73 65 6c 65 63 74 65 64  20 74 68 65 20 66 69 6c  |selected the fil|
00000430  65 73 20 77 69 6c 6c 20  62 65 20 64 65 6c 65 74  |es will be delet|
00000440  65 64 20 61 66 74 65 72  20 74 68 65 79 20 61 72  |ed after they ar|
00000450  65 0a 20 61 72 63 68 69  76 65 64 2c 20 6f 74 68  |e. archived, oth|
00000460  65 72 77 69 73 65 20 74  68 65 79 20 77 69 6c 6c  |erwise they will|
00000470  20 62 65 20 6c 65 66 74  20 69 6e 74 61 63 74 2e  | be left intact.|
00000480  0a 0a 20 42 79 20 64 65  66 75 61 6c 74 20 74 68  |.. By defualt th|
00000490  65 20 61 72 63 68 69 76  65 73 20 61 72 65 20 69  |e archives are i|
000004a0  6e 20 41 72 63 68 69 6d  65 64 65 73 20 66 6f 72  |n Archimedes for|
000004b0  6d 61 74 20 62 75 74 20  69 66 20 74 68 65 20 27  |mat but if the '|
000004c0  50 43 20 46 6f 72 6d 61  74 27 0a 20 6f 70 74 69  |PC Format'. opti|
000004d0  6f 6e 20 69 73 20 73 65  74 20 74 68 65 6e 20 50  |on is set then P|
000004e0  4b 41 72 63 20 73 74 79  6c 65 20 68 65 61 64 65  |KArc style heade|
000004f0  72 73 20 77 69 6c 6c 20  62 65 20 75 73 65 64 2e  |rs will be used.|
00000500  20 20 49 66 20 74 68 69  73 20 6f 70 74 69 6f 6e  |  If this option|
00000510  20 69 73 0a 20 73 65 6c  65 63 74 65 64 20 77 68  | is. selected wh|
00000520  65 6e 20 6a 75 73 74 20  53 70 61 72 6b 46 53 20  |en just SparkFS |
00000530  69 73 20 6c 6f 61 64 65  64 20 74 68 65 6e 20 50  |is loaded then P|
00000540  4b 5a 69 70 20 49 6d 70  6c 6f 64 69 6e 67 20 77  |KZip Imploding w|
00000550  69 6c 6c 20 62 65 20 75  73 65 64 2e 0a 0a 20 49  |ill be used... I|
00000560  66 20 74 68 65 20 27 73  74 72 69 70 20 21 27 20  |f the 'strip !' |
00000570  6f 70 74 69 6f 6e 20 69  73 20 73 65 6c 65 63 74  |option is select|
00000580  65 64 20 74 68 65 6e 20  77 68 65 6e 20 21 4d 75  |ed then when !Mu|
00000590  6c 74 69 41 72 63 20 63  6f 6d 65 73 20 61 63 63  |ltiArc comes acc|
000005a0  72 6f 73 73 20 61 6e 79  0a 20 61 70 70 6c 69 63  |ross any. applic|
000005b0  61 74 69 6f 6e 73 2c 20  74 68 65 20 27 21 27 20  |ations, the '!' |
000005c0  77 69 6c 6c 20 62 65 20  61 75 74 6f 6d 61 74 69  |will be automati|
000005d0  63 61 6c 6c 79 20 72 65  6d 6f 76 65 64 20 66 72  |cally removed fr|
000005e0  6f 6d 20 74 68 65 20 61  72 63 68 69 76 65 20 6e  |om the archive n|
000005f0  61 6d 65 2e 0a 20 53 6f  20 66 6f 72 20 65 78 61  |ame.. So for exa|
00000600  6d 70 6c 65 2c 20 69 66  20 79 6f 75 20 77 65 72  |mple, if you wer|
00000610  65 20 61 72 63 68 69 76  69 6e 67 20 74 68 65 20  |e archiving the |
00000620  27 21 45 64 69 74 27 20  61 70 70 6c 69 63 61 74  |'!Edit' applicat|
00000630  69 6f 6e 20 69 74 20 77  6f 75 6c 64 20 62 65 0a  |ion it would be.|
00000640  20 73 74 6f 72 65 64 20  69 6e 20 61 6e 20 61 72  | stored in an ar|
00000650  63 68 69 76 65 20 63 61  6c 6c 65 64 20 27 45 64  |chive called 'Ed|
00000660  69 74 27 2e 0a 0a 44 75  72 69 6e 67 20 74 68 65  |it'...During the|
00000670  20 61 72 63 68 69 76 69  6e 67 20 70 72 6f 63 65  | archiving proce|
00000680  73 73 20 69 74 20 69 73  20 6e 6f 74 20 70 6f 73  |ss it is not pos|
00000690  73 69 62 6c 65 20 74 6f  20 61 63 63 65 73 73 20  |sible to access |
000006a0  74 68 65 20 69 63 6f 6e  20 62 61 72 20 6d 65 6e  |the icon bar men|
000006b0  75 0a 74 6f 20 70 72 65  76 65 6e 74 20 74 68 65  |u.to prevent the|
000006c0  73 65 20 6f 70 74 69 6f  6e 73 20 66 6f 72 6d 20  |se options form |
000006d0  62 65 69 6e 67 20 63 68  61 6e 67 65 64 2e 0a 0a  |being changed...|
000006e0  46 6f 72 20 61 20 72 65  6d 69 6e 64 65 72 20 6f  |For a reminder o|
000006f0  66 20 74 68 65 73 65 20  6f 70 74 69 6f 6e 73 20  |f these options |
00000700  75 73 65 20 74 68 65 20  21 48 65 6c 70 20 61 70  |use the !Help ap|
00000710  70 6c 69 63 61 74 69 6f  6e 2e 0a 0a 0a 4e 42 2e  |plication....NB.|
00000720  20 20 57 68 65 6e 20 62  6f 74 68 20 53 70 61 72  |  When both Spar|
00000730  6b 46 53 20 61 6e 64 20  53 70 61 72 6b 20 61 72  |kFS and Spark ar|
00000740  65 20 6c 6f 61 64 65 64  2c 20 4d 75 6c 74 69 41  |e loaded, MultiA|
00000750  72 63 20 77 69 6c 6c 20  75 73 65 20 53 70 61 72  |rc will use Spar|
00000760  6b 20 74 6f 20 64 6f 0a  20 20 20 20 20 61 6c 6c  |k to do.     all|
00000770  20 74 68 65 20 61 72 63  68 69 76 69 6e 67 2e 0a  | the archiving..|
00000780  0a 0a 50 72 6f 62 6c 65  6d 73 0a 2d 2d 2d 2d 2d  |..Problems.-----|
00000790  2d 2d 2d 0a 54 68 65 72  65 20 61 72 65 20 6f 6e  |---.There are on|
000007a0  65 20 6f 72 20 74 77 6f  20 73 6d 61 6c 6c 20 62  |e or two small b|
000007b0  75 67 73 2f 70 72 6f 62  6c 65 6d 73 3a 0a 0a 43  |ugs/problems:..C|
000007c0  61 72 65 20 6d 75 73 74  20 62 65 20 74 61 6b 65  |are must be take|
000007d0  6e 20 74 6f 20 65 6e 73  75 72 65 20 74 68 61 74  |n to ensure that|
000007e0  20 74 68 65 72 65 20 69  73 20 73 75 66 66 69 63  | there is suffic|
000007f0  69 65 6e 74 20 64 69 73  63 20 73 70 61 63 65 20  |ient disc space |
00000800  66 6f 72 20 74 68 65 0a  6e 65 77 20 61 72 63 68  |for the.new arch|
00000810  69 76 65 73 2e 20 20 49  66 20 64 75 72 69 6e 67  |ives.  If during|
00000820  20 74 68 65 20 61 72 63  68 69 76 69 6e 67 20 70  | the archiving p|
00000830  72 6f 63 65 73 73 20 74  68 65 20 64 65 73 74 69  |rocess the desti|
00000840  6e 61 74 69 6f 6e 20 64  69 73 63 20 69 73 20 66  |nation disc is f|
00000850  69 6c 6c 65 64 0a 74 68  69 73 20 69 73 20 6e 6f  |illed.this is no|
00000860  74 20 72 65 70 6f 72 74  65 64 20 62 65 63 61 75  |t reported becau|
00000870  73 65 20 53 70 61 72 6b  20 64 6f 65 73 6e 27 74  |se Spark doesn't|
00000880  20 73 65 65 6d 20 74 6f  20 73 65 6e 64 20 61 6e  | seem to send an|
00000890  79 20 65 72 72 6f 72 20  6d 65 73 73 61 67 65 73  |y error messages|
000008a0  2e 0a 0a 49 74 20 69 73  20 6e 6f 74 20 70 6f 73  |...It is not pos|
000008b0  73 69 62 6c 65 20 74 6f  20 61 72 63 68 69 76 65  |sible to archive|
000008c0  20 74 6f 20 6f 72 20 66  72 6f 6d 20 74 68 65 20  | to or from the |
000008d0  72 6f 6f 74 20 64 69 72  65 63 74 6f 72 79 2e 20  |root directory. |
000008e0  20 49 20 64 6f 6e 27 74  20 72 65 61 6c 6c 79 0a  | I don't really.|
000008f0  73 65 65 20 6e 65 65 64  20 66 6f 72 20 74 68 69  |see need for thi|
00000900  73 20 6f 70 74 69 6f 6e  20 62 75 74 20 69 66 20  |s option but if |
00000910  79 6f 75 20 77 61 6e 74  20 69 74 20 49 20 63 6f  |you want it I co|
00000920  75 6c 64 20 61 64 64 20  69 74 2e 0a 0a 53 6f 6d  |uld add it...Som|
00000930  65 74 69 6d 65 73 20 77  68 65 6e 20 74 68 65 20  |etimes when the |
00000940  73 6f 75 72 63 65 20 61  6e 64 20 64 65 73 74 69  |source and desti|
00000950  6e 61 74 69 6f 6e 20 70  61 74 68 20 6e 61 6d 65  |nation path name|
00000960  73 20 61 72 65 20 74 6f  6f 20 6c 6f 6e 67 20 53  |s are too long S|
00000970  70 61 72 6b 0a 63 72 61  73 68 65 73 2c 20 49 27  |park.crashes, I'|
00000980  6d 20 6e 6f 74 20 73 75  72 65 20 69 66 20 74 68  |m not sure if th|
00000990  69 73 20 69 73 20 6d 79  20 66 61 75 6c 74 20 6f  |is is my fault o|
000009a0  72 20 6e 6f 74 2e 0a 0a  0a 46 69 6e 61 6c 6c 79  |r not....Finally|
000009b0  0a 2d 2d 2d 2d 2d 2d 2d  0a 54 68 61 6e 6b 73 20  |.-------.Thanks |
000009c0  67 6f 20 74 6f 20 4c 65  65 20 41 72 63 68 65 72  |go to Lee Archer|
000009d0  20 66 6f 72 20 70 6f 69  6e 74 69 6e 67 20 6f 75  | for pointing ou|
000009e0  74 20 73 65 76 65 72 61  6c 20 73 65 72 69 6f 75  |t several seriou|
000009f0  73 20 65 72 72 6f 72 73  20 61 6e 64 20 74 65 73  |s errors and tes|
00000a00  74 69 6e 67 0a 74 68 65  20 6e 65 77 20 76 65 72  |ting.the new ver|
00000a10  73 69 6f 6e 73 20 61 6e  64 20 4a 6f 6e 61 74 68  |sions and Jonath|
00000a20  61 6e 20 4d 61 72 74 69  6e 20 66 6f 72 20 74 68  |an Martin for th|
00000a30  65 20 69 6e 66 6f 20 61  62 6f 75 74 20 27 45 6e  |e info about 'En|
00000a40  75 6d 65 72 61 74 65 54  61 73 6b 73 27 2e 0a 0a  |umerateTasks'...|
00000a50  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000a90  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 0a 0a 0a  |-------------...|
00000aa0  49 66 20 66 6f 72 20 61  6e 79 20 72 65 61 73 6f  |If for any reaso|
00000ab0  6e 20 79 6f 75 20 73 68  6f 75 6c 64 20 77 61 6e  |n you should wan|
00000ac0  74 20 74 6f 20 63 6f 6e  74 61 63 74 20 6d 65 2c  |t to contact me,|
00000ad0  20 6d 79 20 61 64 64 72  65 73 73 20 69 73 3a 0a  | my address is:.|
00000ae0  0a 53 2e 44 2e 56 69 6e  63 65 6e 74 0a 31 33 30  |.S.D.Vincent.130|
00000af0  20 42 61 67 69 6e 74 6f  6e 20 52 6f 61 64 0a 53  | Baginton Road.S|
00000b00  74 79 76 65 63 68 61 6c  65 0a 43 6f 76 65 6e 74  |tyvechale.Covent|
00000b10  72 79 0a 43 56 33 20 36  46 53 0a 0a 49 20 63 61  |ry.CV3 6FS..I ca|
00000b20  6e 20 61 6c 73 6f 20 62  65 20 72 65 61 63 68 65  |n also be reache|
00000b30  64 20 6f 6e 20 41 72 63  61 64 65 20 28 75 73 65  |d on Arcade (use|
00000b40  72 20 23 39 38 29 20 61  6e 64 20 43 72 79 74 6f  |r #98) and Cryto|
00000b50  6e 20 28 75 73 65 72 20  23 38 31 37 29 2e 0a     |n (user #817)..|
00000b5f