Home » Archimedes archive » Archimedes World » AW-1991-05.adf » !ArcFS_!Help » !Help

!Help

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 » Archimedes World » AW-1991-05.adf » !ArcFS_!Help
Filename: !Help
Read OK:
File size: 2E0A bytes
Load address: 0000
Exec address: 0000
File contents
!Help file for ArcFS version 0.30 
by M.Smith
22nd Feb 1991

If you find ArcFS useful please register, the cost of which is �5. This will
entitle you to receive a free upgrade in the September/October 1991 once a
final version is available. Send a cheque for �5 payable to me to the
address below and I will acknowledge your registration. Commercial users and
P.D. libraries will receive an automatic upgrade.

Many thanks to David Pilling, author of Spark and SparkPlug, for providing
me with the information to enable me to include support for Squashed (PK arc
compatible) and Compress formats. Spark is available directly from him,
currently for �5.99

ArcFS has filing system number 56. My thanks to Acorn for the allocation of
this filing system number.

ArcFS is a read-only filing system. Use Spark to create archives.

ArcFS allows the loading and opening of (compressed) files in archives 
almost as easily as files on ADFS or RamFS. It has its own ArcFS filer 
which displays the root directory in a filer window of any archive 
which is double clicked. From then on files and applications may be 
loaded as normal by double clicking them. Directories may be displayed 
also by double clicking them. ArcFS can, of cause, also be used from 
the command line.

You may notice a small increase in the time taken to load files 
compared to loading files from ADFS and also that ArcFS takes a short 
time to Open Archives when they are double clicked. 


ArcFS supports the following entry points:

    FSEntry_Func 0 to set current directory (*Dir)

    FSEntry_Func 1 to set library directory (*Lib)

    FSEntry_Func 2 to catalogue directory (*Cat)

    FSEntry_Func 3 to examine directory (*EX)

    FSEntry_Func 4 to catalogue library directory (*LCat)

    FSEntry_Func 5 to examine library directory (*LEX)

    FSEntry_Func 6 to examine objects (*Info).

    FSEntry_Func 15 to respond to requests from the Filer for 
    the necessary information to display a directory window

    FSEntry_Func 20 to give full information on objects (*FileInfo)

    FSEntry_File 5 to read catalogue information on a file

    FSEntry_File 255 to load files

    FSEntry_Open to provide facilities for opening files for 
    random access input. ArcFS claims memory from the R.M.A. 
    the size of the uncompressed file and the loads the file 
    into this claimed memory. For this reason it is possible to 
    get 'No Room in RMA errors' when opening large files.

    FSEntry_GetBytes reads required bytes from memory claimed 
    by FSEntry_Open

    FSEntry_Close releases memory claimed by FSEntry_Open


Catalogue Storage in memory

When an archive is opened the number of objects in the archive is 
counted and a block of R.M.A., 32 bytes for each object is claimed and 
the catalogue information is read into this block

Compression formats

This version of ArcFS supports crunched, packed, new format stored
objects, squashed and compressed objects. Objects in a format  that
ArcFS cannot handle will give 'Can't handle archive' errors when  you
attempt to load them. Archives containing old format stored objects cannot
be opened.

Memory requirements

No. of bits compression    Spark formats           Memory requirement

12 bits                    Crunch, Compress 12     Just over 16K
13 bits                    Squash, Compress 13     Just over 32K
14 bits                    Compress 14             Just over 64K
15 bits                    Compress 15             Just over 128K
16 bits                    Compress 16             Just over 256K

The above table shows the requirements for free memory in order to load each
of the available formats. Using 16 bit compression formats can cause
problems when trying to load such files on a 1Mbyte machine.

Simultaneously open archives

This version of ArcFS supports only one open archive at a time. Future 
versions may support may different named archives selected by the 
inclusion of the name in a special field. This version supports but 
ignores special fields allowing the ArcFS filer to include the leafname 
of the archive as the special field so that the user can see at a 
glance which archive is open.

Screen Output format

Screen Output follows that of Filecore as closely as possible. *FileInfo gives a totaly different output to that of Filecore.

*FileInfo

*FileInfo displays the complete Header information held in memory about
files. The output of *FileInfo is as follows:

Name       LWR/wr ff format  llllllll aaaaaaaa eeeeeeee 00cccccc pppppppp rr%

where:

    Name is the object leafname

    LWR/wr are the object attributes

    ff is the Header Version Number (represents the compression format)

    format is the type of data compression (always store for directories)

    llllllll is the full object length (for directories this is the total                 compressed size of all objects contained in it.)

    aaaaaaaa is the load address (directories are filetype &DDC)

    eeeeeeee is the execute address

    00cccccc is the compressed file size. The top byte is always shown as                 zero regardless of whether this is the case as the                           compressed length is stored in the top 24 bits of the file                   attributes. Unless you are using VERY long files this should not             be a problem. It equals the full length for stored objects.

    pppppppp This depends on whether the object is a file or directory. For a             file it is the position in the archive file at which the file                data begins. For directories this is the memory address at which             the next header in the parent directory exists (not very useful,             but used internally by ArcFS).

         rr% This is the compression ratio, i.e. the compressed file size                 expressed as a percentage of the original. Can suffer from the               effect explained above for compressed file sizes larger than                 &FFFFFF. 

File Attributes

The lowest 24 bits of the compressed file length are stored in the top 24
bits of the file attributes.

User Root Directories (U.R.D.'s)

Now supported. Use *URD to select the user root (&) directory.

The previously selected directory (P.S.D.)

Now supported. When a new directory selection is made, the old one becomes
the P.S.D. Use *Back to swap the C.S.D. and P.S.D. The P.S.D. can be
specified at the begining of a pathname as \.

Automatic library selection

If ArcFS finds a directory starting with the letters 'Lib' in the root
directory of an archive when it is open it selects this as the library
directory, otherwise the root directory ($) is selected.

Unset Directory contexts

This is not supported. All directory contexts are set to '$' when an
archive is opened (unless an automatic library selection is made, see
above).

Random access filing

Files are decompressed and held in R.M.A. whilst they are open. You  should
note that when sprite files are loaded they are opened for  random access
input and therefore there needs to be enough free memory  available when the
sprites are loaded. This may cause problems when  large sprite files are
loaded into a 1 Mbyte machine (anyone with an  unexpanded A305 - don't
bother!) but I cannot really suggest anything  short of upgrading to 2
Mbytes (other than making sure that all the  possible free memory is
available to the R.M.A.). When I bought my 2Mbyte RAM upgrade in Dec. 1989
it cost �150 +VAT. Now it can cost as little as a third of that price and is
still falling. I have found it very useful and can recommend it to any users
of 1 Mbyte A3000's and A410's who use their computers for more than just
arcade games. Other files such as  Exec and Obey files are also opened for
random access input but these  are usually short.

Use with 65Host and 65Tube

ArcFS can easily be used with 65Host and 65Tube. 65Host users must open the
required archive before entering the emulator under which ArcFS is selected
by:

    *Dir ArcFS:

DFS emulations may also be set up in archives (as on ADFS) and used
under 65Host

PC Format

Files archived using PC Format in Spark or archived using SEA arc or PK arc
on a PC all have file type &111.

Directory levels

Up to 64 directory levels are supported. In the unlikely event that more
exist in an archive further subdirectories are shown as archives.

Commands provided:

    *ArcFS                - selects ArcFS as the current filing system
    *OpenArchive <Object> - Opens an archive for file operations
    *CloseArchive         - Closes any open archive

Filing system commands:

    *Back                 - swaps the currently and previously selected                                  directories (CSD and PSD)
    *URD                  - selects the user root directory (URD)
    *Garble <PassWord>    - Loads files garbled with a password
    *NoEncryption         - Loads files with no encryption


File encryption

This version supports garbled files. Incorrect passwords, use of Garble for
files with no encryption or trying to load garbled files having set ArcFS to
load files with no encryption will result in a 'Data Corrupt' error. This
will also occur if data in an archive becomes corrupted.

ArcFS Filer

The ArcFS filer is provided so that directories may be displayed in normal
filer windows. Archives are opened by double clicking them or dragging them
to the ArcFS icon. The root directory of the most recently opened archive
may be displayed by clicking on the icon. A menu is provided with four
options:

Encryption- Sets the encryption method and password (if any) that is used.               The subdirectory has options for no encryption and garble. DES               encryption is not available in this version and so is shaded.

Close arc - Closes the currently open archive and all arcfs directory
            windows.

Kill      - Closes the current archive, removes all arcfs directory windows,
            Kills the ArcFS module and Quits the ArcFS Filer.

Quit      - Quits the ArcFS Filer.

Kill and Quit both prompt for confirmation. Click on OK to Kill/Quit or
Cancel otherwise. Note pressing escape has the same effect as clicking on OK.


All comments and suggestions for future improvement are welcome but please
note that I cannot reply to letters without return postage and an addressed
envelope.

The address is:

    Mr. M. Smith
    Pen-y-dre,
    Riverside Ave.,
    Broxbourne,
    Herts.,
    EN10 6RD.

I would also, of course welcome details of any bugs discovered so that I can
correct them.

Version Improvements

v0.20 First Release version
v0.21 Max number of directory levels increased from 16 to 64, some tidying
v0.22 Snowed in 8th Feb 91 so made extensive changes: URD and PSD now              supported. Commands *Back and *URD provided. *FileInfo command added.        Compression format removed from *Info and *EX output (now given by           *FileInfo). *Info & *FileInfo now give information on multiple               wildcarded files. Compressed file size now stored in the top 24 bits of      the file attributes. PC format files are now supported. Supplied with        new ArcFS Filer with icon and menu.
v0.23 Corrected 2 bugs - ArcFS did not release 16k of claimed memory when an       error occured during the load crunch routine. If you cancelled a             request from the load pack routine to insert a disk the request was          repeated a second time.
v0.30 Now added support for squashed and compressed formats. Also added            support for Garbled files, *Garble and *NoEncryption commands provided.      Comprehensive error checking checks for corrupted data and/or passwords      and file encryption methods inconsistent with those that have been set.

� 1991 M. Smith
00000000  21 48 65 6c 70 20 66 69  6c 65 20 66 6f 72 20 41  |!Help file for A|
00000010  72 63 46 53 20 76 65 72  73 69 6f 6e 20 30 2e 33  |rcFS version 0.3|
00000020  30 20 0a 62 79 20 4d 2e  53 6d 69 74 68 0a 32 32  |0 .by M.Smith.22|
00000030  6e 64 20 46 65 62 20 31  39 39 31 0a 0a 49 66 20  |nd Feb 1991..If |
00000040  79 6f 75 20 66 69 6e 64  20 41 72 63 46 53 20 75  |you find ArcFS u|
00000050  73 65 66 75 6c 20 70 6c  65 61 73 65 20 72 65 67  |seful please reg|
00000060  69 73 74 65 72 2c 20 74  68 65 20 63 6f 73 74 20  |ister, the cost |
00000070  6f 66 20 77 68 69 63 68  20 69 73 20 a3 35 2e 20  |of which is .5. |
00000080  54 68 69 73 20 77 69 6c  6c 0a 65 6e 74 69 74 6c  |This will.entitl|
00000090  65 20 79 6f 75 20 74 6f  20 72 65 63 65 69 76 65  |e you to receive|
000000a0  20 61 20 66 72 65 65 20  75 70 67 72 61 64 65 20  | a free upgrade |
000000b0  69 6e 20 74 68 65 20 53  65 70 74 65 6d 62 65 72  |in the September|
000000c0  2f 4f 63 74 6f 62 65 72  20 31 39 39 31 20 6f 6e  |/October 1991 on|
000000d0  63 65 20 61 0a 66 69 6e  61 6c 20 76 65 72 73 69  |ce a.final versi|
000000e0  6f 6e 20 69 73 20 61 76  61 69 6c 61 62 6c 65 2e  |on is available.|
000000f0  20 53 65 6e 64 20 61 20  63 68 65 71 75 65 20 66  | Send a cheque f|
00000100  6f 72 20 a3 35 20 70 61  79 61 62 6c 65 20 74 6f  |or .5 payable to|
00000110  20 6d 65 20 74 6f 20 74  68 65 0a 61 64 64 72 65  | me to the.addre|
00000120  73 73 20 62 65 6c 6f 77  20 61 6e 64 20 49 20 77  |ss below and I w|
00000130  69 6c 6c 20 61 63 6b 6e  6f 77 6c 65 64 67 65 20  |ill acknowledge |
00000140  79 6f 75 72 20 72 65 67  69 73 74 72 61 74 69 6f  |your registratio|
00000150  6e 2e 20 43 6f 6d 6d 65  72 63 69 61 6c 20 75 73  |n. Commercial us|
00000160  65 72 73 20 61 6e 64 0a  50 2e 44 2e 20 6c 69 62  |ers and.P.D. lib|
00000170  72 61 72 69 65 73 20 77  69 6c 6c 20 72 65 63 65  |raries will rece|
00000180  69 76 65 20 61 6e 20 61  75 74 6f 6d 61 74 69 63  |ive an automatic|
00000190  20 75 70 67 72 61 64 65  2e 0a 0a 4d 61 6e 79 20  | upgrade...Many |
000001a0  74 68 61 6e 6b 73 20 74  6f 20 44 61 76 69 64 20  |thanks to David |
000001b0  50 69 6c 6c 69 6e 67 2c  20 61 75 74 68 6f 72 20  |Pilling, author |
000001c0  6f 66 20 53 70 61 72 6b  20 61 6e 64 20 53 70 61  |of Spark and Spa|
000001d0  72 6b 50 6c 75 67 2c 20  66 6f 72 20 70 72 6f 76  |rkPlug, for prov|
000001e0  69 64 69 6e 67 0a 6d 65  20 77 69 74 68 20 74 68  |iding.me with th|
000001f0  65 20 69 6e 66 6f 72 6d  61 74 69 6f 6e 20 74 6f  |e information to|
00000200  20 65 6e 61 62 6c 65 20  6d 65 20 74 6f 20 69 6e  | enable me to in|
00000210  63 6c 75 64 65 20 73 75  70 70 6f 72 74 20 66 6f  |clude support fo|
00000220  72 20 53 71 75 61 73 68  65 64 20 28 50 4b 20 61  |r Squashed (PK a|
00000230  72 63 0a 63 6f 6d 70 61  74 69 62 6c 65 29 20 61  |rc.compatible) a|
00000240  6e 64 20 43 6f 6d 70 72  65 73 73 20 66 6f 72 6d  |nd Compress form|
00000250  61 74 73 2e 20 53 70 61  72 6b 20 69 73 20 61 76  |ats. Spark is av|
00000260  61 69 6c 61 62 6c 65 20  64 69 72 65 63 74 6c 79  |ailable directly|
00000270  20 66 72 6f 6d 20 68 69  6d 2c 0a 63 75 72 72 65  | from him,.curre|
00000280  6e 74 6c 79 20 66 6f 72  20 a3 35 2e 39 39 0a 0a  |ntly for .5.99..|
00000290  41 72 63 46 53 20 68 61  73 20 66 69 6c 69 6e 67  |ArcFS has filing|
000002a0  20 73 79 73 74 65 6d 20  6e 75 6d 62 65 72 20 35  | system number 5|
000002b0  36 2e 20 4d 79 20 74 68  61 6e 6b 73 20 74 6f 20  |6. My thanks to |
000002c0  41 63 6f 72 6e 20 66 6f  72 20 74 68 65 20 61 6c  |Acorn for the al|
000002d0  6c 6f 63 61 74 69 6f 6e  20 6f 66 0a 74 68 69 73  |location of.this|
000002e0  20 66 69 6c 69 6e 67 20  73 79 73 74 65 6d 20 6e  | filing system n|
000002f0  75 6d 62 65 72 2e 0a 0a  41 72 63 46 53 20 69 73  |umber...ArcFS is|
00000300  20 61 20 72 65 61 64 2d  6f 6e 6c 79 20 66 69 6c  | a read-only fil|
00000310  69 6e 67 20 73 79 73 74  65 6d 2e 20 55 73 65 20  |ing system. Use |
00000320  53 70 61 72 6b 20 74 6f  20 63 72 65 61 74 65 20  |Spark to create |
00000330  61 72 63 68 69 76 65 73  2e 0a 0a 41 72 63 46 53  |archives...ArcFS|
00000340  20 61 6c 6c 6f 77 73 20  74 68 65 20 6c 6f 61 64  | allows the load|
00000350  69 6e 67 20 61 6e 64 20  6f 70 65 6e 69 6e 67 20  |ing and opening |
00000360  6f 66 20 28 63 6f 6d 70  72 65 73 73 65 64 29 20  |of (compressed) |
00000370  66 69 6c 65 73 20 69 6e  20 61 72 63 68 69 76 65  |files in archive|
00000380  73 20 0a 61 6c 6d 6f 73  74 20 61 73 20 65 61 73  |s .almost as eas|
00000390  69 6c 79 20 61 73 20 66  69 6c 65 73 20 6f 6e 20  |ily as files on |
000003a0  41 44 46 53 20 6f 72 20  52 61 6d 46 53 2e 20 49  |ADFS or RamFS. I|
000003b0  74 20 68 61 73 20 69 74  73 20 6f 77 6e 20 41 72  |t has its own Ar|
000003c0  63 46 53 20 66 69 6c 65  72 20 0a 77 68 69 63 68  |cFS filer .which|
000003d0  20 64 69 73 70 6c 61 79  73 20 74 68 65 20 72 6f  | displays the ro|
000003e0  6f 74 20 64 69 72 65 63  74 6f 72 79 20 69 6e 20  |ot directory in |
000003f0  61 20 66 69 6c 65 72 20  77 69 6e 64 6f 77 20 6f  |a filer window o|
00000400  66 20 61 6e 79 20 61 72  63 68 69 76 65 20 0a 77  |f any archive .w|
00000410  68 69 63 68 20 69 73 20  64 6f 75 62 6c 65 20 63  |hich is double c|
00000420  6c 69 63 6b 65 64 2e 20  46 72 6f 6d 20 74 68 65  |licked. From the|
00000430  6e 20 6f 6e 20 66 69 6c  65 73 20 61 6e 64 20 61  |n on files and a|
00000440  70 70 6c 69 63 61 74 69  6f 6e 73 20 6d 61 79 20  |pplications may |
00000450  62 65 20 0a 6c 6f 61 64  65 64 20 61 73 20 6e 6f  |be .loaded as no|
00000460  72 6d 61 6c 20 62 79 20  64 6f 75 62 6c 65 20 63  |rmal by double c|
00000470  6c 69 63 6b 69 6e 67 20  74 68 65 6d 2e 20 44 69  |licking them. Di|
00000480  72 65 63 74 6f 72 69 65  73 20 6d 61 79 20 62 65  |rectories may be|
00000490  20 64 69 73 70 6c 61 79  65 64 20 0a 61 6c 73 6f  | displayed .also|
000004a0  20 62 79 20 64 6f 75 62  6c 65 20 63 6c 69 63 6b  | by double click|
000004b0  69 6e 67 20 74 68 65 6d  2e 20 41 72 63 46 53 20  |ing them. ArcFS |
000004c0  63 61 6e 2c 20 6f 66 20  63 61 75 73 65 2c 20 61  |can, of cause, a|
000004d0  6c 73 6f 20 62 65 20 75  73 65 64 20 66 72 6f 6d  |lso be used from|
000004e0  20 0a 74 68 65 20 63 6f  6d 6d 61 6e 64 20 6c 69  | .the command li|
000004f0  6e 65 2e 0a 0a 59 6f 75  20 6d 61 79 20 6e 6f 74  |ne...You may not|
00000500  69 63 65 20 61 20 73 6d  61 6c 6c 20 69 6e 63 72  |ice a small incr|
00000510  65 61 73 65 20 69 6e 20  74 68 65 20 74 69 6d 65  |ease in the time|
00000520  20 74 61 6b 65 6e 20 74  6f 20 6c 6f 61 64 20 66  | taken to load f|
00000530  69 6c 65 73 20 0a 63 6f  6d 70 61 72 65 64 20 74  |iles .compared t|
00000540  6f 20 6c 6f 61 64 69 6e  67 20 66 69 6c 65 73 20  |o loading files |
00000550  66 72 6f 6d 20 41 44 46  53 20 61 6e 64 20 61 6c  |from ADFS and al|
00000560  73 6f 20 74 68 61 74 20  41 72 63 46 53 20 74 61  |so that ArcFS ta|
00000570  6b 65 73 20 61 20 73 68  6f 72 74 20 0a 74 69 6d  |kes a short .tim|
00000580  65 20 74 6f 20 4f 70 65  6e 20 41 72 63 68 69 76  |e to Open Archiv|
00000590  65 73 20 77 68 65 6e 20  74 68 65 79 20 61 72 65  |es when they are|
000005a0  20 64 6f 75 62 6c 65 20  63 6c 69 63 6b 65 64 2e  | double clicked.|
000005b0  20 0a 0a 0a 41 72 63 46  53 20 73 75 70 70 6f 72  | ...ArcFS suppor|
000005c0  74 73 20 74 68 65 20 66  6f 6c 6c 6f 77 69 6e 67  |ts the following|
000005d0  20 65 6e 74 72 79 20 70  6f 69 6e 74 73 3a 0a 0a  | entry points:..|
000005e0  20 20 20 20 46 53 45 6e  74 72 79 5f 46 75 6e 63  |    FSEntry_Func|
000005f0  20 30 20 74 6f 20 73 65  74 20 63 75 72 72 65 6e  | 0 to set curren|
00000600  74 20 64 69 72 65 63 74  6f 72 79 20 28 2a 44 69  |t directory (*Di|
00000610  72 29 0a 0a 20 20 20 20  46 53 45 6e 74 72 79 5f  |r)..    FSEntry_|
00000620  46 75 6e 63 20 31 20 74  6f 20 73 65 74 20 6c 69  |Func 1 to set li|
00000630  62 72 61 72 79 20 64 69  72 65 63 74 6f 72 79 20  |brary directory |
00000640  28 2a 4c 69 62 29 0a 0a  20 20 20 20 46 53 45 6e  |(*Lib)..    FSEn|
00000650  74 72 79 5f 46 75 6e 63  20 32 20 74 6f 20 63 61  |try_Func 2 to ca|
00000660  74 61 6c 6f 67 75 65 20  64 69 72 65 63 74 6f 72  |talogue director|
00000670  79 20 28 2a 43 61 74 29  0a 0a 20 20 20 20 46 53  |y (*Cat)..    FS|
00000680  45 6e 74 72 79 5f 46 75  6e 63 20 33 20 74 6f 20  |Entry_Func 3 to |
00000690  65 78 61 6d 69 6e 65 20  64 69 72 65 63 74 6f 72  |examine director|
000006a0  79 20 28 2a 45 58 29 0a  0a 20 20 20 20 46 53 45  |y (*EX)..    FSE|
000006b0  6e 74 72 79 5f 46 75 6e  63 20 34 20 74 6f 20 63  |ntry_Func 4 to c|
000006c0  61 74 61 6c 6f 67 75 65  20 6c 69 62 72 61 72 79  |atalogue library|
000006d0  20 64 69 72 65 63 74 6f  72 79 20 28 2a 4c 43 61  | directory (*LCa|
000006e0  74 29 0a 0a 20 20 20 20  46 53 45 6e 74 72 79 5f  |t)..    FSEntry_|
000006f0  46 75 6e 63 20 35 20 74  6f 20 65 78 61 6d 69 6e  |Func 5 to examin|
00000700  65 20 6c 69 62 72 61 72  79 20 64 69 72 65 63 74  |e library direct|
00000710  6f 72 79 20 28 2a 4c 45  58 29 0a 0a 20 20 20 20  |ory (*LEX)..    |
00000720  46 53 45 6e 74 72 79 5f  46 75 6e 63 20 36 20 74  |FSEntry_Func 6 t|
00000730  6f 20 65 78 61 6d 69 6e  65 20 6f 62 6a 65 63 74  |o examine object|
00000740  73 20 28 2a 49 6e 66 6f  29 2e 0a 0a 20 20 20 20  |s (*Info)...    |
00000750  46 53 45 6e 74 72 79 5f  46 75 6e 63 20 31 35 20  |FSEntry_Func 15 |
00000760  74 6f 20 72 65 73 70 6f  6e 64 20 74 6f 20 72 65  |to respond to re|
00000770  71 75 65 73 74 73 20 66  72 6f 6d 20 74 68 65 20  |quests from the |
00000780  46 69 6c 65 72 20 66 6f  72 20 0a 20 20 20 20 74  |Filer for .    t|
00000790  68 65 20 6e 65 63 65 73  73 61 72 79 20 69 6e 66  |he necessary inf|
000007a0  6f 72 6d 61 74 69 6f 6e  20 74 6f 20 64 69 73 70  |ormation to disp|
000007b0  6c 61 79 20 61 20 64 69  72 65 63 74 6f 72 79 20  |lay a directory |
000007c0  77 69 6e 64 6f 77 0a 0a  20 20 20 20 46 53 45 6e  |window..    FSEn|
000007d0  74 72 79 5f 46 75 6e 63  20 32 30 20 74 6f 20 67  |try_Func 20 to g|
000007e0  69 76 65 20 66 75 6c 6c  20 69 6e 66 6f 72 6d 61  |ive full informa|
000007f0  74 69 6f 6e 20 6f 6e 20  6f 62 6a 65 63 74 73 20  |tion on objects |
00000800  28 2a 46 69 6c 65 49 6e  66 6f 29 0a 0a 20 20 20  |(*FileInfo)..   |
00000810  20 46 53 45 6e 74 72 79  5f 46 69 6c 65 20 35 20  | FSEntry_File 5 |
00000820  74 6f 20 72 65 61 64 20  63 61 74 61 6c 6f 67 75  |to read catalogu|
00000830  65 20 69 6e 66 6f 72 6d  61 74 69 6f 6e 20 6f 6e  |e information on|
00000840  20 61 20 66 69 6c 65 0a  0a 20 20 20 20 46 53 45  | a file..    FSE|
00000850  6e 74 72 79 5f 46 69 6c  65 20 32 35 35 20 74 6f  |ntry_File 255 to|
00000860  20 6c 6f 61 64 20 66 69  6c 65 73 0a 0a 20 20 20  | load files..   |
00000870  20 46 53 45 6e 74 72 79  5f 4f 70 65 6e 20 74 6f  | FSEntry_Open to|
00000880  20 70 72 6f 76 69 64 65  20 66 61 63 69 6c 69 74  | provide facilit|
00000890  69 65 73 20 66 6f 72 20  6f 70 65 6e 69 6e 67 20  |ies for opening |
000008a0  66 69 6c 65 73 20 66 6f  72 20 0a 20 20 20 20 72  |files for .    r|
000008b0  61 6e 64 6f 6d 20 61 63  63 65 73 73 20 69 6e 70  |andom access inp|
000008c0  75 74 2e 20 41 72 63 46  53 20 63 6c 61 69 6d 73  |ut. ArcFS claims|
000008d0  20 6d 65 6d 6f 72 79 20  66 72 6f 6d 20 74 68 65  | memory from the|
000008e0  20 52 2e 4d 2e 41 2e 20  0a 20 20 20 20 74 68 65  | R.M.A. .    the|
000008f0  20 73 69 7a 65 20 6f 66  20 74 68 65 20 75 6e 63  | size of the unc|
00000900  6f 6d 70 72 65 73 73 65  64 20 66 69 6c 65 20 61  |ompressed file a|
00000910  6e 64 20 74 68 65 20 6c  6f 61 64 73 20 74 68 65  |nd the loads the|
00000920  20 66 69 6c 65 20 0a 20  20 20 20 69 6e 74 6f 20  | file .    into |
00000930  74 68 69 73 20 63 6c 61  69 6d 65 64 20 6d 65 6d  |this claimed mem|
00000940  6f 72 79 2e 20 46 6f 72  20 74 68 69 73 20 72 65  |ory. For this re|
00000950  61 73 6f 6e 20 69 74 20  69 73 20 70 6f 73 73 69  |ason it is possi|
00000960  62 6c 65 20 74 6f 20 0a  20 20 20 20 67 65 74 20  |ble to .    get |
00000970  27 4e 6f 20 52 6f 6f 6d  20 69 6e 20 52 4d 41 20  |'No Room in RMA |
00000980  65 72 72 6f 72 73 27 20  77 68 65 6e 20 6f 70 65  |errors' when ope|
00000990  6e 69 6e 67 20 6c 61 72  67 65 20 66 69 6c 65 73  |ning large files|
000009a0  2e 0a 0a 20 20 20 20 46  53 45 6e 74 72 79 5f 47  |...    FSEntry_G|
000009b0  65 74 42 79 74 65 73 20  72 65 61 64 73 20 72 65  |etBytes reads re|
000009c0  71 75 69 72 65 64 20 62  79 74 65 73 20 66 72 6f  |quired bytes fro|
000009d0  6d 20 6d 65 6d 6f 72 79  20 63 6c 61 69 6d 65 64  |m memory claimed|
000009e0  20 0a 20 20 20 20 62 79  20 46 53 45 6e 74 72 79  | .    by FSEntry|
000009f0  5f 4f 70 65 6e 0a 0a 20  20 20 20 46 53 45 6e 74  |_Open..    FSEnt|
00000a00  72 79 5f 43 6c 6f 73 65  20 72 65 6c 65 61 73 65  |ry_Close release|
00000a10  73 20 6d 65 6d 6f 72 79  20 63 6c 61 69 6d 65 64  |s memory claimed|
00000a20  20 62 79 20 46 53 45 6e  74 72 79 5f 4f 70 65 6e  | by FSEntry_Open|
00000a30  0a 0a 0a 43 61 74 61 6c  6f 67 75 65 20 53 74 6f  |...Catalogue Sto|
00000a40  72 61 67 65 20 69 6e 20  6d 65 6d 6f 72 79 0a 0a  |rage in memory..|
00000a50  57 68 65 6e 20 61 6e 20  61 72 63 68 69 76 65 20  |When an archive |
00000a60  69 73 20 6f 70 65 6e 65  64 20 74 68 65 20 6e 75  |is opened the nu|
00000a70  6d 62 65 72 20 6f 66 20  6f 62 6a 65 63 74 73 20  |mber of objects |
00000a80  69 6e 20 74 68 65 20 61  72 63 68 69 76 65 20 69  |in the archive i|
00000a90  73 20 0a 63 6f 75 6e 74  65 64 20 61 6e 64 20 61  |s .counted and a|
00000aa0  20 62 6c 6f 63 6b 20 6f  66 20 52 2e 4d 2e 41 2e  | block of R.M.A.|
00000ab0  2c 20 33 32 20 62 79 74  65 73 20 66 6f 72 20 65  |, 32 bytes for e|
00000ac0  61 63 68 20 6f 62 6a 65  63 74 20 69 73 20 63 6c  |ach object is cl|
00000ad0  61 69 6d 65 64 20 61 6e  64 20 0a 74 68 65 20 63  |aimed and .the c|
00000ae0  61 74 61 6c 6f 67 75 65  20 69 6e 66 6f 72 6d 61  |atalogue informa|
00000af0  74 69 6f 6e 20 69 73 20  72 65 61 64 20 69 6e 74  |tion is read int|
00000b00  6f 20 74 68 69 73 20 62  6c 6f 63 6b 0a 0a 43 6f  |o this block..Co|
00000b10  6d 70 72 65 73 73 69 6f  6e 20 66 6f 72 6d 61 74  |mpression format|
00000b20  73 0a 0a 54 68 69 73 20  76 65 72 73 69 6f 6e 20  |s..This version |
00000b30  6f 66 20 41 72 63 46 53  20 73 75 70 70 6f 72 74  |of ArcFS support|
00000b40  73 20 63 72 75 6e 63 68  65 64 2c 20 70 61 63 6b  |s crunched, pack|
00000b50  65 64 2c 20 6e 65 77 20  66 6f 72 6d 61 74 20 73  |ed, new format s|
00000b60  74 6f 72 65 64 0a 6f 62  6a 65 63 74 73 2c 20 73  |tored.objects, s|
00000b70  71 75 61 73 68 65 64 20  61 6e 64 20 63 6f 6d 70  |quashed and comp|
00000b80  72 65 73 73 65 64 20 6f  62 6a 65 63 74 73 2e 20  |ressed objects. |
00000b90  4f 62 6a 65 63 74 73 20  69 6e 20 61 20 66 6f 72  |Objects in a for|
00000ba0  6d 61 74 20 20 74 68 61  74 0a 41 72 63 46 53 20  |mat  that.ArcFS |
00000bb0  63 61 6e 6e 6f 74 20 68  61 6e 64 6c 65 20 77 69  |cannot handle wi|
00000bc0  6c 6c 20 67 69 76 65 20  27 43 61 6e 27 74 20 68  |ll give 'Can't h|
00000bd0  61 6e 64 6c 65 20 61 72  63 68 69 76 65 27 20 65  |andle archive' e|
00000be0  72 72 6f 72 73 20 77 68  65 6e 20 20 79 6f 75 0a  |rrors when  you.|
00000bf0  61 74 74 65 6d 70 74 20  74 6f 20 6c 6f 61 64 20  |attempt to load |
00000c00  74 68 65 6d 2e 20 41 72  63 68 69 76 65 73 20 63  |them. Archives c|
00000c10  6f 6e 74 61 69 6e 69 6e  67 20 6f 6c 64 20 66 6f  |ontaining old fo|
00000c20  72 6d 61 74 20 73 74 6f  72 65 64 20 6f 62 6a 65  |rmat stored obje|
00000c30  63 74 73 20 63 61 6e 6e  6f 74 0a 62 65 20 6f 70  |cts cannot.be op|
00000c40  65 6e 65 64 2e 0a 0a 4d  65 6d 6f 72 79 20 72 65  |ened...Memory re|
00000c50  71 75 69 72 65 6d 65 6e  74 73 0a 0a 4e 6f 2e 20  |quirements..No. |
00000c60  6f 66 20 62 69 74 73 20  63 6f 6d 70 72 65 73 73  |of bits compress|
00000c70  69 6f 6e 20 20 20 20 53  70 61 72 6b 20 66 6f 72  |ion    Spark for|
00000c80  6d 61 74 73 20 20 20 20  20 20 20 20 20 20 20 4d  |mats           M|
00000c90  65 6d 6f 72 79 20 72 65  71 75 69 72 65 6d 65 6e  |emory requiremen|
00000ca0  74 0a 0a 31 32 20 62 69  74 73 20 20 20 20 20 20  |t..12 bits      |
00000cb0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 43 72  |              Cr|
00000cc0  75 6e 63 68 2c 20 43 6f  6d 70 72 65 73 73 20 31  |unch, Compress 1|
00000cd0  32 20 20 20 20 20 4a 75  73 74 20 6f 76 65 72 20  |2     Just over |
00000ce0  31 36 4b 0a 31 33 20 62  69 74 73 20 20 20 20 20  |16K.13 bits     |
00000cf0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 53  |               S|
00000d00  71 75 61 73 68 2c 20 43  6f 6d 70 72 65 73 73 20  |quash, Compress |
00000d10  31 33 20 20 20 20 20 4a  75 73 74 20 6f 76 65 72  |13     Just over|
00000d20  20 33 32 4b 0a 31 34 20  62 69 74 73 20 20 20 20  | 32K.14 bits    |
00000d30  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000d40  43 6f 6d 70 72 65 73 73  20 31 34 20 20 20 20 20  |Compress 14     |
00000d50  20 20 20 20 20 20 20 20  4a 75 73 74 20 6f 76 65  |        Just ove|
00000d60  72 20 36 34 4b 0a 31 35  20 62 69 74 73 20 20 20  |r 64K.15 bits   |
00000d70  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000d80  20 43 6f 6d 70 72 65 73  73 20 31 35 20 20 20 20  | Compress 15    |
00000d90  20 20 20 20 20 20 20 20  20 4a 75 73 74 20 6f 76  |         Just ov|
00000da0  65 72 20 31 32 38 4b 0a  31 36 20 62 69 74 73 20  |er 128K.16 bits |
00000db0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000dc0  20 20 20 43 6f 6d 70 72  65 73 73 20 31 36 20 20  |   Compress 16  |
00000dd0  20 20 20 20 20 20 20 20  20 20 20 4a 75 73 74 20  |           Just |
00000de0  6f 76 65 72 20 32 35 36  4b 0a 0a 54 68 65 20 61  |over 256K..The a|
00000df0  62 6f 76 65 20 74 61 62  6c 65 20 73 68 6f 77 73  |bove table shows|
00000e00  20 74 68 65 20 72 65 71  75 69 72 65 6d 65 6e 74  | the requirement|
00000e10  73 20 66 6f 72 20 66 72  65 65 20 6d 65 6d 6f 72  |s for free memor|
00000e20  79 20 69 6e 20 6f 72 64  65 72 20 74 6f 20 6c 6f  |y in order to lo|
00000e30  61 64 20 65 61 63 68 0a  6f 66 20 74 68 65 20 61  |ad each.of the a|
00000e40  76 61 69 6c 61 62 6c 65  20 66 6f 72 6d 61 74 73  |vailable formats|
00000e50  2e 20 55 73 69 6e 67 20  31 36 20 62 69 74 20 63  |. Using 16 bit c|
00000e60  6f 6d 70 72 65 73 73 69  6f 6e 20 66 6f 72 6d 61  |ompression forma|
00000e70  74 73 20 63 61 6e 20 63  61 75 73 65 0a 70 72 6f  |ts can cause.pro|
00000e80  62 6c 65 6d 73 20 77 68  65 6e 20 74 72 79 69 6e  |blems when tryin|
00000e90  67 20 74 6f 20 6c 6f 61  64 20 73 75 63 68 20 66  |g to load such f|
00000ea0  69 6c 65 73 20 6f 6e 20  61 20 31 4d 62 79 74 65  |iles on a 1Mbyte|
00000eb0  20 6d 61 63 68 69 6e 65  2e 0a 0a 53 69 6d 75 6c  | machine...Simul|
00000ec0  74 61 6e 65 6f 75 73 6c  79 20 6f 70 65 6e 20 61  |taneously open a|
00000ed0  72 63 68 69 76 65 73 0a  0a 54 68 69 73 20 76 65  |rchives..This ve|
00000ee0  72 73 69 6f 6e 20 6f 66  20 41 72 63 46 53 20 73  |rsion of ArcFS s|
00000ef0  75 70 70 6f 72 74 73 20  6f 6e 6c 79 20 6f 6e 65  |upports only one|
00000f00  20 6f 70 65 6e 20 61 72  63 68 69 76 65 20 61 74  | open archive at|
00000f10  20 61 20 74 69 6d 65 2e  20 46 75 74 75 72 65 20  | a time. Future |
00000f20  0a 76 65 72 73 69 6f 6e  73 20 6d 61 79 20 73 75  |.versions may su|
00000f30  70 70 6f 72 74 20 6d 61  79 20 64 69 66 66 65 72  |pport may differ|
00000f40  65 6e 74 20 6e 61 6d 65  64 20 61 72 63 68 69 76  |ent named archiv|
00000f50  65 73 20 73 65 6c 65 63  74 65 64 20 62 79 20 74  |es selected by t|
00000f60  68 65 20 0a 69 6e 63 6c  75 73 69 6f 6e 20 6f 66  |he .inclusion of|
00000f70  20 74 68 65 20 6e 61 6d  65 20 69 6e 20 61 20 73  | the name in a s|
00000f80  70 65 63 69 61 6c 20 66  69 65 6c 64 2e 20 54 68  |pecial field. Th|
00000f90  69 73 20 76 65 72 73 69  6f 6e 20 73 75 70 70 6f  |is version suppo|
00000fa0  72 74 73 20 62 75 74 20  0a 69 67 6e 6f 72 65 73  |rts but .ignores|
00000fb0  20 73 70 65 63 69 61 6c  20 66 69 65 6c 64 73 20  | special fields |
00000fc0  61 6c 6c 6f 77 69 6e 67  20 74 68 65 20 41 72 63  |allowing the Arc|
00000fd0  46 53 20 66 69 6c 65 72  20 74 6f 20 69 6e 63 6c  |FS filer to incl|
00000fe0  75 64 65 20 74 68 65 20  6c 65 61 66 6e 61 6d 65  |ude the leafname|
00000ff0  20 0a 6f 66 20 74 68 65  20 61 72 63 68 69 76 65  | .of the archive|
00001000  20 61 73 20 74 68 65 20  73 70 65 63 69 61 6c 20  | as the special |
00001010  66 69 65 6c 64 20 73 6f  20 74 68 61 74 20 74 68  |field so that th|
00001020  65 20 75 73 65 72 20 63  61 6e 20 73 65 65 20 61  |e user can see a|
00001030  74 20 61 20 0a 67 6c 61  6e 63 65 20 77 68 69 63  |t a .glance whic|
00001040  68 20 61 72 63 68 69 76  65 20 69 73 20 6f 70 65  |h archive is ope|
00001050  6e 2e 0a 0a 53 63 72 65  65 6e 20 4f 75 74 70 75  |n...Screen Outpu|
00001060  74 20 66 6f 72 6d 61 74  0a 0a 53 63 72 65 65 6e  |t format..Screen|
00001070  20 4f 75 74 70 75 74 20  66 6f 6c 6c 6f 77 73 20  | Output follows |
00001080  74 68 61 74 20 6f 66 20  46 69 6c 65 63 6f 72 65  |that of Filecore|
00001090  20 61 73 20 63 6c 6f 73  65 6c 79 20 61 73 20 70  | as closely as p|
000010a0  6f 73 73 69 62 6c 65 2e  20 2a 46 69 6c 65 49 6e  |ossible. *FileIn|
000010b0  66 6f 20 67 69 76 65 73  20 61 20 74 6f 74 61 6c  |fo gives a total|
000010c0  79 20 64 69 66 66 65 72  65 6e 74 20 6f 75 74 70  |y different outp|
000010d0  75 74 20 74 6f 20 74 68  61 74 20 6f 66 20 46 69  |ut to that of Fi|
000010e0  6c 65 63 6f 72 65 2e 0a  0a 2a 46 69 6c 65 49 6e  |lecore...*FileIn|
000010f0  66 6f 0a 0a 2a 46 69 6c  65 49 6e 66 6f 20 64 69  |fo..*FileInfo di|
00001100  73 70 6c 61 79 73 20 74  68 65 20 63 6f 6d 70 6c  |splays the compl|
00001110  65 74 65 20 48 65 61 64  65 72 20 69 6e 66 6f 72  |ete Header infor|
00001120  6d 61 74 69 6f 6e 20 68  65 6c 64 20 69 6e 20 6d  |mation held in m|
00001130  65 6d 6f 72 79 20 61 62  6f 75 74 0a 66 69 6c 65  |emory about.file|
00001140  73 2e 20 54 68 65 20 6f  75 74 70 75 74 20 6f 66  |s. The output of|
00001150  20 2a 46 69 6c 65 49 6e  66 6f 20 69 73 20 61 73  | *FileInfo is as|
00001160  20 66 6f 6c 6c 6f 77 73  3a 0a 0a 4e 61 6d 65 20  | follows:..Name |
00001170  20 20 20 20 20 20 4c 57  52 2f 77 72 20 66 66 20  |      LWR/wr ff |
00001180  66 6f 72 6d 61 74 20 20  6c 6c 6c 6c 6c 6c 6c 6c  |format  llllllll|
00001190  20 61 61 61 61 61 61 61  61 20 65 65 65 65 65 65  | aaaaaaaa eeeeee|
000011a0  65 65 20 30 30 63 63 63  63 63 63 20 70 70 70 70  |ee 00cccccc pppp|
000011b0  70 70 70 70 20 72 72 25  0a 0a 77 68 65 72 65 3a  |pppp rr%..where:|
000011c0  0a 0a 20 20 20 20 4e 61  6d 65 20 69 73 20 74 68  |..    Name is th|
000011d0  65 20 6f 62 6a 65 63 74  20 6c 65 61 66 6e 61 6d  |e object leafnam|
000011e0  65 0a 0a 20 20 20 20 4c  57 52 2f 77 72 20 61 72  |e..    LWR/wr ar|
000011f0  65 20 74 68 65 20 6f 62  6a 65 63 74 20 61 74 74  |e the object att|
00001200  72 69 62 75 74 65 73 0a  0a 20 20 20 20 66 66 20  |ributes..    ff |
00001210  69 73 20 74 68 65 20 48  65 61 64 65 72 20 56 65  |is the Header Ve|
00001220  72 73 69 6f 6e 20 4e 75  6d 62 65 72 20 28 72 65  |rsion Number (re|
00001230  70 72 65 73 65 6e 74 73  20 74 68 65 20 63 6f 6d  |presents the com|
00001240  70 72 65 73 73 69 6f 6e  20 66 6f 72 6d 61 74 29  |pression format)|
00001250  0a 0a 20 20 20 20 66 6f  72 6d 61 74 20 69 73 20  |..    format is |
00001260  74 68 65 20 74 79 70 65  20 6f 66 20 64 61 74 61  |the type of data|
00001270  20 63 6f 6d 70 72 65 73  73 69 6f 6e 20 28 61 6c  | compression (al|
00001280  77 61 79 73 20 73 74 6f  72 65 20 66 6f 72 20 64  |ways store for d|
00001290  69 72 65 63 74 6f 72 69  65 73 29 0a 0a 20 20 20  |irectories)..   |
000012a0  20 6c 6c 6c 6c 6c 6c 6c  6c 20 69 73 20 74 68 65  | llllllll is the|
000012b0  20 66 75 6c 6c 20 6f 62  6a 65 63 74 20 6c 65 6e  | full object len|
000012c0  67 74 68 20 28 66 6f 72  20 64 69 72 65 63 74 6f  |gth (for directo|
000012d0  72 69 65 73 20 74 68 69  73 20 69 73 20 74 68 65  |ries this is the|
000012e0  20 74 6f 74 61 6c 20 20  20 20 20 20 20 20 20 20  | total          |
000012f0  20 20 20 20 20 20 20 63  6f 6d 70 72 65 73 73 65  |       compresse|
00001300  64 20 73 69 7a 65 20 6f  66 20 61 6c 6c 20 6f 62  |d size of all ob|
00001310  6a 65 63 74 73 20 63 6f  6e 74 61 69 6e 65 64 20  |jects contained |
00001320  69 6e 20 69 74 2e 29 0a  0a 20 20 20 20 61 61 61  |in it.)..    aaa|
00001330  61 61 61 61 61 20 69 73  20 74 68 65 20 6c 6f 61  |aaaaa is the loa|
00001340  64 20 61 64 64 72 65 73  73 20 28 64 69 72 65 63  |d address (direc|
00001350  74 6f 72 69 65 73 20 61  72 65 20 66 69 6c 65 74  |tories are filet|
00001360  79 70 65 20 26 44 44 43  29 0a 0a 20 20 20 20 65  |ype &DDC)..    e|
00001370  65 65 65 65 65 65 65 20  69 73 20 74 68 65 20 65  |eeeeeee is the e|
00001380  78 65 63 75 74 65 20 61  64 64 72 65 73 73 0a 0a  |xecute address..|
00001390  20 20 20 20 30 30 63 63  63 63 63 63 20 69 73 20  |    00cccccc is |
000013a0  74 68 65 20 63 6f 6d 70  72 65 73 73 65 64 20 66  |the compressed f|
000013b0  69 6c 65 20 73 69 7a 65  2e 20 54 68 65 20 74 6f  |ile size. The to|
000013c0  70 20 62 79 74 65 20 69  73 20 61 6c 77 61 79 73  |p byte is always|
000013d0  20 73 68 6f 77 6e 20 61  73 20 20 20 20 20 20 20  | shown as       |
000013e0  20 20 20 20 20 20 20 20  20 20 7a 65 72 6f 20 72  |          zero r|
000013f0  65 67 61 72 64 6c 65 73  73 20 6f 66 20 77 68 65  |egardless of whe|
00001400  74 68 65 72 20 74 68 69  73 20 69 73 20 74 68 65  |ther this is the|
00001410  20 63 61 73 65 20 61 73  20 74 68 65 20 20 20 20  | case as the    |
00001420  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001430  20 20 20 20 20 20 20 63  6f 6d 70 72 65 73 73 65  |       compresse|
00001440  64 20 6c 65 6e 67 74 68  20 69 73 20 73 74 6f 72  |d length is stor|
00001450  65 64 20 69 6e 20 74 68  65 20 74 6f 70 20 32 34  |ed in the top 24|
00001460  20 62 69 74 73 20 6f 66  20 74 68 65 20 66 69 6c  | bits of the fil|
00001470  65 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |e               |
00001480  20 20 20 20 61 74 74 72  69 62 75 74 65 73 2e 20  |    attributes. |
00001490  55 6e 6c 65 73 73 20 79  6f 75 20 61 72 65 20 75  |Unless you are u|
000014a0  73 69 6e 67 20 56 45 52  59 20 6c 6f 6e 67 20 66  |sing VERY long f|
000014b0  69 6c 65 73 20 74 68 69  73 20 73 68 6f 75 6c 64  |iles this should|
000014c0  20 6e 6f 74 20 20 20 20  20 20 20 20 20 20 20 20  | not            |
000014d0  20 62 65 20 61 20 70 72  6f 62 6c 65 6d 2e 20 49  | be a problem. I|
000014e0  74 20 65 71 75 61 6c 73  20 74 68 65 20 66 75 6c  |t equals the ful|
000014f0  6c 20 6c 65 6e 67 74 68  20 66 6f 72 20 73 74 6f  |l length for sto|
00001500  72 65 64 20 6f 62 6a 65  63 74 73 2e 0a 0a 20 20  |red objects...  |
00001510  20 20 70 70 70 70 70 70  70 70 20 54 68 69 73 20  |  pppppppp This |
00001520  64 65 70 65 6e 64 73 20  6f 6e 20 77 68 65 74 68  |depends on wheth|
00001530  65 72 20 74 68 65 20 6f  62 6a 65 63 74 20 69 73  |er the object is|
00001540  20 61 20 66 69 6c 65 20  6f 72 20 64 69 72 65 63  | a file or direc|
00001550  74 6f 72 79 2e 20 46 6f  72 20 61 20 20 20 20 20  |tory. For a     |
00001560  20 20 20 20 20 20 20 20  66 69 6c 65 20 69 74 20  |        file it |
00001570  69 73 20 74 68 65 20 70  6f 73 69 74 69 6f 6e 20  |is the position |
00001580  69 6e 20 74 68 65 20 61  72 63 68 69 76 65 20 66  |in the archive f|
00001590  69 6c 65 20 61 74 20 77  68 69 63 68 20 74 68 65  |ile at which the|
000015a0  20 66 69 6c 65 20 20 20  20 20 20 20 20 20 20 20  | file           |
000015b0  20 20 20 20 20 64 61 74  61 20 62 65 67 69 6e 73  |     data begins|
000015c0  2e 20 46 6f 72 20 64 69  72 65 63 74 6f 72 69 65  |. For directorie|
000015d0  73 20 74 68 69 73 20 69  73 20 74 68 65 20 6d 65  |s this is the me|
000015e0  6d 6f 72 79 20 61 64 64  72 65 73 73 20 61 74 20  |mory address at |
000015f0  77 68 69 63 68 20 20 20  20 20 20 20 20 20 20 20  |which           |
00001600  20 20 74 68 65 20 6e 65  78 74 20 68 65 61 64 65  |  the next heade|
00001610  72 20 69 6e 20 74 68 65  20 70 61 72 65 6e 74 20  |r in the parent |
00001620  64 69 72 65 63 74 6f 72  79 20 65 78 69 73 74 73  |directory exists|
00001630  20 28 6e 6f 74 20 76 65  72 79 20 75 73 65 66 75  | (not very usefu|
00001640  6c 2c 20 20 20 20 20 20  20 20 20 20 20 20 20 62  |l,             b|
00001650  75 74 20 75 73 65 64 20  69 6e 74 65 72 6e 61 6c  |ut used internal|
00001660  6c 79 20 62 79 20 41 72  63 46 53 29 2e 0a 0a 20  |ly by ArcFS)... |
00001670  20 20 20 20 20 20 20 20  72 72 25 20 54 68 69 73  |        rr% This|
00001680  20 69 73 20 74 68 65 20  63 6f 6d 70 72 65 73 73  | is the compress|
00001690  69 6f 6e 20 72 61 74 69  6f 2c 20 69 2e 65 2e 20  |ion ratio, i.e. |
000016a0  74 68 65 20 63 6f 6d 70  72 65 73 73 65 64 20 66  |the compressed f|
000016b0  69 6c 65 20 73 69 7a 65  20 20 20 20 20 20 20 20  |ile size        |
000016c0  20 20 20 20 20 20 20 20  20 65 78 70 72 65 73 73  |         express|
000016d0  65 64 20 61 73 20 61 20  70 65 72 63 65 6e 74 61  |ed as a percenta|
000016e0  67 65 20 6f 66 20 74 68  65 20 6f 72 69 67 69 6e  |ge of the origin|
000016f0  61 6c 2e 20 43 61 6e 20  73 75 66 66 65 72 20 66  |al. Can suffer f|
00001700  72 6f 6d 20 74 68 65 20  20 20 20 20 20 20 20 20  |rom the         |
00001710  20 20 20 20 20 20 65 66  66 65 63 74 20 65 78 70  |      effect exp|
00001720  6c 61 69 6e 65 64 20 61  62 6f 76 65 20 66 6f 72  |lained above for|
00001730  20 63 6f 6d 70 72 65 73  73 65 64 20 66 69 6c 65  | compressed file|
00001740  20 73 69 7a 65 73 20 6c  61 72 67 65 72 20 74 68  | sizes larger th|
00001750  61 6e 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |an              |
00001760  20 20 20 26 46 46 46 46  46 46 2e 20 0a 0a 46 69  |   &FFFFFF. ..Fi|
00001770  6c 65 20 41 74 74 72 69  62 75 74 65 73 0a 0a 54  |le Attributes..T|
00001780  68 65 20 6c 6f 77 65 73  74 20 32 34 20 62 69 74  |he lowest 24 bit|
00001790  73 20 6f 66 20 74 68 65  20 63 6f 6d 70 72 65 73  |s of the compres|
000017a0  73 65 64 20 66 69 6c 65  20 6c 65 6e 67 74 68 20  |sed file length |
000017b0  61 72 65 20 73 74 6f 72  65 64 20 69 6e 20 74 68  |are stored in th|
000017c0  65 20 74 6f 70 20 32 34  0a 62 69 74 73 20 6f 66  |e top 24.bits of|
000017d0  20 74 68 65 20 66 69 6c  65 20 61 74 74 72 69 62  | the file attrib|
000017e0  75 74 65 73 2e 0a 0a 55  73 65 72 20 52 6f 6f 74  |utes...User Root|
000017f0  20 44 69 72 65 63 74 6f  72 69 65 73 20 28 55 2e  | Directories (U.|
00001800  52 2e 44 2e 27 73 29 0a  0a 4e 6f 77 20 73 75 70  |R.D.'s)..Now sup|
00001810  70 6f 72 74 65 64 2e 20  55 73 65 20 2a 55 52 44  |ported. Use *URD|
00001820  20 74 6f 20 73 65 6c 65  63 74 20 74 68 65 20 75  | to select the u|
00001830  73 65 72 20 72 6f 6f 74  20 28 26 29 20 64 69 72  |ser root (&) dir|
00001840  65 63 74 6f 72 79 2e 0a  0a 54 68 65 20 70 72 65  |ectory...The pre|
00001850  76 69 6f 75 73 6c 79 20  73 65 6c 65 63 74 65 64  |viously selected|
00001860  20 64 69 72 65 63 74 6f  72 79 20 28 50 2e 53 2e  | directory (P.S.|
00001870  44 2e 29 0a 0a 4e 6f 77  20 73 75 70 70 6f 72 74  |D.)..Now support|
00001880  65 64 2e 20 57 68 65 6e  20 61 20 6e 65 77 20 64  |ed. When a new d|
00001890  69 72 65 63 74 6f 72 79  20 73 65 6c 65 63 74 69  |irectory selecti|
000018a0  6f 6e 20 69 73 20 6d 61  64 65 2c 20 74 68 65 20  |on is made, the |
000018b0  6f 6c 64 20 6f 6e 65 20  62 65 63 6f 6d 65 73 0a  |old one becomes.|
000018c0  74 68 65 20 50 2e 53 2e  44 2e 20 55 73 65 20 2a  |the P.S.D. Use *|
000018d0  42 61 63 6b 20 74 6f 20  73 77 61 70 20 74 68 65  |Back to swap the|
000018e0  20 43 2e 53 2e 44 2e 20  61 6e 64 20 50 2e 53 2e  | C.S.D. and P.S.|
000018f0  44 2e 20 54 68 65 20 50  2e 53 2e 44 2e 20 63 61  |D. The P.S.D. ca|
00001900  6e 20 62 65 0a 73 70 65  63 69 66 69 65 64 20 61  |n be.specified a|
00001910  74 20 74 68 65 20 62 65  67 69 6e 69 6e 67 20 6f  |t the begining o|
00001920  66 20 61 20 70 61 74 68  6e 61 6d 65 20 61 73 20  |f a pathname as |
00001930  5c 2e 0a 0a 41 75 74 6f  6d 61 74 69 63 20 6c 69  |\...Automatic li|
00001940  62 72 61 72 79 20 73 65  6c 65 63 74 69 6f 6e 0a  |brary selection.|
00001950  0a 49 66 20 41 72 63 46  53 20 66 69 6e 64 73 20  |.If ArcFS finds |
00001960  61 20 64 69 72 65 63 74  6f 72 79 20 73 74 61 72  |a directory star|
00001970  74 69 6e 67 20 77 69 74  68 20 74 68 65 20 6c 65  |ting with the le|
00001980  74 74 65 72 73 20 27 4c  69 62 27 20 69 6e 20 74  |tters 'Lib' in t|
00001990  68 65 20 72 6f 6f 74 0a  64 69 72 65 63 74 6f 72  |he root.director|
000019a0  79 20 6f 66 20 61 6e 20  61 72 63 68 69 76 65 20  |y of an archive |
000019b0  77 68 65 6e 20 69 74 20  69 73 20 6f 70 65 6e 20  |when it is open |
000019c0  69 74 20 73 65 6c 65 63  74 73 20 74 68 69 73 20  |it selects this |
000019d0  61 73 20 74 68 65 20 6c  69 62 72 61 72 79 0a 64  |as the library.d|
000019e0  69 72 65 63 74 6f 72 79  2c 20 6f 74 68 65 72 77  |irectory, otherw|
000019f0  69 73 65 20 74 68 65 20  72 6f 6f 74 20 64 69 72  |ise the root dir|
00001a00  65 63 74 6f 72 79 20 28  24 29 20 69 73 20 73 65  |ectory ($) is se|
00001a10  6c 65 63 74 65 64 2e 0a  0a 55 6e 73 65 74 20 44  |lected...Unset D|
00001a20  69 72 65 63 74 6f 72 79  20 63 6f 6e 74 65 78 74  |irectory context|
00001a30  73 0a 0a 54 68 69 73 20  69 73 20 6e 6f 74 20 73  |s..This is not s|
00001a40  75 70 70 6f 72 74 65 64  2e 20 41 6c 6c 20 64 69  |upported. All di|
00001a50  72 65 63 74 6f 72 79 20  63 6f 6e 74 65 78 74 73  |rectory contexts|
00001a60  20 61 72 65 20 73 65 74  20 74 6f 20 27 24 27 20  | are set to '$' |
00001a70  77 68 65 6e 20 61 6e 0a  61 72 63 68 69 76 65 20  |when an.archive |
00001a80  69 73 20 6f 70 65 6e 65  64 20 28 75 6e 6c 65 73  |is opened (unles|
00001a90  73 20 61 6e 20 61 75 74  6f 6d 61 74 69 63 20 6c  |s an automatic l|
00001aa0  69 62 72 61 72 79 20 73  65 6c 65 63 74 69 6f 6e  |ibrary selection|
00001ab0  20 69 73 20 6d 61 64 65  2c 20 73 65 65 0a 61 62  | is made, see.ab|
00001ac0  6f 76 65 29 2e 0a 0a 52  61 6e 64 6f 6d 20 61 63  |ove)...Random ac|
00001ad0  63 65 73 73 20 66 69 6c  69 6e 67 0a 0a 46 69 6c  |cess filing..Fil|
00001ae0  65 73 20 61 72 65 20 64  65 63 6f 6d 70 72 65 73  |es are decompres|
00001af0  73 65 64 20 61 6e 64 20  68 65 6c 64 20 69 6e 20  |sed and held in |
00001b00  52 2e 4d 2e 41 2e 20 77  68 69 6c 73 74 20 74 68  |R.M.A. whilst th|
00001b10  65 79 20 61 72 65 20 6f  70 65 6e 2e 20 59 6f 75  |ey are open. You|
00001b20  20 20 73 68 6f 75 6c 64  0a 6e 6f 74 65 20 74 68  |  should.note th|
00001b30  61 74 20 77 68 65 6e 20  73 70 72 69 74 65 20 66  |at when sprite f|
00001b40  69 6c 65 73 20 61 72 65  20 6c 6f 61 64 65 64 20  |iles are loaded |
00001b50  74 68 65 79 20 61 72 65  20 6f 70 65 6e 65 64 20  |they are opened |
00001b60  66 6f 72 20 20 72 61 6e  64 6f 6d 20 61 63 63 65  |for  random acce|
00001b70  73 73 0a 69 6e 70 75 74  20 61 6e 64 20 74 68 65  |ss.input and the|
00001b80  72 65 66 6f 72 65 20 74  68 65 72 65 20 6e 65 65  |refore there nee|
00001b90  64 73 20 74 6f 20 62 65  20 65 6e 6f 75 67 68 20  |ds to be enough |
00001ba0  66 72 65 65 20 6d 65 6d  6f 72 79 20 20 61 76 61  |free memory  ava|
00001bb0  69 6c 61 62 6c 65 20 77  68 65 6e 20 74 68 65 0a  |ilable when the.|
00001bc0  73 70 72 69 74 65 73 20  61 72 65 20 6c 6f 61 64  |sprites are load|
00001bd0  65 64 2e 20 54 68 69 73  20 6d 61 79 20 63 61 75  |ed. This may cau|
00001be0  73 65 20 70 72 6f 62 6c  65 6d 73 20 77 68 65 6e  |se problems when|
00001bf0  20 20 6c 61 72 67 65 20  73 70 72 69 74 65 20 66  |  large sprite f|
00001c00  69 6c 65 73 20 61 72 65  0a 6c 6f 61 64 65 64 20  |iles are.loaded |
00001c10  69 6e 74 6f 20 61 20 31  20 4d 62 79 74 65 20 6d  |into a 1 Mbyte m|
00001c20  61 63 68 69 6e 65 20 28  61 6e 79 6f 6e 65 20 77  |achine (anyone w|
00001c30  69 74 68 20 61 6e 20 20  75 6e 65 78 70 61 6e 64  |ith an  unexpand|
00001c40  65 64 20 41 33 30 35 20  2d 20 64 6f 6e 27 74 0a  |ed A305 - don't.|
00001c50  62 6f 74 68 65 72 21 29  20 62 75 74 20 49 20 63  |bother!) but I c|
00001c60  61 6e 6e 6f 74 20 72 65  61 6c 6c 79 20 73 75 67  |annot really sug|
00001c70  67 65 73 74 20 61 6e 79  74 68 69 6e 67 20 20 73  |gest anything  s|
00001c80  68 6f 72 74 20 6f 66 20  75 70 67 72 61 64 69 6e  |hort of upgradin|
00001c90  67 20 74 6f 20 32 0a 4d  62 79 74 65 73 20 28 6f  |g to 2.Mbytes (o|
00001ca0  74 68 65 72 20 74 68 61  6e 20 6d 61 6b 69 6e 67  |ther than making|
00001cb0  20 73 75 72 65 20 74 68  61 74 20 61 6c 6c 20 74  | sure that all t|
00001cc0  68 65 20 20 70 6f 73 73  69 62 6c 65 20 66 72 65  |he  possible fre|
00001cd0  65 20 6d 65 6d 6f 72 79  20 69 73 0a 61 76 61 69  |e memory is.avai|
00001ce0  6c 61 62 6c 65 20 74 6f  20 74 68 65 20 52 2e 4d  |lable to the R.M|
00001cf0  2e 41 2e 29 2e 20 57 68  65 6e 20 49 20 62 6f 75  |.A.). When I bou|
00001d00  67 68 74 20 6d 79 20 32  4d 62 79 74 65 20 52 41  |ght my 2Mbyte RA|
00001d10  4d 20 75 70 67 72 61 64  65 20 69 6e 20 44 65 63  |M upgrade in Dec|
00001d20  2e 20 31 39 38 39 0a 69  74 20 63 6f 73 74 20 a3  |. 1989.it cost .|
00001d30  31 35 30 20 2b 56 41 54  2e 20 4e 6f 77 20 69 74  |150 +VAT. Now it|
00001d40  20 63 61 6e 20 63 6f 73  74 20 61 73 20 6c 69 74  | can cost as lit|
00001d50  74 6c 65 20 61 73 20 61  20 74 68 69 72 64 20 6f  |tle as a third o|
00001d60  66 20 74 68 61 74 20 70  72 69 63 65 20 61 6e 64  |f that price and|
00001d70  20 69 73 0a 73 74 69 6c  6c 20 66 61 6c 6c 69 6e  | is.still fallin|
00001d80  67 2e 20 49 20 68 61 76  65 20 66 6f 75 6e 64 20  |g. I have found |
00001d90  69 74 20 76 65 72 79 20  75 73 65 66 75 6c 20 61  |it very useful a|
00001da0  6e 64 20 63 61 6e 20 72  65 63 6f 6d 6d 65 6e 64  |nd can recommend|
00001db0  20 69 74 20 74 6f 20 61  6e 79 20 75 73 65 72 73  | it to any users|
00001dc0  0a 6f 66 20 31 20 4d 62  79 74 65 20 41 33 30 30  |.of 1 Mbyte A300|
00001dd0  30 27 73 20 61 6e 64 20  41 34 31 30 27 73 20 77  |0's and A410's w|
00001de0  68 6f 20 75 73 65 20 74  68 65 69 72 20 63 6f 6d  |ho use their com|
00001df0  70 75 74 65 72 73 20 66  6f 72 20 6d 6f 72 65 20  |puters for more |
00001e00  74 68 61 6e 20 6a 75 73  74 0a 61 72 63 61 64 65  |than just.arcade|
00001e10  20 67 61 6d 65 73 2e 20  4f 74 68 65 72 20 66 69  | games. Other fi|
00001e20  6c 65 73 20 73 75 63 68  20 61 73 20 20 45 78 65  |les such as  Exe|
00001e30  63 20 61 6e 64 20 4f 62  65 79 20 66 69 6c 65 73  |c and Obey files|
00001e40  20 61 72 65 20 61 6c 73  6f 20 6f 70 65 6e 65 64  | are also opened|
00001e50  20 66 6f 72 0a 72 61 6e  64 6f 6d 20 61 63 63 65  | for.random acce|
00001e60  73 73 20 69 6e 70 75 74  20 62 75 74 20 74 68 65  |ss input but the|
00001e70  73 65 20 20 61 72 65 20  75 73 75 61 6c 6c 79 20  |se  are usually |
00001e80  73 68 6f 72 74 2e 0a 0a  55 73 65 20 77 69 74 68  |short...Use with|
00001e90  20 36 35 48 6f 73 74 20  61 6e 64 20 36 35 54 75  | 65Host and 65Tu|
00001ea0  62 65 0a 0a 41 72 63 46  53 20 63 61 6e 20 65 61  |be..ArcFS can ea|
00001eb0  73 69 6c 79 20 62 65 20  75 73 65 64 20 77 69 74  |sily be used wit|
00001ec0  68 20 36 35 48 6f 73 74  20 61 6e 64 20 36 35 54  |h 65Host and 65T|
00001ed0  75 62 65 2e 20 36 35 48  6f 73 74 20 75 73 65 72  |ube. 65Host user|
00001ee0  73 20 6d 75 73 74 20 6f  70 65 6e 20 74 68 65 0a  |s must open the.|
00001ef0  72 65 71 75 69 72 65 64  20 61 72 63 68 69 76 65  |required archive|
00001f00  20 62 65 66 6f 72 65 20  65 6e 74 65 72 69 6e 67  | before entering|
00001f10  20 74 68 65 20 65 6d 75  6c 61 74 6f 72 20 75 6e  | the emulator un|
00001f20  64 65 72 20 77 68 69 63  68 20 41 72 63 46 53 20  |der which ArcFS |
00001f30  69 73 20 73 65 6c 65 63  74 65 64 0a 62 79 3a 0a  |is selected.by:.|
00001f40  0a 20 20 20 20 2a 44 69  72 20 41 72 63 46 53 3a  |.    *Dir ArcFS:|
00001f50  0a 0a 44 46 53 20 65 6d  75 6c 61 74 69 6f 6e 73  |..DFS emulations|
00001f60  20 6d 61 79 20 61 6c 73  6f 20 62 65 20 73 65 74  | may also be set|
00001f70  20 75 70 20 69 6e 20 61  72 63 68 69 76 65 73 20  | up in archives |
00001f80  28 61 73 20 6f 6e 20 41  44 46 53 29 20 61 6e 64  |(as on ADFS) and|
00001f90  20 75 73 65 64 0a 75 6e  64 65 72 20 36 35 48 6f  | used.under 65Ho|
00001fa0  73 74 0a 0a 50 43 20 46  6f 72 6d 61 74 0a 0a 46  |st..PC Format..F|
00001fb0  69 6c 65 73 20 61 72 63  68 69 76 65 64 20 75 73  |iles archived us|
00001fc0  69 6e 67 20 50 43 20 46  6f 72 6d 61 74 20 69 6e  |ing PC Format in|
00001fd0  20 53 70 61 72 6b 20 6f  72 20 61 72 63 68 69 76  | Spark or archiv|
00001fe0  65 64 20 75 73 69 6e 67  20 53 45 41 20 61 72 63  |ed using SEA arc|
00001ff0  20 6f 72 20 50 4b 20 61  72 63 0a 6f 6e 20 61 20  | or PK arc.on a |
00002000  50 43 20 61 6c 6c 20 68  61 76 65 20 66 69 6c 65  |PC all have file|
00002010  20 74 79 70 65 20 26 31  31 31 2e 0a 0a 44 69 72  | type &111...Dir|
00002020  65 63 74 6f 72 79 20 6c  65 76 65 6c 73 0a 0a 55  |ectory levels..U|
00002030  70 20 74 6f 20 36 34 20  64 69 72 65 63 74 6f 72  |p to 64 director|
00002040  79 20 6c 65 76 65 6c 73  20 61 72 65 20 73 75 70  |y levels are sup|
00002050  70 6f 72 74 65 64 2e 20  49 6e 20 74 68 65 20 75  |ported. In the u|
00002060  6e 6c 69 6b 65 6c 79 20  65 76 65 6e 74 20 74 68  |nlikely event th|
00002070  61 74 20 6d 6f 72 65 0a  65 78 69 73 74 20 69 6e  |at more.exist in|
00002080  20 61 6e 20 61 72 63 68  69 76 65 20 66 75 72 74  | an archive furt|
00002090  68 65 72 20 73 75 62 64  69 72 65 63 74 6f 72 69  |her subdirectori|
000020a0  65 73 20 61 72 65 20 73  68 6f 77 6e 20 61 73 20  |es are shown as |
000020b0  61 72 63 68 69 76 65 73  2e 0a 0a 43 6f 6d 6d 61  |archives...Comma|
000020c0  6e 64 73 20 70 72 6f 76  69 64 65 64 3a 0a 0a 20  |nds provided:.. |
000020d0  20 20 20 2a 41 72 63 46  53 20 20 20 20 20 20 20  |   *ArcFS       |
000020e0  20 20 20 20 20 20 20 20  20 2d 20 73 65 6c 65 63  |         - selec|
000020f0  74 73 20 41 72 63 46 53  20 61 73 20 74 68 65 20  |ts ArcFS as the |
00002100  63 75 72 72 65 6e 74 20  66 69 6c 69 6e 67 20 73  |current filing s|
00002110  79 73 74 65 6d 0a 20 20  20 20 2a 4f 70 65 6e 41  |ystem.    *OpenA|
00002120  72 63 68 69 76 65 20 3c  4f 62 6a 65 63 74 3e 20  |rchive <Object> |
00002130  2d 20 4f 70 65 6e 73 20  61 6e 20 61 72 63 68 69  |- Opens an archi|
00002140  76 65 20 66 6f 72 20 66  69 6c 65 20 6f 70 65 72  |ve for file oper|
00002150  61 74 69 6f 6e 73 0a 20  20 20 20 2a 43 6c 6f 73  |ations.    *Clos|
00002160  65 41 72 63 68 69 76 65  20 20 20 20 20 20 20 20  |eArchive        |
00002170  20 2d 20 43 6c 6f 73 65  73 20 61 6e 79 20 6f 70  | - Closes any op|
00002180  65 6e 20 61 72 63 68 69  76 65 0a 0a 46 69 6c 69  |en archive..Fili|
00002190  6e 67 20 73 79 73 74 65  6d 20 63 6f 6d 6d 61 6e  |ng system comman|
000021a0  64 73 3a 0a 0a 20 20 20  20 2a 42 61 63 6b 20 20  |ds:..    *Back  |
000021b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 2d  |               -|
000021c0  20 73 77 61 70 73 20 74  68 65 20 63 75 72 72 65  | swaps the curre|
000021d0  6e 74 6c 79 20 61 6e 64  20 70 72 65 76 69 6f 75  |ntly and previou|
000021e0  73 6c 79 20 73 65 6c 65  63 74 65 64 20 20 20 20  |sly selected    |
000021f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002200  20 20 20 20 20 20 20 20  20 20 20 20 20 20 64 69  |              di|
00002210  72 65 63 74 6f 72 69 65  73 20 28 43 53 44 20 61  |rectories (CSD a|
00002220  6e 64 20 50 53 44 29 0a  20 20 20 20 2a 55 52 44  |nd PSD).    *URD|
00002230  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002240  20 20 2d 20 73 65 6c 65  63 74 73 20 74 68 65 20  |  - selects the |
00002250  75 73 65 72 20 72 6f 6f  74 20 64 69 72 65 63 74  |user root direct|
00002260  6f 72 79 20 28 55 52 44  29 0a 20 20 20 20 2a 47  |ory (URD).    *G|
00002270  61 72 62 6c 65 20 3c 50  61 73 73 57 6f 72 64 3e  |arble <PassWord>|
00002280  20 20 20 20 2d 20 4c 6f  61 64 73 20 66 69 6c 65  |    - Loads file|
00002290  73 20 67 61 72 62 6c 65  64 20 77 69 74 68 20 61  |s garbled with a|
000022a0  20 70 61 73 73 77 6f 72  64 0a 20 20 20 20 2a 4e  | password.    *N|
000022b0  6f 45 6e 63 72 79 70 74  69 6f 6e 20 20 20 20 20  |oEncryption     |
000022c0  20 20 20 20 2d 20 4c 6f  61 64 73 20 66 69 6c 65  |    - Loads file|
000022d0  73 20 77 69 74 68 20 6e  6f 20 65 6e 63 72 79 70  |s with no encryp|
000022e0  74 69 6f 6e 0a 0a 0a 46  69 6c 65 20 65 6e 63 72  |tion...File encr|
000022f0  79 70 74 69 6f 6e 0a 0a  54 68 69 73 20 76 65 72  |yption..This ver|
00002300  73 69 6f 6e 20 73 75 70  70 6f 72 74 73 20 67 61  |sion supports ga|
00002310  72 62 6c 65 64 20 66 69  6c 65 73 2e 20 49 6e 63  |rbled files. Inc|
00002320  6f 72 72 65 63 74 20 70  61 73 73 77 6f 72 64 73  |orrect passwords|
00002330  2c 20 75 73 65 20 6f 66  20 47 61 72 62 6c 65 20  |, use of Garble |
00002340  66 6f 72 0a 66 69 6c 65  73 20 77 69 74 68 20 6e  |for.files with n|
00002350  6f 20 65 6e 63 72 79 70  74 69 6f 6e 20 6f 72 20  |o encryption or |
00002360  74 72 79 69 6e 67 20 74  6f 20 6c 6f 61 64 20 67  |trying to load g|
00002370  61 72 62 6c 65 64 20 66  69 6c 65 73 20 68 61 76  |arbled files hav|
00002380  69 6e 67 20 73 65 74 20  41 72 63 46 53 20 74 6f  |ing set ArcFS to|
00002390  0a 6c 6f 61 64 20 66 69  6c 65 73 20 77 69 74 68  |.load files with|
000023a0  20 6e 6f 20 65 6e 63 72  79 70 74 69 6f 6e 20 77  | no encryption w|
000023b0  69 6c 6c 20 72 65 73 75  6c 74 20 69 6e 20 61 20  |ill result in a |
000023c0  27 44 61 74 61 20 43 6f  72 72 75 70 74 27 20 65  |'Data Corrupt' e|
000023d0  72 72 6f 72 2e 20 54 68  69 73 0a 77 69 6c 6c 20  |rror. This.will |
000023e0  61 6c 73 6f 20 6f 63 63  75 72 20 69 66 20 64 61  |also occur if da|
000023f0  74 61 20 69 6e 20 61 6e  20 61 72 63 68 69 76 65  |ta in an archive|
00002400  20 62 65 63 6f 6d 65 73  20 63 6f 72 72 75 70 74  | becomes corrupt|
00002410  65 64 2e 0a 0a 41 72 63  46 53 20 46 69 6c 65 72  |ed...ArcFS Filer|
00002420  0a 0a 54 68 65 20 41 72  63 46 53 20 66 69 6c 65  |..The ArcFS file|
00002430  72 20 69 73 20 70 72 6f  76 69 64 65 64 20 73 6f  |r is provided so|
00002440  20 74 68 61 74 20 64 69  72 65 63 74 6f 72 69 65  | that directorie|
00002450  73 20 6d 61 79 20 62 65  20 64 69 73 70 6c 61 79  |s may be display|
00002460  65 64 20 69 6e 20 6e 6f  72 6d 61 6c 0a 66 69 6c  |ed in normal.fil|
00002470  65 72 20 77 69 6e 64 6f  77 73 2e 20 41 72 63 68  |er windows. Arch|
00002480  69 76 65 73 20 61 72 65  20 6f 70 65 6e 65 64 20  |ives are opened |
00002490  62 79 20 64 6f 75 62 6c  65 20 63 6c 69 63 6b 69  |by double clicki|
000024a0  6e 67 20 74 68 65 6d 20  6f 72 20 64 72 61 67 67  |ng them or dragg|
000024b0  69 6e 67 20 74 68 65 6d  0a 74 6f 20 74 68 65 20  |ing them.to the |
000024c0  41 72 63 46 53 20 69 63  6f 6e 2e 20 54 68 65 20  |ArcFS icon. The |
000024d0  72 6f 6f 74 20 64 69 72  65 63 74 6f 72 79 20 6f  |root directory o|
000024e0  66 20 74 68 65 20 6d 6f  73 74 20 72 65 63 65 6e  |f the most recen|
000024f0  74 6c 79 20 6f 70 65 6e  65 64 20 61 72 63 68 69  |tly opened archi|
00002500  76 65 0a 6d 61 79 20 62  65 20 64 69 73 70 6c 61  |ve.may be displa|
00002510  79 65 64 20 62 79 20 63  6c 69 63 6b 69 6e 67 20  |yed by clicking |
00002520  6f 6e 20 74 68 65 20 69  63 6f 6e 2e 20 41 20 6d  |on the icon. A m|
00002530  65 6e 75 20 69 73 20 70  72 6f 76 69 64 65 64 20  |enu is provided |
00002540  77 69 74 68 20 66 6f 75  72 0a 6f 70 74 69 6f 6e  |with four.option|
00002550  73 3a 0a 0a 45 6e 63 72  79 70 74 69 6f 6e 2d 20  |s:..Encryption- |
00002560  53 65 74 73 20 74 68 65  20 65 6e 63 72 79 70 74  |Sets the encrypt|
00002570  69 6f 6e 20 6d 65 74 68  6f 64 20 61 6e 64 20 70  |ion method and p|
00002580  61 73 73 77 6f 72 64 20  28 69 66 20 61 6e 79 29  |assword (if any)|
00002590  20 74 68 61 74 20 69 73  20 75 73 65 64 2e 20 20  | that is used.  |
000025a0  20 20 20 20 20 20 20 20  20 20 20 20 20 54 68 65  |             The|
000025b0  20 73 75 62 64 69 72 65  63 74 6f 72 79 20 68 61  | subdirectory ha|
000025c0  73 20 6f 70 74 69 6f 6e  73 20 66 6f 72 20 6e 6f  |s options for no|
000025d0  20 65 6e 63 72 79 70 74  69 6f 6e 20 61 6e 64 20  | encryption and |
000025e0  67 61 72 62 6c 65 2e 20  44 45 53 20 20 20 20 20  |garble. DES     |
000025f0  20 20 20 20 20 20 20 20  20 20 65 6e 63 72 79 70  |          encryp|
00002600  74 69 6f 6e 20 69 73 20  6e 6f 74 20 61 76 61 69  |tion is not avai|
00002610  6c 61 62 6c 65 20 69 6e  20 74 68 69 73 20 76 65  |lable in this ve|
00002620  72 73 69 6f 6e 20 61 6e  64 20 73 6f 20 69 73 20  |rsion and so is |
00002630  73 68 61 64 65 64 2e 0a  0a 43 6c 6f 73 65 20 61  |shaded...Close a|
00002640  72 63 20 2d 20 43 6c 6f  73 65 73 20 74 68 65 20  |rc - Closes the |
00002650  63 75 72 72 65 6e 74 6c  79 20 6f 70 65 6e 20 61  |currently open a|
00002660  72 63 68 69 76 65 20 61  6e 64 20 61 6c 6c 20 61  |rchive and all a|
00002670  72 63 66 73 20 64 69 72  65 63 74 6f 72 79 0a 20  |rcfs directory. |
00002680  20 20 20 20 20 20 20 20  20 20 20 77 69 6e 64 6f  |           windo|
00002690  77 73 2e 0a 0a 4b 69 6c  6c 20 20 20 20 20 20 2d  |ws...Kill      -|
000026a0  20 43 6c 6f 73 65 73 20  74 68 65 20 63 75 72 72  | Closes the curr|
000026b0  65 6e 74 20 61 72 63 68  69 76 65 2c 20 72 65 6d  |ent archive, rem|
000026c0  6f 76 65 73 20 61 6c 6c  20 61 72 63 66 73 20 64  |oves all arcfs d|
000026d0  69 72 65 63 74 6f 72 79  20 77 69 6e 64 6f 77 73  |irectory windows|
000026e0  2c 0a 20 20 20 20 20 20  20 20 20 20 20 20 4b 69  |,.            Ki|
000026f0  6c 6c 73 20 74 68 65 20  41 72 63 46 53 20 6d 6f  |lls the ArcFS mo|
00002700  64 75 6c 65 20 61 6e 64  20 51 75 69 74 73 20 74  |dule and Quits t|
00002710  68 65 20 41 72 63 46 53  20 46 69 6c 65 72 2e 0a  |he ArcFS Filer..|
00002720  0a 51 75 69 74 20 20 20  20 20 20 2d 20 51 75 69  |.Quit      - Qui|
00002730  74 73 20 74 68 65 20 41  72 63 46 53 20 46 69 6c  |ts the ArcFS Fil|
00002740  65 72 2e 0a 0a 4b 69 6c  6c 20 61 6e 64 20 51 75  |er...Kill and Qu|
00002750  69 74 20 62 6f 74 68 20  70 72 6f 6d 70 74 20 66  |it both prompt f|
00002760  6f 72 20 63 6f 6e 66 69  72 6d 61 74 69 6f 6e 2e  |or confirmation.|
00002770  20 43 6c 69 63 6b 20 6f  6e 20 4f 4b 20 74 6f 20  | Click on OK to |
00002780  4b 69 6c 6c 2f 51 75 69  74 20 6f 72 0a 43 61 6e  |Kill/Quit or.Can|
00002790  63 65 6c 20 6f 74 68 65  72 77 69 73 65 2e 20 4e  |cel otherwise. N|
000027a0  6f 74 65 20 70 72 65 73  73 69 6e 67 20 65 73 63  |ote pressing esc|
000027b0  61 70 65 20 68 61 73 20  74 68 65 20 73 61 6d 65  |ape has the same|
000027c0  20 65 66 66 65 63 74 20  61 73 20 63 6c 69 63 6b  | effect as click|
000027d0  69 6e 67 20 6f 6e 20 4f  4b 2e 0a 0a 0a 41 6c 6c  |ing on OK....All|
000027e0  20 63 6f 6d 6d 65 6e 74  73 20 61 6e 64 20 73 75  | comments and su|
000027f0  67 67 65 73 74 69 6f 6e  73 20 66 6f 72 20 66 75  |ggestions for fu|
00002800  74 75 72 65 20 69 6d 70  72 6f 76 65 6d 65 6e 74  |ture improvement|
00002810  20 61 72 65 20 77 65 6c  63 6f 6d 65 20 62 75 74  | are welcome but|
00002820  20 70 6c 65 61 73 65 0a  6e 6f 74 65 20 74 68 61  | please.note tha|
00002830  74 20 49 20 63 61 6e 6e  6f 74 20 72 65 70 6c 79  |t I cannot reply|
00002840  20 74 6f 20 6c 65 74 74  65 72 73 20 77 69 74 68  | to letters with|
00002850  6f 75 74 20 72 65 74 75  72 6e 20 70 6f 73 74 61  |out return posta|
00002860  67 65 20 61 6e 64 20 61  6e 20 61 64 64 72 65 73  |ge and an addres|
00002870  73 65 64 0a 65 6e 76 65  6c 6f 70 65 2e 0a 0a 54  |sed.envelope...T|
00002880  68 65 20 61 64 64 72 65  73 73 20 69 73 3a 0a 0a  |he address is:..|
00002890  20 20 20 20 4d 72 2e 20  4d 2e 20 53 6d 69 74 68  |    Mr. M. Smith|
000028a0  0a 20 20 20 20 50 65 6e  2d 79 2d 64 72 65 2c 0a  |.    Pen-y-dre,.|
000028b0  20 20 20 20 52 69 76 65  72 73 69 64 65 20 41 76  |    Riverside Av|
000028c0  65 2e 2c 0a 20 20 20 20  42 72 6f 78 62 6f 75 72  |e.,.    Broxbour|
000028d0  6e 65 2c 0a 20 20 20 20  48 65 72 74 73 2e 2c 0a  |ne,.    Herts.,.|
000028e0  20 20 20 20 45 4e 31 30  20 36 52 44 2e 0a 0a 49  |    EN10 6RD...I|
000028f0  20 77 6f 75 6c 64 20 61  6c 73 6f 2c 20 6f 66 20  | would also, of |
00002900  63 6f 75 72 73 65 20 77  65 6c 63 6f 6d 65 20 64  |course welcome d|
00002910  65 74 61 69 6c 73 20 6f  66 20 61 6e 79 20 62 75  |etails of any bu|
00002920  67 73 20 64 69 73 63 6f  76 65 72 65 64 20 73 6f  |gs discovered so|
00002930  20 74 68 61 74 20 49 20  63 61 6e 0a 63 6f 72 72  | that I can.corr|
00002940  65 63 74 20 74 68 65 6d  2e 0a 0a 56 65 72 73 69  |ect them...Versi|
00002950  6f 6e 20 49 6d 70 72 6f  76 65 6d 65 6e 74 73 0a  |on Improvements.|
00002960  0a 76 30 2e 32 30 20 46  69 72 73 74 20 52 65 6c  |.v0.20 First Rel|
00002970  65 61 73 65 20 76 65 72  73 69 6f 6e 0a 76 30 2e  |ease version.v0.|
00002980  32 31 20 4d 61 78 20 6e  75 6d 62 65 72 20 6f 66  |21 Max number of|
00002990  20 64 69 72 65 63 74 6f  72 79 20 6c 65 76 65 6c  | directory level|
000029a0  73 20 69 6e 63 72 65 61  73 65 64 20 66 72 6f 6d  |s increased from|
000029b0  20 31 36 20 74 6f 20 36  34 2c 20 73 6f 6d 65 20  | 16 to 64, some |
000029c0  74 69 64 79 69 6e 67 0a  76 30 2e 32 32 20 53 6e  |tidying.v0.22 Sn|
000029d0  6f 77 65 64 20 69 6e 20  38 74 68 20 46 65 62 20  |owed in 8th Feb |
000029e0  39 31 20 73 6f 20 6d 61  64 65 20 65 78 74 65 6e  |91 so made exten|
000029f0  73 69 76 65 20 63 68 61  6e 67 65 73 3a 20 55 52  |sive changes: UR|
00002a00  44 20 61 6e 64 20 50 53  44 20 6e 6f 77 20 20 20  |D and PSD now   |
00002a10  20 20 20 20 20 20 20 20  20 20 20 73 75 70 70 6f  |           suppo|
00002a20  72 74 65 64 2e 20 43 6f  6d 6d 61 6e 64 73 20 2a  |rted. Commands *|
00002a30  42 61 63 6b 20 61 6e 64  20 2a 55 52 44 20 70 72  |Back and *URD pr|
00002a40  6f 76 69 64 65 64 2e 20  2a 46 69 6c 65 49 6e 66  |ovided. *FileInf|
00002a50  6f 20 63 6f 6d 6d 61 6e  64 20 61 64 64 65 64 2e  |o command added.|
00002a60  20 20 20 20 20 20 20 20  43 6f 6d 70 72 65 73 73  |        Compress|
00002a70  69 6f 6e 20 66 6f 72 6d  61 74 20 72 65 6d 6f 76  |ion format remov|
00002a80  65 64 20 66 72 6f 6d 20  2a 49 6e 66 6f 20 61 6e  |ed from *Info an|
00002a90  64 20 2a 45 58 20 6f 75  74 70 75 74 20 28 6e 6f  |d *EX output (no|
00002aa0  77 20 67 69 76 65 6e 20  62 79 20 20 20 20 20 20  |w given by      |
00002ab0  20 20 20 20 20 2a 46 69  6c 65 49 6e 66 6f 29 2e  |     *FileInfo).|
00002ac0  20 2a 49 6e 66 6f 20 26  20 2a 46 69 6c 65 49 6e  | *Info & *FileIn|
00002ad0  66 6f 20 6e 6f 77 20 67  69 76 65 20 69 6e 66 6f  |fo now give info|
00002ae0  72 6d 61 74 69 6f 6e 20  6f 6e 20 6d 75 6c 74 69  |rmation on multi|
00002af0  70 6c 65 20 20 20 20 20  20 20 20 20 20 20 20 20  |ple             |
00002b00  20 20 77 69 6c 64 63 61  72 64 65 64 20 66 69 6c  |  wildcarded fil|
00002b10  65 73 2e 20 43 6f 6d 70  72 65 73 73 65 64 20 66  |es. Compressed f|
00002b20  69 6c 65 20 73 69 7a 65  20 6e 6f 77 20 73 74 6f  |ile size now sto|
00002b30  72 65 64 20 69 6e 20 74  68 65 20 74 6f 70 20 32  |red in the top 2|
00002b40  34 20 62 69 74 73 20 6f  66 20 20 20 20 20 20 74  |4 bits of      t|
00002b50  68 65 20 66 69 6c 65 20  61 74 74 72 69 62 75 74  |he file attribut|
00002b60  65 73 2e 20 50 43 20 66  6f 72 6d 61 74 20 66 69  |es. PC format fi|
00002b70  6c 65 73 20 61 72 65 20  6e 6f 77 20 73 75 70 70  |les are now supp|
00002b80  6f 72 74 65 64 2e 20 53  75 70 70 6c 69 65 64 20  |orted. Supplied |
00002b90  77 69 74 68 20 20 20 20  20 20 20 20 6e 65 77 20  |with        new |
00002ba0  41 72 63 46 53 20 46 69  6c 65 72 20 77 69 74 68  |ArcFS Filer with|
00002bb0  20 69 63 6f 6e 20 61 6e  64 20 6d 65 6e 75 2e 0a  | icon and menu..|
00002bc0  76 30 2e 32 33 20 43 6f  72 72 65 63 74 65 64 20  |v0.23 Corrected |
00002bd0  32 20 62 75 67 73 20 2d  20 41 72 63 46 53 20 64  |2 bugs - ArcFS d|
00002be0  69 64 20 6e 6f 74 20 72  65 6c 65 61 73 65 20 31  |id not release 1|
00002bf0  36 6b 20 6f 66 20 63 6c  61 69 6d 65 64 20 6d 65  |6k of claimed me|
00002c00  6d 6f 72 79 20 77 68 65  6e 20 61 6e 20 20 20 20  |mory when an    |
00002c10  20 20 20 65 72 72 6f 72  20 6f 63 63 75 72 65 64  |   error occured|
00002c20  20 64 75 72 69 6e 67 20  74 68 65 20 6c 6f 61 64  | during the load|
00002c30  20 63 72 75 6e 63 68 20  72 6f 75 74 69 6e 65 2e  | crunch routine.|
00002c40  20 49 66 20 79 6f 75 20  63 61 6e 63 65 6c 6c 65  | If you cancelle|
00002c50  64 20 61 20 20 20 20 20  20 20 20 20 20 20 20 20  |d a             |
00002c60  72 65 71 75 65 73 74 20  66 72 6f 6d 20 74 68 65  |request from the|
00002c70  20 6c 6f 61 64 20 70 61  63 6b 20 72 6f 75 74 69  | load pack routi|
00002c80  6e 65 20 74 6f 20 69 6e  73 65 72 74 20 61 20 64  |ne to insert a d|
00002c90  69 73 6b 20 74 68 65 20  72 65 71 75 65 73 74 20  |isk the request |
00002ca0  77 61 73 20 20 20 20 20  20 20 20 20 20 72 65 70  |was          rep|
00002cb0  65 61 74 65 64 20 61 20  73 65 63 6f 6e 64 20 74  |eated a second t|
00002cc0  69 6d 65 2e 0a 76 30 2e  33 30 20 4e 6f 77 20 61  |ime..v0.30 Now a|
00002cd0  64 64 65 64 20 73 75 70  70 6f 72 74 20 66 6f 72  |dded support for|
00002ce0  20 73 71 75 61 73 68 65  64 20 61 6e 64 20 63 6f  | squashed and co|
00002cf0  6d 70 72 65 73 73 65 64  20 66 6f 72 6d 61 74 73  |mpressed formats|
00002d00  2e 20 41 6c 73 6f 20 61  64 64 65 64 20 20 20 20  |. Also added    |
00002d10  20 20 20 20 20 20 20 20  73 75 70 70 6f 72 74 20  |        support |
00002d20  66 6f 72 20 47 61 72 62  6c 65 64 20 66 69 6c 65  |for Garbled file|
00002d30  73 2c 20 2a 47 61 72 62  6c 65 20 61 6e 64 20 2a  |s, *Garble and *|
00002d40  4e 6f 45 6e 63 72 79 70  74 69 6f 6e 20 63 6f 6d  |NoEncryption com|
00002d50  6d 61 6e 64 73 20 70 72  6f 76 69 64 65 64 2e 20  |mands provided. |
00002d60  20 20 20 20 20 43 6f 6d  70 72 65 68 65 6e 73 69  |     Comprehensi|
00002d70  76 65 20 65 72 72 6f 72  20 63 68 65 63 6b 69 6e  |ve error checkin|
00002d80  67 20 63 68 65 63 6b 73  20 66 6f 72 20 63 6f 72  |g checks for cor|
00002d90  72 75 70 74 65 64 20 64  61 74 61 20 61 6e 64 2f  |rupted data and/|
00002da0  6f 72 20 70 61 73 73 77  6f 72 64 73 20 20 20 20  |or passwords    |
00002db0  20 20 61 6e 64 20 66 69  6c 65 20 65 6e 63 72 79  |  and file encry|
00002dc0  70 74 69 6f 6e 20 6d 65  74 68 6f 64 73 20 69 6e  |ption methods in|
00002dd0  63 6f 6e 73 69 73 74 65  6e 74 20 77 69 74 68 20  |consistent with |
00002de0  74 68 6f 73 65 20 74 68  61 74 20 68 61 76 65 20  |those that have |
00002df0  62 65 65 6e 20 73 65 74  2e 0a 0a a9 20 31 39 39  |been set.... 199|
00002e00  31 20 4d 2e 20 53 6d 69  74 68                    |1 M. Smith|
00002e0a