Home » Archimedes archive » Micro User » MU 1991-10.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 » Micro User » MU 1991-10.adf » !ArcFS_!Help
Filename: !Help
Read OK:
File size: 2E0B bytes
Load address: 0000
Exec address: 0000
Duplicates

There is 1 duplicate copy of this file in the archive:

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 course, 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 6f 75 72 73 65 2c 20  |can, of course, |
000004d0  61 6c 73 6f 20 62 65 20  75 73 65 64 20 66 72 6f  |also be used fro|
000004e0  6d 20 0a 74 68 65 20 63  6f 6d 6d 61 6e 64 20 6c  |m .the command l|
000004f0  69 6e 65 2e 0a 0a 59 6f  75 20 6d 61 79 20 6e 6f  |ine...You may no|
00000500  74 69 63 65 20 61 20 73  6d 61 6c 6c 20 69 6e 63  |tice a small inc|
00000510  72 65 61 73 65 20 69 6e  20 74 68 65 20 74 69 6d  |rease in the tim|
00000520  65 20 74 61 6b 65 6e 20  74 6f 20 6c 6f 61 64 20  |e taken to load |
00000530  66 69 6c 65 73 20 0a 63  6f 6d 70 61 72 65 64 20  |files .compared |
00000540  74 6f 20 6c 6f 61 64 69  6e 67 20 66 69 6c 65 73  |to loading files|
00000550  20 66 72 6f 6d 20 41 44  46 53 20 61 6e 64 20 61  | from ADFS and a|
00000560  6c 73 6f 20 74 68 61 74  20 41 72 63 46 53 20 74  |lso that ArcFS t|
00000570  61 6b 65 73 20 61 20 73  68 6f 72 74 20 0a 74 69  |akes a short .ti|
00000580  6d 65 20 74 6f 20 4f 70  65 6e 20 41 72 63 68 69  |me to Open Archi|
00000590  76 65 73 20 77 68 65 6e  20 74 68 65 79 20 61 72  |ves when they ar|
000005a0  65 20 64 6f 75 62 6c 65  20 63 6c 69 63 6b 65 64  |e double clicked|
000005b0  2e 20 0a 0a 0a 41 72 63  46 53 20 73 75 70 70 6f  |. ...ArcFS suppo|
000005c0  72 74 73 20 74 68 65 20  66 6f 6c 6c 6f 77 69 6e  |rts the followin|
000005d0  67 20 65 6e 74 72 79 20  70 6f 69 6e 74 73 3a 0a  |g entry points:.|
000005e0  0a 20 20 20 20 46 53 45  6e 74 72 79 5f 46 75 6e  |.    FSEntry_Fun|
000005f0  63 20 30 20 74 6f 20 73  65 74 20 63 75 72 72 65  |c 0 to set curre|
00000600  6e 74 20 64 69 72 65 63  74 6f 72 79 20 28 2a 44  |nt directory (*D|
00000610  69 72 29 0a 0a 20 20 20  20 46 53 45 6e 74 72 79  |ir)..    FSEntry|
00000620  5f 46 75 6e 63 20 31 20  74 6f 20 73 65 74 20 6c  |_Func 1 to set l|
00000630  69 62 72 61 72 79 20 64  69 72 65 63 74 6f 72 79  |ibrary directory|
00000640  20 28 2a 4c 69 62 29 0a  0a 20 20 20 20 46 53 45  | (*Lib)..    FSE|
00000650  6e 74 72 79 5f 46 75 6e  63 20 32 20 74 6f 20 63  |ntry_Func 2 to c|
00000660  61 74 61 6c 6f 67 75 65  20 64 69 72 65 63 74 6f  |atalogue directo|
00000670  72 79 20 28 2a 43 61 74  29 0a 0a 20 20 20 20 46  |ry (*Cat)..    F|
00000680  53 45 6e 74 72 79 5f 46  75 6e 63 20 33 20 74 6f  |SEntry_Func 3 to|
00000690  20 65 78 61 6d 69 6e 65  20 64 69 72 65 63 74 6f  | examine directo|
000006a0  72 79 20 28 2a 45 58 29  0a 0a 20 20 20 20 46 53  |ry (*EX)..    FS|
000006b0  45 6e 74 72 79 5f 46 75  6e 63 20 34 20 74 6f 20  |Entry_Func 4 to |
000006c0  63 61 74 61 6c 6f 67 75  65 20 6c 69 62 72 61 72  |catalogue librar|
000006d0  79 20 64 69 72 65 63 74  6f 72 79 20 28 2a 4c 43  |y directory (*LC|
000006e0  61 74 29 0a 0a 20 20 20  20 46 53 45 6e 74 72 79  |at)..    FSEntry|
000006f0  5f 46 75 6e 63 20 35 20  74 6f 20 65 78 61 6d 69  |_Func 5 to exami|
00000700  6e 65 20 6c 69 62 72 61  72 79 20 64 69 72 65 63  |ne library direc|
00000710  74 6f 72 79 20 28 2a 4c  45 58 29 0a 0a 20 20 20  |tory (*LEX)..   |
00000720  20 46 53 45 6e 74 72 79  5f 46 75 6e 63 20 36 20  | FSEntry_Func 6 |
00000730  74 6f 20 65 78 61 6d 69  6e 65 20 6f 62 6a 65 63  |to examine objec|
00000740  74 73 20 28 2a 49 6e 66  6f 29 2e 0a 0a 20 20 20  |ts (*Info)...   |
00000750  20 46 53 45 6e 74 72 79  5f 46 75 6e 63 20 31 35  | FSEntry_Func 15|
00000760  20 74 6f 20 72 65 73 70  6f 6e 64 20 74 6f 20 72  | to respond to r|
00000770  65 71 75 65 73 74 73 20  66 72 6f 6d 20 74 68 65  |equests from the|
00000780  20 46 69 6c 65 72 20 66  6f 72 20 0a 20 20 20 20  | Filer for .    |
00000790  74 68 65 20 6e 65 63 65  73 73 61 72 79 20 69 6e  |the necessary in|
000007a0  66 6f 72 6d 61 74 69 6f  6e 20 74 6f 20 64 69 73  |formation to dis|
000007b0  70 6c 61 79 20 61 20 64  69 72 65 63 74 6f 72 79  |play a directory|
000007c0  20 77 69 6e 64 6f 77 0a  0a 20 20 20 20 46 53 45  | window..    FSE|
000007d0  6e 74 72 79 5f 46 75 6e  63 20 32 30 20 74 6f 20  |ntry_Func 20 to |
000007e0  67 69 76 65 20 66 75 6c  6c 20 69 6e 66 6f 72 6d  |give full inform|
000007f0  61 74 69 6f 6e 20 6f 6e  20 6f 62 6a 65 63 74 73  |ation on objects|
00000800  20 28 2a 46 69 6c 65 49  6e 66 6f 29 0a 0a 20 20  | (*FileInfo)..  |
00000810  20 20 46 53 45 6e 74 72  79 5f 46 69 6c 65 20 35  |  FSEntry_File 5|
00000820  20 74 6f 20 72 65 61 64  20 63 61 74 61 6c 6f 67  | to read catalog|
00000830  75 65 20 69 6e 66 6f 72  6d 61 74 69 6f 6e 20 6f  |ue information o|
00000840  6e 20 61 20 66 69 6c 65  0a 0a 20 20 20 20 46 53  |n a file..    FS|
00000850  45 6e 74 72 79 5f 46 69  6c 65 20 32 35 35 20 74  |Entry_File 255 t|
00000860  6f 20 6c 6f 61 64 20 66  69 6c 65 73 0a 0a 20 20  |o load files..  |
00000870  20 20 46 53 45 6e 74 72  79 5f 4f 70 65 6e 20 74  |  FSEntry_Open t|
00000880  6f 20 70 72 6f 76 69 64  65 20 66 61 63 69 6c 69  |o provide facili|
00000890  74 69 65 73 20 66 6f 72  20 6f 70 65 6e 69 6e 67  |ties for opening|
000008a0  20 66 69 6c 65 73 20 66  6f 72 20 0a 20 20 20 20  | files for .    |
000008b0  72 61 6e 64 6f 6d 20 61  63 63 65 73 73 20 69 6e  |random access in|
000008c0  70 75 74 2e 20 41 72 63  46 53 20 63 6c 61 69 6d  |put. ArcFS claim|
000008d0  73 20 6d 65 6d 6f 72 79  20 66 72 6f 6d 20 74 68  |s memory from th|
000008e0  65 20 52 2e 4d 2e 41 2e  20 0a 20 20 20 20 74 68  |e R.M.A. .    th|
000008f0  65 20 73 69 7a 65 20 6f  66 20 74 68 65 20 75 6e  |e size of the un|
00000900  63 6f 6d 70 72 65 73 73  65 64 20 66 69 6c 65 20  |compressed file |
00000910  61 6e 64 20 74 68 65 20  6c 6f 61 64 73 20 74 68  |and the loads th|
00000920  65 20 66 69 6c 65 20 0a  20 20 20 20 69 6e 74 6f  |e file .    into|
00000930  20 74 68 69 73 20 63 6c  61 69 6d 65 64 20 6d 65  | this claimed me|
00000940  6d 6f 72 79 2e 20 46 6f  72 20 74 68 69 73 20 72  |mory. For this r|
00000950  65 61 73 6f 6e 20 69 74  20 69 73 20 70 6f 73 73  |eason it is poss|
00000960  69 62 6c 65 20 74 6f 20  0a 20 20 20 20 67 65 74  |ible to .    get|
00000970  20 27 4e 6f 20 52 6f 6f  6d 20 69 6e 20 52 4d 41  | 'No Room in RMA|
00000980  20 65 72 72 6f 72 73 27  20 77 68 65 6e 20 6f 70  | errors' when op|
00000990  65 6e 69 6e 67 20 6c 61  72 67 65 20 66 69 6c 65  |ening large file|
000009a0  73 2e 0a 0a 20 20 20 20  46 53 45 6e 74 72 79 5f  |s...    FSEntry_|
000009b0  47 65 74 42 79 74 65 73  20 72 65 61 64 73 20 72  |GetBytes reads r|
000009c0  65 71 75 69 72 65 64 20  62 79 74 65 73 20 66 72  |equired bytes fr|
000009d0  6f 6d 20 6d 65 6d 6f 72  79 20 63 6c 61 69 6d 65  |om memory claime|
000009e0  64 20 0a 20 20 20 20 62  79 20 46 53 45 6e 74 72  |d .    by FSEntr|
000009f0  79 5f 4f 70 65 6e 0a 0a  20 20 20 20 46 53 45 6e  |y_Open..    FSEn|
00000a00  74 72 79 5f 43 6c 6f 73  65 20 72 65 6c 65 61 73  |try_Close releas|
00000a10  65 73 20 6d 65 6d 6f 72  79 20 63 6c 61 69 6d 65  |es memory claime|
00000a20  64 20 62 79 20 46 53 45  6e 74 72 79 5f 4f 70 65  |d by FSEntry_Ope|
00000a30  6e 0a 0a 0a 43 61 74 61  6c 6f 67 75 65 20 53 74  |n...Catalogue St|
00000a40  6f 72 61 67 65 20 69 6e  20 6d 65 6d 6f 72 79 0a  |orage in memory.|
00000a50  0a 57 68 65 6e 20 61 6e  20 61 72 63 68 69 76 65  |.When an archive|
00000a60  20 69 73 20 6f 70 65 6e  65 64 20 74 68 65 20 6e  | is opened the n|
00000a70  75 6d 62 65 72 20 6f 66  20 6f 62 6a 65 63 74 73  |umber of objects|
00000a80  20 69 6e 20 74 68 65 20  61 72 63 68 69 76 65 20  | in the archive |
00000a90  69 73 20 0a 63 6f 75 6e  74 65 64 20 61 6e 64 20  |is .counted and |
00000aa0  61 20 62 6c 6f 63 6b 20  6f 66 20 52 2e 4d 2e 41  |a block of R.M.A|
00000ab0  2e 2c 20 33 32 20 62 79  74 65 73 20 66 6f 72 20  |., 32 bytes for |
00000ac0  65 61 63 68 20 6f 62 6a  65 63 74 20 69 73 20 63  |each object is c|
00000ad0  6c 61 69 6d 65 64 20 61  6e 64 20 0a 74 68 65 20  |laimed and .the |
00000ae0  63 61 74 61 6c 6f 67 75  65 20 69 6e 66 6f 72 6d  |catalogue inform|
00000af0  61 74 69 6f 6e 20 69 73  20 72 65 61 64 20 69 6e  |ation is read in|
00000b00  74 6f 20 74 68 69 73 20  62 6c 6f 63 6b 0a 0a 43  |to this block..C|
00000b10  6f 6d 70 72 65 73 73 69  6f 6e 20 66 6f 72 6d 61  |ompression forma|
00000b20  74 73 0a 0a 54 68 69 73  20 76 65 72 73 69 6f 6e  |ts..This version|
00000b30  20 6f 66 20 41 72 63 46  53 20 73 75 70 70 6f 72  | of ArcFS suppor|
00000b40  74 73 20 63 72 75 6e 63  68 65 64 2c 20 70 61 63  |ts crunched, pac|
00000b50  6b 65 64 2c 20 6e 65 77  20 66 6f 72 6d 61 74 20  |ked, new format |
00000b60  73 74 6f 72 65 64 0a 6f  62 6a 65 63 74 73 2c 20  |stored.objects, |
00000b70  73 71 75 61 73 68 65 64  20 61 6e 64 20 63 6f 6d  |squashed and com|
00000b80  70 72 65 73 73 65 64 20  6f 62 6a 65 63 74 73 2e  |pressed objects.|
00000b90  20 4f 62 6a 65 63 74 73  20 69 6e 20 61 20 66 6f  | Objects in a fo|
00000ba0  72 6d 61 74 20 20 74 68  61 74 0a 41 72 63 46 53  |rmat  that.ArcFS|
00000bb0  20 63 61 6e 6e 6f 74 20  68 61 6e 64 6c 65 20 77  | cannot handle w|
00000bc0  69 6c 6c 20 67 69 76 65  20 27 43 61 6e 27 74 20  |ill give 'Can't |
00000bd0  68 61 6e 64 6c 65 20 61  72 63 68 69 76 65 27 20  |handle archive' |
00000be0  65 72 72 6f 72 73 20 77  68 65 6e 20 20 79 6f 75  |errors when  you|
00000bf0  0a 61 74 74 65 6d 70 74  20 74 6f 20 6c 6f 61 64  |.attempt to load|
00000c00  20 74 68 65 6d 2e 20 41  72 63 68 69 76 65 73 20  | them. Archives |
00000c10  63 6f 6e 74 61 69 6e 69  6e 67 20 6f 6c 64 20 66  |containing old f|
00000c20  6f 72 6d 61 74 20 73 74  6f 72 65 64 20 6f 62 6a  |ormat stored obj|
00000c30  65 63 74 73 20 63 61 6e  6e 6f 74 0a 62 65 20 6f  |ects cannot.be o|
00000c40  70 65 6e 65 64 2e 0a 0a  4d 65 6d 6f 72 79 20 72  |pened...Memory r|
00000c50  65 71 75 69 72 65 6d 65  6e 74 73 0a 0a 4e 6f 2e  |equirements..No.|
00000c60  20 6f 66 20 62 69 74 73  20 63 6f 6d 70 72 65 73  | of bits compres|
00000c70  73 69 6f 6e 20 20 20 20  53 70 61 72 6b 20 66 6f  |sion    Spark fo|
00000c80  72 6d 61 74 73 20 20 20  20 20 20 20 20 20 20 20  |rmats           |
00000c90  4d 65 6d 6f 72 79 20 72  65 71 75 69 72 65 6d 65  |Memory requireme|
00000ca0  6e 74 0a 0a 31 32 20 62  69 74 73 20 20 20 20 20  |nt..12 bits     |
00000cb0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 43  |               C|
00000cc0  72 75 6e 63 68 2c 20 43  6f 6d 70 72 65 73 73 20  |runch, Compress |
00000cd0  31 32 20 20 20 20 20 4a  75 73 74 20 6f 76 65 72  |12     Just over|
00000ce0  20 31 36 4b 0a 31 33 20  62 69 74 73 20 20 20 20  | 16K.13 bits    |
00000cf0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000d00  53 71 75 61 73 68 2c 20  43 6f 6d 70 72 65 73 73  |Squash, Compress|
00000d10  20 31 33 20 20 20 20 20  4a 75 73 74 20 6f 76 65  | 13     Just ove|
00000d20  72 20 33 32 4b 0a 31 34  20 62 69 74 73 20 20 20  |r 32K.14 bits   |
00000d30  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000d40  20 43 6f 6d 70 72 65 73  73 20 31 34 20 20 20 20  | Compress 14    |
00000d50  20 20 20 20 20 20 20 20  20 4a 75 73 74 20 6f 76  |         Just ov|
00000d60  65 72 20 36 34 4b 0a 31  35 20 62 69 74 73 20 20  |er 64K.15 bits  |
00000d70  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000d80  20 20 43 6f 6d 70 72 65  73 73 20 31 35 20 20 20  |  Compress 15   |
00000d90  20 20 20 20 20 20 20 20  20 20 4a 75 73 74 20 6f  |          Just o|
00000da0  76 65 72 20 31 32 38 4b  0a 31 36 20 62 69 74 73  |ver 128K.16 bits|
00000db0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000dc0  20 20 20 20 43 6f 6d 70  72 65 73 73 20 31 36 20  |    Compress 16 |
00000dd0  20 20 20 20 20 20 20 20  20 20 20 20 4a 75 73 74  |            Just|
00000de0  20 6f 76 65 72 20 32 35  36 4b 0a 0a 54 68 65 20  | over 256K..The |
00000df0  61 62 6f 76 65 20 74 61  62 6c 65 20 73 68 6f 77  |above table show|
00000e00  73 20 74 68 65 20 72 65  71 75 69 72 65 6d 65 6e  |s the requiremen|
00000e10  74 73 20 66 6f 72 20 66  72 65 65 20 6d 65 6d 6f  |ts for free memo|
00000e20  72 79 20 69 6e 20 6f 72  64 65 72 20 74 6f 20 6c  |ry in order to l|
00000e30  6f 61 64 20 65 61 63 68  0a 6f 66 20 74 68 65 20  |oad each.of the |
00000e40  61 76 61 69 6c 61 62 6c  65 20 66 6f 72 6d 61 74  |available format|
00000e50  73 2e 20 55 73 69 6e 67  20 31 36 20 62 69 74 20  |s. Using 16 bit |
00000e60  63 6f 6d 70 72 65 73 73  69 6f 6e 20 66 6f 72 6d  |compression form|
00000e70  61 74 73 20 63 61 6e 20  63 61 75 73 65 0a 70 72  |ats can cause.pr|
00000e80  6f 62 6c 65 6d 73 20 77  68 65 6e 20 74 72 79 69  |oblems when tryi|
00000e90  6e 67 20 74 6f 20 6c 6f  61 64 20 73 75 63 68 20  |ng to load such |
00000ea0  66 69 6c 65 73 20 6f 6e  20 61 20 31 4d 62 79 74  |files on a 1Mbyt|
00000eb0  65 20 6d 61 63 68 69 6e  65 2e 0a 0a 53 69 6d 75  |e machine...Simu|
00000ec0  6c 74 61 6e 65 6f 75 73  6c 79 20 6f 70 65 6e 20  |ltaneously open |
00000ed0  61 72 63 68 69 76 65 73  0a 0a 54 68 69 73 20 76  |archives..This v|
00000ee0  65 72 73 69 6f 6e 20 6f  66 20 41 72 63 46 53 20  |ersion of ArcFS |
00000ef0  73 75 70 70 6f 72 74 73  20 6f 6e 6c 79 20 6f 6e  |supports only on|
00000f00  65 20 6f 70 65 6e 20 61  72 63 68 69 76 65 20 61  |e open archive a|
00000f10  74 20 61 20 74 69 6d 65  2e 20 46 75 74 75 72 65  |t a time. Future|
00000f20  20 0a 76 65 72 73 69 6f  6e 73 20 6d 61 79 20 73  | .versions may s|
00000f30  75 70 70 6f 72 74 20 6d  61 79 20 64 69 66 66 65  |upport may diffe|
00000f40  72 65 6e 74 20 6e 61 6d  65 64 20 61 72 63 68 69  |rent named archi|
00000f50  76 65 73 20 73 65 6c 65  63 74 65 64 20 62 79 20  |ves selected by |
00000f60  74 68 65 20 0a 69 6e 63  6c 75 73 69 6f 6e 20 6f  |the .inclusion o|
00000f70  66 20 74 68 65 20 6e 61  6d 65 20 69 6e 20 61 20  |f the name in a |
00000f80  73 70 65 63 69 61 6c 20  66 69 65 6c 64 2e 20 54  |special field. T|
00000f90  68 69 73 20 76 65 72 73  69 6f 6e 20 73 75 70 70  |his version supp|
00000fa0  6f 72 74 73 20 62 75 74  20 0a 69 67 6e 6f 72 65  |orts but .ignore|
00000fb0  73 20 73 70 65 63 69 61  6c 20 66 69 65 6c 64 73  |s special fields|
00000fc0  20 61 6c 6c 6f 77 69 6e  67 20 74 68 65 20 41 72  | allowing the Ar|
00000fd0  63 46 53 20 66 69 6c 65  72 20 74 6f 20 69 6e 63  |cFS filer to inc|
00000fe0  6c 75 64 65 20 74 68 65  20 6c 65 61 66 6e 61 6d  |lude the leafnam|
00000ff0  65 20 0a 6f 66 20 74 68  65 20 61 72 63 68 69 76  |e .of the archiv|
00001000  65 20 61 73 20 74 68 65  20 73 70 65 63 69 61 6c  |e as the special|
00001010  20 66 69 65 6c 64 20 73  6f 20 74 68 61 74 20 74  | field so that t|
00001020  68 65 20 75 73 65 72 20  63 61 6e 20 73 65 65 20  |he user can see |
00001030  61 74 20 61 20 0a 67 6c  61 6e 63 65 20 77 68 69  |at a .glance whi|
00001040  63 68 20 61 72 63 68 69  76 65 20 69 73 20 6f 70  |ch archive is op|
00001050  65 6e 2e 0a 0a 53 63 72  65 65 6e 20 4f 75 74 70  |en...Screen Outp|
00001060  75 74 20 66 6f 72 6d 61  74 0a 0a 53 63 72 65 65  |ut format..Scree|
00001070  6e 20 4f 75 74 70 75 74  20 66 6f 6c 6c 6f 77 73  |n Output follows|
00001080  20 74 68 61 74 20 6f 66  20 46 69 6c 65 63 6f 72  | that of Filecor|
00001090  65 20 61 73 20 63 6c 6f  73 65 6c 79 20 61 73 20  |e as closely as |
000010a0  70 6f 73 73 69 62 6c 65  2e 20 2a 46 69 6c 65 49  |possible. *FileI|
000010b0  6e 66 6f 20 67 69 76 65  73 20 61 20 74 6f 74 61  |nfo gives a tota|
000010c0  6c 79 20 64 69 66 66 65  72 65 6e 74 20 6f 75 74  |ly different out|
000010d0  70 75 74 20 74 6f 20 74  68 61 74 20 6f 66 20 46  |put to that of F|
000010e0  69 6c 65 63 6f 72 65 2e  0a 0a 2a 46 69 6c 65 49  |ilecore...*FileI|
000010f0  6e 66 6f 0a 0a 2a 46 69  6c 65 49 6e 66 6f 20 64  |nfo..*FileInfo d|
00001100  69 73 70 6c 61 79 73 20  74 68 65 20 63 6f 6d 70  |isplays the comp|
00001110  6c 65 74 65 20 48 65 61  64 65 72 20 69 6e 66 6f  |lete Header info|
00001120  72 6d 61 74 69 6f 6e 20  68 65 6c 64 20 69 6e 20  |rmation held in |
00001130  6d 65 6d 6f 72 79 20 61  62 6f 75 74 0a 66 69 6c  |memory about.fil|
00001140  65 73 2e 20 54 68 65 20  6f 75 74 70 75 74 20 6f  |es. The output o|
00001150  66 20 2a 46 69 6c 65 49  6e 66 6f 20 69 73 20 61  |f *FileInfo is a|
00001160  73 20 66 6f 6c 6c 6f 77  73 3a 0a 0a 4e 61 6d 65  |s follows:..Name|
00001170  20 20 20 20 20 20 20 4c  57 52 2f 77 72 20 66 66  |       LWR/wr ff|
00001180  20 66 6f 72 6d 61 74 20  20 6c 6c 6c 6c 6c 6c 6c  | format  lllllll|
00001190  6c 20 61 61 61 61 61 61  61 61 20 65 65 65 65 65  |l aaaaaaaa eeeee|
000011a0  65 65 65 20 30 30 63 63  63 63 63 63 20 70 70 70  |eee 00cccccc ppp|
000011b0  70 70 70 70 70 20 72 72  25 0a 0a 77 68 65 72 65  |ppppp rr%..where|
000011c0  3a 0a 0a 20 20 20 20 4e  61 6d 65 20 69 73 20 74  |:..    Name is t|
000011d0  68 65 20 6f 62 6a 65 63  74 20 6c 65 61 66 6e 61  |he object leafna|
000011e0  6d 65 0a 0a 20 20 20 20  4c 57 52 2f 77 72 20 61  |me..    LWR/wr a|
000011f0  72 65 20 74 68 65 20 6f  62 6a 65 63 74 20 61 74  |re the object at|
00001200  74 72 69 62 75 74 65 73  0a 0a 20 20 20 20 66 66  |tributes..    ff|
00001210  20 69 73 20 74 68 65 20  48 65 61 64 65 72 20 56  | is the Header V|
00001220  65 72 73 69 6f 6e 20 4e  75 6d 62 65 72 20 28 72  |ersion Number (r|
00001230  65 70 72 65 73 65 6e 74  73 20 74 68 65 20 63 6f  |epresents the co|
00001240  6d 70 72 65 73 73 69 6f  6e 20 66 6f 72 6d 61 74  |mpression format|
00001250  29 0a 0a 20 20 20 20 66  6f 72 6d 61 74 20 69 73  |)..    format is|
00001260  20 74 68 65 20 74 79 70  65 20 6f 66 20 64 61 74  | the type of dat|
00001270  61 20 63 6f 6d 70 72 65  73 73 69 6f 6e 20 28 61  |a compression (a|
00001280  6c 77 61 79 73 20 73 74  6f 72 65 20 66 6f 72 20  |lways store for |
00001290  64 69 72 65 63 74 6f 72  69 65 73 29 0a 0a 20 20  |directories)..  |
000012a0  20 20 6c 6c 6c 6c 6c 6c  6c 6c 20 69 73 20 74 68  |  llllllll is th|
000012b0  65 20 66 75 6c 6c 20 6f  62 6a 65 63 74 20 6c 65  |e full object le|
000012c0  6e 67 74 68 20 28 66 6f  72 20 64 69 72 65 63 74  |ngth (for direct|
000012d0  6f 72 69 65 73 20 74 68  69 73 20 69 73 20 74 68  |ories this is th|
000012e0  65 20 74 6f 74 61 6c 20  20 20 20 20 20 20 20 20  |e total         |
000012f0  20 20 20 20 20 20 20 20  63 6f 6d 70 72 65 73 73  |        compress|
00001300  65 64 20 73 69 7a 65 20  6f 66 20 61 6c 6c 20 6f  |ed size of all o|
00001310  62 6a 65 63 74 73 20 63  6f 6e 74 61 69 6e 65 64  |bjects contained|
00001320  20 69 6e 20 69 74 2e 29  0a 0a 20 20 20 20 61 61  | in it.)..    aa|
00001330  61 61 61 61 61 61 20 69  73 20 74 68 65 20 6c 6f  |aaaaaa is the lo|
00001340  61 64 20 61 64 64 72 65  73 73 20 28 64 69 72 65  |ad address (dire|
00001350  63 74 6f 72 69 65 73 20  61 72 65 20 66 69 6c 65  |ctories are file|
00001360  74 79 70 65 20 26 44 44  43 29 0a 0a 20 20 20 20  |type &DDC)..    |
00001370  65 65 65 65 65 65 65 65  20 69 73 20 74 68 65 20  |eeeeeeee is the |
00001380  65 78 65 63 75 74 65 20  61 64 64 72 65 73 73 0a  |execute address.|
00001390  0a 20 20 20 20 30 30 63  63 63 63 63 63 20 69 73  |.    00cccccc is|
000013a0  20 74 68 65 20 63 6f 6d  70 72 65 73 73 65 64 20  | the compressed |
000013b0  66 69 6c 65 20 73 69 7a  65 2e 20 54 68 65 20 74  |file size. The t|
000013c0  6f 70 20 62 79 74 65 20  69 73 20 61 6c 77 61 79  |op byte is alway|
000013d0  73 20 73 68 6f 77 6e 20  61 73 20 20 20 20 20 20  |s shown as      |
000013e0  20 20 20 20 20 20 20 20  20 20 20 7a 65 72 6f 20  |           zero |
000013f0  72 65 67 61 72 64 6c 65  73 73 20 6f 66 20 77 68  |regardless of wh|
00001400  65 74 68 65 72 20 74 68  69 73 20 69 73 20 74 68  |ether this is th|
00001410  65 20 63 61 73 65 20 61  73 20 74 68 65 20 20 20  |e 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 20  63 6f 6d 70 72 65 73 73  |        compress|
00001440  65 64 20 6c 65 6e 67 74  68 20 69 73 20 73 74 6f  |ed length is sto|
00001450  72 65 64 20 69 6e 20 74  68 65 20 74 6f 70 20 32  |red in the top 2|
00001460  34 20 62 69 74 73 20 6f  66 20 74 68 65 20 66 69  |4 bits of the fi|
00001470  6c 65 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |le              |
00001480  20 20 20 20 20 61 74 74  72 69 62 75 74 65 73 2e  |     attributes.|
00001490  20 55 6e 6c 65 73 73 20  79 6f 75 20 61 72 65 20  | Unless you are |
000014a0  75 73 69 6e 67 20 56 45  52 59 20 6c 6f 6e 67 20  |using VERY long |
000014b0  66 69 6c 65 73 20 74 68  69 73 20 73 68 6f 75 6c  |files this shoul|
000014c0  64 20 6e 6f 74 20 20 20  20 20 20 20 20 20 20 20  |d not           |
000014d0  20 20 62 65 20 61 20 70  72 6f 62 6c 65 6d 2e 20  |  be a problem. |
000014e0  49 74 20 65 71 75 61 6c  73 20 74 68 65 20 66 75  |It equals the fu|
000014f0  6c 6c 20 6c 65 6e 67 74  68 20 66 6f 72 20 73 74  |ll length for st|
00001500  6f 72 65 64 20 6f 62 6a  65 63 74 73 2e 0a 0a 20  |ored objects... |
00001510  20 20 20 70 70 70 70 70  70 70 70 20 54 68 69 73  |   pppppppp This|
00001520  20 64 65 70 65 6e 64 73  20 6f 6e 20 77 68 65 74  | depends on whet|
00001530  68 65 72 20 74 68 65 20  6f 62 6a 65 63 74 20 69  |her the object i|
00001540  73 20 61 20 66 69 6c 65  20 6f 72 20 64 69 72 65  |s a file or dire|
00001550  63 74 6f 72 79 2e 20 46  6f 72 20 61 20 20 20 20  |ctory. For a    |
00001560  20 20 20 20 20 20 20 20  20 66 69 6c 65 20 69 74  |         file it|
00001570  20 69 73 20 74 68 65 20  70 6f 73 69 74 69 6f 6e  | is the position|
00001580  20 69 6e 20 74 68 65 20  61 72 63 68 69 76 65 20  | in the archive |
00001590  66 69 6c 65 20 61 74 20  77 68 69 63 68 20 74 68  |file at which th|
000015a0  65 20 66 69 6c 65 20 20  20 20 20 20 20 20 20 20  |e file          |
000015b0  20 20 20 20 20 20 64 61  74 61 20 62 65 67 69 6e  |      data begin|
000015c0  73 2e 20 46 6f 72 20 64  69 72 65 63 74 6f 72 69  |s. For directori|
000015d0  65 73 20 74 68 69 73 20  69 73 20 74 68 65 20 6d  |es this is the m|
000015e0  65 6d 6f 72 79 20 61 64  64 72 65 73 73 20 61 74  |emory address at|
000015f0  20 77 68 69 63 68 20 20  20 20 20 20 20 20 20 20  | which          |
00001600  20 20 20 74 68 65 20 6e  65 78 74 20 68 65 61 64  |   the next head|
00001610  65 72 20 69 6e 20 74 68  65 20 70 61 72 65 6e 74  |er in the parent|
00001620  20 64 69 72 65 63 74 6f  72 79 20 65 78 69 73 74  | directory exist|
00001630  73 20 28 6e 6f 74 20 76  65 72 79 20 75 73 65 66  |s (not very usef|
00001640  75 6c 2c 20 20 20 20 20  20 20 20 20 20 20 20 20  |ul,             |
00001650  62 75 74 20 75 73 65 64  20 69 6e 74 65 72 6e 61  |but used interna|
00001660  6c 6c 79 20 62 79 20 41  72 63 46 53 29 2e 0a 0a  |lly by ArcFS)...|
00001670  20 20 20 20 20 20 20 20  20 72 72 25 20 54 68 69  |         rr% Thi|
00001680  73 20 69 73 20 74 68 65  20 63 6f 6d 70 72 65 73  |s is the compres|
00001690  73 69 6f 6e 20 72 61 74  69 6f 2c 20 69 2e 65 2e  |sion ratio, i.e.|
000016a0  20 74 68 65 20 63 6f 6d  70 72 65 73 73 65 64 20  | the compressed |
000016b0  66 69 6c 65 20 73 69 7a  65 20 20 20 20 20 20 20  |file size       |
000016c0  20 20 20 20 20 20 20 20  20 20 65 78 70 72 65 73  |          expres|
000016d0  73 65 64 20 61 73 20 61  20 70 65 72 63 65 6e 74  |sed as a percent|
000016e0  61 67 65 20 6f 66 20 74  68 65 20 6f 72 69 67 69  |age of the origi|
000016f0  6e 61 6c 2e 20 43 61 6e  20 73 75 66 66 65 72 20  |nal. Can suffer |
00001700  66 72 6f 6d 20 74 68 65  20 20 20 20 20 20 20 20  |from the        |
00001710  20 20 20 20 20 20 20 65  66 66 65 63 74 20 65 78  |       effect ex|
00001720  70 6c 61 69 6e 65 64 20  61 62 6f 76 65 20 66 6f  |plained above fo|
00001730  72 20 63 6f 6d 70 72 65  73 73 65 64 20 66 69 6c  |r compressed fil|
00001740  65 20 73 69 7a 65 73 20  6c 61 72 67 65 72 20 74  |e sizes larger t|
00001750  68 61 6e 20 20 20 20 20  20 20 20 20 20 20 20 20  |han             |
00001760  20 20 20 20 26 46 46 46  46 46 46 2e 20 0a 0a 46  |    &FFFFFF. ..F|
00001770  69 6c 65 20 41 74 74 72  69 62 75 74 65 73 0a 0a  |ile Attributes..|
00001780  54 68 65 20 6c 6f 77 65  73 74 20 32 34 20 62 69  |The lowest 24 bi|
00001790  74 73 20 6f 66 20 74 68  65 20 63 6f 6d 70 72 65  |ts of the compre|
000017a0  73 73 65 64 20 66 69 6c  65 20 6c 65 6e 67 74 68  |ssed file length|
000017b0  20 61 72 65 20 73 74 6f  72 65 64 20 69 6e 20 74  | are stored in t|
000017c0  68 65 20 74 6f 70 20 32  34 0a 62 69 74 73 20 6f  |he top 24.bits o|
000017d0  66 20 74 68 65 20 66 69  6c 65 20 61 74 74 72 69  |f the file attri|
000017e0  62 75 74 65 73 2e 0a 0a  55 73 65 72 20 52 6f 6f  |butes...User Roo|
000017f0  74 20 44 69 72 65 63 74  6f 72 69 65 73 20 28 55  |t Directories (U|
00001800  2e 52 2e 44 2e 27 73 29  0a 0a 4e 6f 77 20 73 75  |.R.D.'s)..Now su|
00001810  70 70 6f 72 74 65 64 2e  20 55 73 65 20 2a 55 52  |pported. Use *UR|
00001820  44 20 74 6f 20 73 65 6c  65 63 74 20 74 68 65 20  |D to select the |
00001830  75 73 65 72 20 72 6f 6f  74 20 28 26 29 20 64 69  |user root (&) di|
00001840  72 65 63 74 6f 72 79 2e  0a 0a 54 68 65 20 70 72  |rectory...The pr|
00001850  65 76 69 6f 75 73 6c 79  20 73 65 6c 65 63 74 65  |eviously selecte|
00001860  64 20 64 69 72 65 63 74  6f 72 79 20 28 50 2e 53  |d directory (P.S|
00001870  2e 44 2e 29 0a 0a 4e 6f  77 20 73 75 70 70 6f 72  |.D.)..Now suppor|
00001880  74 65 64 2e 20 57 68 65  6e 20 61 20 6e 65 77 20  |ted. When a new |
00001890  64 69 72 65 63 74 6f 72  79 20 73 65 6c 65 63 74  |directory select|
000018a0  69 6f 6e 20 69 73 20 6d  61 64 65 2c 20 74 68 65  |ion is made, the|
000018b0  20 6f 6c 64 20 6f 6e 65  20 62 65 63 6f 6d 65 73  | old one becomes|
000018c0  0a 74 68 65 20 50 2e 53  2e 44 2e 20 55 73 65 20  |.the P.S.D. Use |
000018d0  2a 42 61 63 6b 20 74 6f  20 73 77 61 70 20 74 68  |*Back to swap th|
000018e0  65 20 43 2e 53 2e 44 2e  20 61 6e 64 20 50 2e 53  |e C.S.D. and P.S|
000018f0  2e 44 2e 20 54 68 65 20  50 2e 53 2e 44 2e 20 63  |.D. The P.S.D. c|
00001900  61 6e 20 62 65 0a 73 70  65 63 69 66 69 65 64 20  |an be.specified |
00001910  61 74 20 74 68 65 20 62  65 67 69 6e 69 6e 67 20  |at the begining |
00001920  6f 66 20 61 20 70 61 74  68 6e 61 6d 65 20 61 73  |of a pathname as|
00001930  20 5c 2e 0a 0a 41 75 74  6f 6d 61 74 69 63 20 6c  | \...Automatic l|
00001940  69 62 72 61 72 79 20 73  65 6c 65 63 74 69 6f 6e  |ibrary selection|
00001950  0a 0a 49 66 20 41 72 63  46 53 20 66 69 6e 64 73  |..If ArcFS finds|
00001960  20 61 20 64 69 72 65 63  74 6f 72 79 20 73 74 61  | a directory sta|
00001970  72 74 69 6e 67 20 77 69  74 68 20 74 68 65 20 6c  |rting with the l|
00001980  65 74 74 65 72 73 20 27  4c 69 62 27 20 69 6e 20  |etters 'Lib' in |
00001990  74 68 65 20 72 6f 6f 74  0a 64 69 72 65 63 74 6f  |the root.directo|
000019a0  72 79 20 6f 66 20 61 6e  20 61 72 63 68 69 76 65  |ry of an archive|
000019b0  20 77 68 65 6e 20 69 74  20 69 73 20 6f 70 65 6e  | when it is open|
000019c0  20 69 74 20 73 65 6c 65  63 74 73 20 74 68 69 73  | it selects this|
000019d0  20 61 73 20 74 68 65 20  6c 69 62 72 61 72 79 0a  | as the library.|
000019e0  64 69 72 65 63 74 6f 72  79 2c 20 6f 74 68 65 72  |directory, other|
000019f0  77 69 73 65 20 74 68 65  20 72 6f 6f 74 20 64 69  |wise the root di|
00001a00  72 65 63 74 6f 72 79 20  28 24 29 20 69 73 20 73  |rectory ($) is s|
00001a10  65 6c 65 63 74 65 64 2e  0a 0a 55 6e 73 65 74 20  |elected...Unset |
00001a20  44 69 72 65 63 74 6f 72  79 20 63 6f 6e 74 65 78  |Directory contex|
00001a30  74 73 0a 0a 54 68 69 73  20 69 73 20 6e 6f 74 20  |ts..This is not |
00001a40  73 75 70 70 6f 72 74 65  64 2e 20 41 6c 6c 20 64  |supported. All d|
00001a50  69 72 65 63 74 6f 72 79  20 63 6f 6e 74 65 78 74  |irectory context|
00001a60  73 20 61 72 65 20 73 65  74 20 74 6f 20 27 24 27  |s are set to '$'|
00001a70  20 77 68 65 6e 20 61 6e  0a 61 72 63 68 69 76 65  | when an.archive|
00001a80  20 69 73 20 6f 70 65 6e  65 64 20 28 75 6e 6c 65  | is opened (unle|
00001a90  73 73 20 61 6e 20 61 75  74 6f 6d 61 74 69 63 20  |ss an automatic |
00001aa0  6c 69 62 72 61 72 79 20  73 65 6c 65 63 74 69 6f  |library selectio|
00001ab0  6e 20 69 73 20 6d 61 64  65 2c 20 73 65 65 0a 61  |n is made, see.a|
00001ac0  62 6f 76 65 29 2e 0a 0a  52 61 6e 64 6f 6d 20 61  |bove)...Random a|
00001ad0  63 63 65 73 73 20 66 69  6c 69 6e 67 0a 0a 46 69  |ccess filing..Fi|
00001ae0  6c 65 73 20 61 72 65 20  64 65 63 6f 6d 70 72 65  |les are decompre|
00001af0  73 73 65 64 20 61 6e 64  20 68 65 6c 64 20 69 6e  |ssed and held in|
00001b00  20 52 2e 4d 2e 41 2e 20  77 68 69 6c 73 74 20 74  | R.M.A. whilst t|
00001b10  68 65 79 20 61 72 65 20  6f 70 65 6e 2e 20 59 6f  |hey are open. Yo|
00001b20  75 20 20 73 68 6f 75 6c  64 0a 6e 6f 74 65 20 74  |u  should.note t|
00001b30  68 61 74 20 77 68 65 6e  20 73 70 72 69 74 65 20  |hat when sprite |
00001b40  66 69 6c 65 73 20 61 72  65 20 6c 6f 61 64 65 64  |files are loaded|
00001b50  20 74 68 65 79 20 61 72  65 20 6f 70 65 6e 65 64  | they are opened|
00001b60  20 66 6f 72 20 20 72 61  6e 64 6f 6d 20 61 63 63  | for  random acc|
00001b70  65 73 73 0a 69 6e 70 75  74 20 61 6e 64 20 74 68  |ess.input and th|
00001b80  65 72 65 66 6f 72 65 20  74 68 65 72 65 20 6e 65  |erefore there ne|
00001b90  65 64 73 20 74 6f 20 62  65 20 65 6e 6f 75 67 68  |eds to be enough|
00001ba0  20 66 72 65 65 20 6d 65  6d 6f 72 79 20 20 61 76  | free memory  av|
00001bb0  61 69 6c 61 62 6c 65 20  77 68 65 6e 20 74 68 65  |ailable when the|
00001bc0  0a 73 70 72 69 74 65 73  20 61 72 65 20 6c 6f 61  |.sprites are loa|
00001bd0  64 65 64 2e 20 54 68 69  73 20 6d 61 79 20 63 61  |ded. This may ca|
00001be0  75 73 65 20 70 72 6f 62  6c 65 6d 73 20 77 68 65  |use problems whe|
00001bf0  6e 20 20 6c 61 72 67 65  20 73 70 72 69 74 65 20  |n  large sprite |
00001c00  66 69 6c 65 73 20 61 72  65 0a 6c 6f 61 64 65 64  |files are.loaded|
00001c10  20 69 6e 74 6f 20 61 20  31 20 4d 62 79 74 65 20  | into a 1 Mbyte |
00001c20  6d 61 63 68 69 6e 65 20  28 61 6e 79 6f 6e 65 20  |machine (anyone |
00001c30  77 69 74 68 20 61 6e 20  20 75 6e 65 78 70 61 6e  |with an  unexpan|
00001c40  64 65 64 20 41 33 30 35  20 2d 20 64 6f 6e 27 74  |ded A305 - don't|
00001c50  0a 62 6f 74 68 65 72 21  29 20 62 75 74 20 49 20  |.bother!) but I |
00001c60  63 61 6e 6e 6f 74 20 72  65 61 6c 6c 79 20 73 75  |cannot really su|
00001c70  67 67 65 73 74 20 61 6e  79 74 68 69 6e 67 20 20  |ggest anything  |
00001c80  73 68 6f 72 74 20 6f 66  20 75 70 67 72 61 64 69  |short of upgradi|
00001c90  6e 67 20 74 6f 20 32 0a  4d 62 79 74 65 73 20 28  |ng to 2.Mbytes (|
00001ca0  6f 74 68 65 72 20 74 68  61 6e 20 6d 61 6b 69 6e  |other than makin|
00001cb0  67 20 73 75 72 65 20 74  68 61 74 20 61 6c 6c 20  |g sure that all |
00001cc0  74 68 65 20 20 70 6f 73  73 69 62 6c 65 20 66 72  |the  possible fr|
00001cd0  65 65 20 6d 65 6d 6f 72  79 20 69 73 0a 61 76 61  |ee memory is.ava|
00001ce0  69 6c 61 62 6c 65 20 74  6f 20 74 68 65 20 52 2e  |ilable to the R.|
00001cf0  4d 2e 41 2e 29 2e 20 57  68 65 6e 20 49 20 62 6f  |M.A.). When I bo|
00001d00  75 67 68 74 20 6d 79 20  32 4d 62 79 74 65 20 52  |ught my 2Mbyte R|
00001d10  41 4d 20 75 70 67 72 61  64 65 20 69 6e 20 44 65  |AM upgrade in De|
00001d20  63 2e 20 31 39 38 39 0a  69 74 20 63 6f 73 74 20  |c. 1989.it cost |
00001d30  a3 31 35 30 20 2b 56 41  54 2e 20 4e 6f 77 20 69  |.150 +VAT. Now i|
00001d40  74 20 63 61 6e 20 63 6f  73 74 20 61 73 20 6c 69  |t can cost as li|
00001d50  74 74 6c 65 20 61 73 20  61 20 74 68 69 72 64 20  |ttle as a third |
00001d60  6f 66 20 74 68 61 74 20  70 72 69 63 65 20 61 6e  |of that price an|
00001d70  64 20 69 73 0a 73 74 69  6c 6c 20 66 61 6c 6c 69  |d is.still falli|
00001d80  6e 67 2e 20 49 20 68 61  76 65 20 66 6f 75 6e 64  |ng. I have found|
00001d90  20 69 74 20 76 65 72 79  20 75 73 65 66 75 6c 20  | it very useful |
00001da0  61 6e 64 20 63 61 6e 20  72 65 63 6f 6d 6d 65 6e  |and can recommen|
00001db0  64 20 69 74 20 74 6f 20  61 6e 79 20 75 73 65 72  |d it to any user|
00001dc0  73 0a 6f 66 20 31 20 4d  62 79 74 65 20 41 33 30  |s.of 1 Mbyte A30|
00001dd0  30 30 27 73 20 61 6e 64  20 41 34 31 30 27 73 20  |00's and A410's |
00001de0  77 68 6f 20 75 73 65 20  74 68 65 69 72 20 63 6f  |who use their co|
00001df0  6d 70 75 74 65 72 73 20  66 6f 72 20 6d 6f 72 65  |mputers for more|
00001e00  20 74 68 61 6e 20 6a 75  73 74 0a 61 72 63 61 64  | than just.arcad|
00001e10  65 20 67 61 6d 65 73 2e  20 4f 74 68 65 72 20 66  |e games. Other f|
00001e20  69 6c 65 73 20 73 75 63  68 20 61 73 20 20 45 78  |iles such as  Ex|
00001e30  65 63 20 61 6e 64 20 4f  62 65 79 20 66 69 6c 65  |ec and Obey file|
00001e40  73 20 61 72 65 20 61 6c  73 6f 20 6f 70 65 6e 65  |s are also opene|
00001e50  64 20 66 6f 72 0a 72 61  6e 64 6f 6d 20 61 63 63  |d for.random acc|
00001e60  65 73 73 20 69 6e 70 75  74 20 62 75 74 20 74 68  |ess input but th|
00001e70  65 73 65 20 20 61 72 65  20 75 73 75 61 6c 6c 79  |ese  are usually|
00001e80  20 73 68 6f 72 74 2e 0a  0a 55 73 65 20 77 69 74  | short...Use wit|
00001e90  68 20 36 35 48 6f 73 74  20 61 6e 64 20 36 35 54  |h 65Host and 65T|
00001ea0  75 62 65 0a 0a 41 72 63  46 53 20 63 61 6e 20 65  |ube..ArcFS can e|
00001eb0  61 73 69 6c 79 20 62 65  20 75 73 65 64 20 77 69  |asily be used wi|
00001ec0  74 68 20 36 35 48 6f 73  74 20 61 6e 64 20 36 35  |th 65Host and 65|
00001ed0  54 75 62 65 2e 20 36 35  48 6f 73 74 20 75 73 65  |Tube. 65Host use|
00001ee0  72 73 20 6d 75 73 74 20  6f 70 65 6e 20 74 68 65  |rs must open the|
00001ef0  0a 72 65 71 75 69 72 65  64 20 61 72 63 68 69 76  |.required archiv|
00001f00  65 20 62 65 66 6f 72 65  20 65 6e 74 65 72 69 6e  |e before enterin|
00001f10  67 20 74 68 65 20 65 6d  75 6c 61 74 6f 72 20 75  |g the emulator u|
00001f20  6e 64 65 72 20 77 68 69  63 68 20 41 72 63 46 53  |nder which ArcFS|
00001f30  20 69 73 20 73 65 6c 65  63 74 65 64 0a 62 79 3a  | is selected.by:|
00001f40  0a 0a 20 20 20 20 2a 44  69 72 20 41 72 63 46 53  |..    *Dir ArcFS|
00001f50  3a 0a 0a 44 46 53 20 65  6d 75 6c 61 74 69 6f 6e  |:..DFS emulation|
00001f60  73 20 6d 61 79 20 61 6c  73 6f 20 62 65 20 73 65  |s may also be se|
00001f70  74 20 75 70 20 69 6e 20  61 72 63 68 69 76 65 73  |t up in archives|
00001f80  20 28 61 73 20 6f 6e 20  41 44 46 53 29 20 61 6e  | (as on ADFS) an|
00001f90  64 20 75 73 65 64 0a 75  6e 64 65 72 20 36 35 48  |d used.under 65H|
00001fa0  6f 73 74 0a 0a 50 43 20  46 6f 72 6d 61 74 0a 0a  |ost..PC Format..|
00001fb0  46 69 6c 65 73 20 61 72  63 68 69 76 65 64 20 75  |Files archived u|
00001fc0  73 69 6e 67 20 50 43 20  46 6f 72 6d 61 74 20 69  |sing PC Format i|
00001fd0  6e 20 53 70 61 72 6b 20  6f 72 20 61 72 63 68 69  |n Spark or archi|
00001fe0  76 65 64 20 75 73 69 6e  67 20 53 45 41 20 61 72  |ved using SEA ar|
00001ff0  63 20 6f 72 20 50 4b 20  61 72 63 0a 6f 6e 20 61  |c or PK arc.on a|
00002000  20 50 43 20 61 6c 6c 20  68 61 76 65 20 66 69 6c  | PC all have fil|
00002010  65 20 74 79 70 65 20 26  31 31 31 2e 0a 0a 44 69  |e type &111...Di|
00002020  72 65 63 74 6f 72 79 20  6c 65 76 65 6c 73 0a 0a  |rectory levels..|
00002030  55 70 20 74 6f 20 36 34  20 64 69 72 65 63 74 6f  |Up to 64 directo|
00002040  72 79 20 6c 65 76 65 6c  73 20 61 72 65 20 73 75  |ry levels are su|
00002050  70 70 6f 72 74 65 64 2e  20 49 6e 20 74 68 65 20  |pported. In the |
00002060  75 6e 6c 69 6b 65 6c 79  20 65 76 65 6e 74 20 74  |unlikely event t|
00002070  68 61 74 20 6d 6f 72 65  0a 65 78 69 73 74 20 69  |hat more.exist i|
00002080  6e 20 61 6e 20 61 72 63  68 69 76 65 20 66 75 72  |n an archive fur|
00002090  74 68 65 72 20 73 75 62  64 69 72 65 63 74 6f 72  |ther subdirector|
000020a0  69 65 73 20 61 72 65 20  73 68 6f 77 6e 20 61 73  |ies are shown as|
000020b0  20 61 72 63 68 69 76 65  73 2e 0a 0a 43 6f 6d 6d  | archives...Comm|
000020c0  61 6e 64 73 20 70 72 6f  76 69 64 65 64 3a 0a 0a  |ands provided:..|
000020d0  20 20 20 20 2a 41 72 63  46 53 20 20 20 20 20 20  |    *ArcFS      |
000020e0  20 20 20 20 20 20 20 20  20 20 2d 20 73 65 6c 65  |          - sele|
000020f0  63 74 73 20 41 72 63 46  53 20 61 73 20 74 68 65  |cts ArcFS as the|
00002100  20 63 75 72 72 65 6e 74  20 66 69 6c 69 6e 67 20  | current filing |
00002110  73 79 73 74 65 6d 0a 20  20 20 20 2a 4f 70 65 6e  |system.    *Open|
00002120  41 72 63 68 69 76 65 20  3c 4f 62 6a 65 63 74 3e  |Archive <Object>|
00002130  20 2d 20 4f 70 65 6e 73  20 61 6e 20 61 72 63 68  | - Opens an arch|
00002140  69 76 65 20 66 6f 72 20  66 69 6c 65 20 6f 70 65  |ive for file ope|
00002150  72 61 74 69 6f 6e 73 0a  20 20 20 20 2a 43 6c 6f  |rations.    *Clo|
00002160  73 65 41 72 63 68 69 76  65 20 20 20 20 20 20 20  |seArchive       |
00002170  20 20 2d 20 43 6c 6f 73  65 73 20 61 6e 79 20 6f  |  - Closes any o|
00002180  70 65 6e 20 61 72 63 68  69 76 65 0a 0a 46 69 6c  |pen archive..Fil|
00002190  69 6e 67 20 73 79 73 74  65 6d 20 63 6f 6d 6d 61  |ing system comma|
000021a0  6e 64 73 3a 0a 0a 20 20  20 20 2a 42 61 63 6b 20  |nds:..    *Back |
000021b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000021c0  2d 20 73 77 61 70 73 20  74 68 65 20 63 75 72 72  |- swaps the curr|
000021d0  65 6e 74 6c 79 20 61 6e  64 20 70 72 65 76 69 6f  |ently and previo|
000021e0  75 73 6c 79 20 73 65 6c  65 63 74 65 64 20 20 20  |usly 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 20 64  |               d|
00002210  69 72 65 63 74 6f 72 69  65 73 20 28 43 53 44 20  |irectories (CSD |
00002220  61 6e 64 20 50 53 44 29  0a 20 20 20 20 2a 55 52  |and PSD).    *UR|
00002230  44 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |D               |
00002240  20 20 20 2d 20 73 65 6c  65 63 74 73 20 74 68 65  |   - selects the|
00002250  20 75 73 65 72 20 72 6f  6f 74 20 64 69 72 65 63  | user root direc|
00002260  74 6f 72 79 20 28 55 52  44 29 0a 20 20 20 20 2a  |tory (URD).    *|
00002270  47 61 72 62 6c 65 20 3c  50 61 73 73 57 6f 72 64  |Garble <PassWord|
00002280  3e 20 20 20 20 2d 20 4c  6f 61 64 73 20 66 69 6c  |>    - Loads fil|
00002290  65 73 20 67 61 72 62 6c  65 64 20 77 69 74 68 20  |es garbled with |
000022a0  61 20 70 61 73 73 77 6f  72 64 0a 20 20 20 20 2a  |a password.    *|
000022b0  4e 6f 45 6e 63 72 79 70  74 69 6f 6e 20 20 20 20  |NoEncryption    |
000022c0  20 20 20 20 20 2d 20 4c  6f 61 64 73 20 66 69 6c  |     - Loads fil|
000022d0  65 73 20 77 69 74 68 20  6e 6f 20 65 6e 63 72 79  |es with no encry|
000022e0  70 74 69 6f 6e 0a 0a 0a  46 69 6c 65 20 65 6e 63  |ption...File enc|
000022f0  72 79 70 74 69 6f 6e 0a  0a 54 68 69 73 20 76 65  |ryption..This ve|
00002300  72 73 69 6f 6e 20 73 75  70 70 6f 72 74 73 20 67  |rsion supports g|
00002310  61 72 62 6c 65 64 20 66  69 6c 65 73 2e 20 49 6e  |arbled files. In|
00002320  63 6f 72 72 65 63 74 20  70 61 73 73 77 6f 72 64  |correct password|
00002330  73 2c 20 75 73 65 20 6f  66 20 47 61 72 62 6c 65  |s, use of Garble|
00002340  20 66 6f 72 0a 66 69 6c  65 73 20 77 69 74 68 20  | for.files with |
00002350  6e 6f 20 65 6e 63 72 79  70 74 69 6f 6e 20 6f 72  |no encryption or|
00002360  20 74 72 79 69 6e 67 20  74 6f 20 6c 6f 61 64 20  | trying to load |
00002370  67 61 72 62 6c 65 64 20  66 69 6c 65 73 20 68 61  |garbled files ha|
00002380  76 69 6e 67 20 73 65 74  20 41 72 63 46 53 20 74  |ving set ArcFS t|
00002390  6f 0a 6c 6f 61 64 20 66  69 6c 65 73 20 77 69 74  |o.load files wit|
000023a0  68 20 6e 6f 20 65 6e 63  72 79 70 74 69 6f 6e 20  |h no encryption |
000023b0  77 69 6c 6c 20 72 65 73  75 6c 74 20 69 6e 20 61  |will result in a|
000023c0  20 27 44 61 74 61 20 43  6f 72 72 75 70 74 27 20  | 'Data Corrupt' |
000023d0  65 72 72 6f 72 2e 20 54  68 69 73 0a 77 69 6c 6c  |error. This.will|
000023e0  20 61 6c 73 6f 20 6f 63  63 75 72 20 69 66 20 64  | also occur if d|
000023f0  61 74 61 20 69 6e 20 61  6e 20 61 72 63 68 69 76  |ata in an archiv|
00002400  65 20 62 65 63 6f 6d 65  73 20 63 6f 72 72 75 70  |e becomes corrup|
00002410  74 65 64 2e 0a 0a 41 72  63 46 53 20 46 69 6c 65  |ted...ArcFS File|
00002420  72 0a 0a 54 68 65 20 41  72 63 46 53 20 66 69 6c  |r..The ArcFS fil|
00002430  65 72 20 69 73 20 70 72  6f 76 69 64 65 64 20 73  |er is provided s|
00002440  6f 20 74 68 61 74 20 64  69 72 65 63 74 6f 72 69  |o that directori|
00002450  65 73 20 6d 61 79 20 62  65 20 64 69 73 70 6c 61  |es may be displa|
00002460  79 65 64 20 69 6e 20 6e  6f 72 6d 61 6c 0a 66 69  |yed in normal.fi|
00002470  6c 65 72 20 77 69 6e 64  6f 77 73 2e 20 41 72 63  |ler windows. Arc|
00002480  68 69 76 65 73 20 61 72  65 20 6f 70 65 6e 65 64  |hives are opened|
00002490  20 62 79 20 64 6f 75 62  6c 65 20 63 6c 69 63 6b  | by double click|
000024a0  69 6e 67 20 74 68 65 6d  20 6f 72 20 64 72 61 67  |ing them or drag|
000024b0  67 69 6e 67 20 74 68 65  6d 0a 74 6f 20 74 68 65  |ging them.to the|
000024c0  20 41 72 63 46 53 20 69  63 6f 6e 2e 20 54 68 65  | ArcFS icon. The|
000024d0  20 72 6f 6f 74 20 64 69  72 65 63 74 6f 72 79 20  | root directory |
000024e0  6f 66 20 74 68 65 20 6d  6f 73 74 20 72 65 63 65  |of the most rece|
000024f0  6e 74 6c 79 20 6f 70 65  6e 65 64 20 61 72 63 68  |ntly opened arch|
00002500  69 76 65 0a 6d 61 79 20  62 65 20 64 69 73 70 6c  |ive.may be displ|
00002510  61 79 65 64 20 62 79 20  63 6c 69 63 6b 69 6e 67  |ayed by clicking|
00002520  20 6f 6e 20 74 68 65 20  69 63 6f 6e 2e 20 41 20  | on the icon. A |
00002530  6d 65 6e 75 20 69 73 20  70 72 6f 76 69 64 65 64  |menu is provided|
00002540  20 77 69 74 68 20 66 6f  75 72 0a 6f 70 74 69 6f  | with four.optio|
00002550  6e 73 3a 0a 0a 45 6e 63  72 79 70 74 69 6f 6e 2d  |ns:..Encryption-|
00002560  20 53 65 74 73 20 74 68  65 20 65 6e 63 72 79 70  | Sets the encryp|
00002570  74 69 6f 6e 20 6d 65 74  68 6f 64 20 61 6e 64 20  |tion method and |
00002580  70 61 73 73 77 6f 72 64  20 28 69 66 20 61 6e 79  |password (if any|
00002590  29 20 74 68 61 74 20 69  73 20 75 73 65 64 2e 20  |) that is used. |
000025a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 54 68  |              Th|
000025b0  65 20 73 75 62 64 69 72  65 63 74 6f 72 79 20 68  |e subdirectory h|
000025c0  61 73 20 6f 70 74 69 6f  6e 73 20 66 6f 72 20 6e  |as options for n|
000025d0  6f 20 65 6e 63 72 79 70  74 69 6f 6e 20 61 6e 64  |o encryption and|
000025e0  20 67 61 72 62 6c 65 2e  20 44 45 53 20 20 20 20  | garble. DES    |
000025f0  20 20 20 20 20 20 20 20  20 20 20 65 6e 63 72 79  |           encry|
00002600  70 74 69 6f 6e 20 69 73  20 6e 6f 74 20 61 76 61  |ption is not ava|
00002610  69 6c 61 62 6c 65 20 69  6e 20 74 68 69 73 20 76  |ilable in this v|
00002620  65 72 73 69 6f 6e 20 61  6e 64 20 73 6f 20 69 73  |ersion and so is|
00002630  20 73 68 61 64 65 64 2e  0a 0a 43 6c 6f 73 65 20  | shaded...Close |
00002640  61 72 63 20 2d 20 43 6c  6f 73 65 73 20 74 68 65  |arc - Closes the|
00002650  20 63 75 72 72 65 6e 74  6c 79 20 6f 70 65 6e 20  | currently open |
00002660  61 72 63 68 69 76 65 20  61 6e 64 20 61 6c 6c 20  |archive and all |
00002670  61 72 63 66 73 20 64 69  72 65 63 74 6f 72 79 0a  |arcfs directory.|
00002680  20 20 20 20 20 20 20 20  20 20 20 20 77 69 6e 64  |            wind|
00002690  6f 77 73 2e 0a 0a 4b 69  6c 6c 20 20 20 20 20 20  |ows...Kill      |
000026a0  2d 20 43 6c 6f 73 65 73  20 74 68 65 20 63 75 72  |- Closes the cur|
000026b0  72 65 6e 74 20 61 72 63  68 69 76 65 2c 20 72 65  |rent archive, re|
000026c0  6d 6f 76 65 73 20 61 6c  6c 20 61 72 63 66 73 20  |moves all arcfs |
000026d0  64 69 72 65 63 74 6f 72  79 20 77 69 6e 64 6f 77  |directory window|
000026e0  73 2c 0a 20 20 20 20 20  20 20 20 20 20 20 20 4b  |s,.            K|
000026f0  69 6c 6c 73 20 74 68 65  20 41 72 63 46 53 20 6d  |ills the ArcFS m|
00002700  6f 64 75 6c 65 20 61 6e  64 20 51 75 69 74 73 20  |odule and Quits |
00002710  74 68 65 20 41 72 63 46  53 20 46 69 6c 65 72 2e  |the ArcFS Filer.|
00002720  0a 0a 51 75 69 74 20 20  20 20 20 20 2d 20 51 75  |..Quit      - Qu|
00002730  69 74 73 20 74 68 65 20  41 72 63 46 53 20 46 69  |its the ArcFS Fi|
00002740  6c 65 72 2e 0a 0a 4b 69  6c 6c 20 61 6e 64 20 51  |ler...Kill and Q|
00002750  75 69 74 20 62 6f 74 68  20 70 72 6f 6d 70 74 20  |uit both prompt |
00002760  66 6f 72 20 63 6f 6e 66  69 72 6d 61 74 69 6f 6e  |for confirmation|
00002770  2e 20 43 6c 69 63 6b 20  6f 6e 20 4f 4b 20 74 6f  |. Click on OK to|
00002780  20 4b 69 6c 6c 2f 51 75  69 74 20 6f 72 0a 43 61  | Kill/Quit or.Ca|
00002790  6e 63 65 6c 20 6f 74 68  65 72 77 69 73 65 2e 20  |ncel otherwise. |
000027a0  4e 6f 74 65 20 70 72 65  73 73 69 6e 67 20 65 73  |Note pressing es|
000027b0  63 61 70 65 20 68 61 73  20 74 68 65 20 73 61 6d  |cape has the sam|
000027c0  65 20 65 66 66 65 63 74  20 61 73 20 63 6c 69 63  |e effect as clic|
000027d0  6b 69 6e 67 20 6f 6e 20  4f 4b 2e 0a 0a 0a 41 6c  |king on OK....Al|
000027e0  6c 20 63 6f 6d 6d 65 6e  74 73 20 61 6e 64 20 73  |l comments and s|
000027f0  75 67 67 65 73 74 69 6f  6e 73 20 66 6f 72 20 66  |uggestions for f|
00002800  75 74 75 72 65 20 69 6d  70 72 6f 76 65 6d 65 6e  |uture improvemen|
00002810  74 20 61 72 65 20 77 65  6c 63 6f 6d 65 20 62 75  |t are welcome bu|
00002820  74 20 70 6c 65 61 73 65  0a 6e 6f 74 65 20 74 68  |t please.note th|
00002830  61 74 20 49 20 63 61 6e  6e 6f 74 20 72 65 70 6c  |at I cannot repl|
00002840  79 20 74 6f 20 6c 65 74  74 65 72 73 20 77 69 74  |y to letters wit|
00002850  68 6f 75 74 20 72 65 74  75 72 6e 20 70 6f 73 74  |hout return post|
00002860  61 67 65 20 61 6e 64 20  61 6e 20 61 64 64 72 65  |age and an addre|
00002870  73 73 65 64 0a 65 6e 76  65 6c 6f 70 65 2e 0a 0a  |ssed.envelope...|
00002880  54 68 65 20 61 64 64 72  65 73 73 20 69 73 3a 0a  |The address is:.|
00002890  0a 20 20 20 20 4d 72 2e  20 4d 2e 20 53 6d 69 74  |.    Mr. M. Smit|
000028a0  68 0a 20 20 20 20 50 65  6e 2d 79 2d 64 72 65 2c  |h.    Pen-y-dre,|
000028b0  0a 20 20 20 20 52 69 76  65 72 73 69 64 65 20 41  |.    Riverside A|
000028c0  76 65 2e 2c 0a 20 20 20  20 42 72 6f 78 62 6f 75  |ve.,.    Broxbou|
000028d0  72 6e 65 2c 0a 20 20 20  20 48 65 72 74 73 2e 2c  |rne,.    Herts.,|
000028e0  0a 20 20 20 20 45 4e 31  30 20 36 52 44 2e 0a 0a  |.    EN10 6RD...|
000028f0  49 20 77 6f 75 6c 64 20  61 6c 73 6f 2c 20 6f 66  |I would also, of|
00002900  20 63 6f 75 72 73 65 20  77 65 6c 63 6f 6d 65 20  | course welcome |
00002910  64 65 74 61 69 6c 73 20  6f 66 20 61 6e 79 20 62  |details of any b|
00002920  75 67 73 20 64 69 73 63  6f 76 65 72 65 64 20 73  |ugs discovered s|
00002930  6f 20 74 68 61 74 20 49  20 63 61 6e 0a 63 6f 72  |o that I can.cor|
00002940  72 65 63 74 20 74 68 65  6d 2e 0a 0a 56 65 72 73  |rect them...Vers|
00002950  69 6f 6e 20 49 6d 70 72  6f 76 65 6d 65 6e 74 73  |ion Improvements|
00002960  0a 0a 76 30 2e 32 30 20  46 69 72 73 74 20 52 65  |..v0.20 First Re|
00002970  6c 65 61 73 65 20 76 65  72 73 69 6f 6e 0a 76 30  |lease version.v0|
00002980  2e 32 31 20 4d 61 78 20  6e 75 6d 62 65 72 20 6f  |.21 Max number o|
00002990  66 20 64 69 72 65 63 74  6f 72 79 20 6c 65 76 65  |f directory leve|
000029a0  6c 73 20 69 6e 63 72 65  61 73 65 64 20 66 72 6f  |ls increased fro|
000029b0  6d 20 31 36 20 74 6f 20  36 34 2c 20 73 6f 6d 65  |m 16 to 64, some|
000029c0  20 74 69 64 79 69 6e 67  0a 76 30 2e 32 32 20 53  | tidying.v0.22 S|
000029d0  6e 6f 77 65 64 20 69 6e  20 38 74 68 20 46 65 62  |nowed in 8th Feb|
000029e0  20 39 31 20 73 6f 20 6d  61 64 65 20 65 78 74 65  | 91 so made exte|
000029f0  6e 73 69 76 65 20 63 68  61 6e 67 65 73 3a 20 55  |nsive changes: U|
00002a00  52 44 20 61 6e 64 20 50  53 44 20 6e 6f 77 20 20  |RD and PSD now  |
00002a10  20 20 20 20 20 20 20 20  20 20 20 20 73 75 70 70  |            supp|
00002a20  6f 72 74 65 64 2e 20 43  6f 6d 6d 61 6e 64 73 20  |orted. Commands |
00002a30  2a 42 61 63 6b 20 61 6e  64 20 2a 55 52 44 20 70  |*Back and *URD p|
00002a40  72 6f 76 69 64 65 64 2e  20 2a 46 69 6c 65 49 6e  |rovided. *FileIn|
00002a50  66 6f 20 63 6f 6d 6d 61  6e 64 20 61 64 64 65 64  |fo command added|
00002a60  2e 20 20 20 20 20 20 20  20 43 6f 6d 70 72 65 73  |.        Compres|
00002a70  73 69 6f 6e 20 66 6f 72  6d 61 74 20 72 65 6d 6f  |sion format remo|
00002a80  76 65 64 20 66 72 6f 6d  20 2a 49 6e 66 6f 20 61  |ved from *Info a|
00002a90  6e 64 20 2a 45 58 20 6f  75 74 70 75 74 20 28 6e  |nd *EX output (n|
00002aa0  6f 77 20 67 69 76 65 6e  20 62 79 20 20 20 20 20  |ow given by     |
00002ab0  20 20 20 20 20 20 2a 46  69 6c 65 49 6e 66 6f 29  |      *FileInfo)|
00002ac0  2e 20 2a 49 6e 66 6f 20  26 20 2a 46 69 6c 65 49  |. *Info & *FileI|
00002ad0  6e 66 6f 20 6e 6f 77 20  67 69 76 65 20 69 6e 66  |nfo now give inf|
00002ae0  6f 72 6d 61 74 69 6f 6e  20 6f 6e 20 6d 75 6c 74  |ormation on mult|
00002af0  69 70 6c 65 20 20 20 20  20 20 20 20 20 20 20 20  |iple            |
00002b00  20 20 20 77 69 6c 64 63  61 72 64 65 64 20 66 69  |   wildcarded fi|
00002b10  6c 65 73 2e 20 43 6f 6d  70 72 65 73 73 65 64 20  |les. Compressed |
00002b20  66 69 6c 65 20 73 69 7a  65 20 6e 6f 77 20 73 74  |file size now st|
00002b30  6f 72 65 64 20 69 6e 20  74 68 65 20 74 6f 70 20  |ored in the top |
00002b40  32 34 20 62 69 74 73 20  6f 66 20 20 20 20 20 20  |24 bits of      |
00002b50  74 68 65 20 66 69 6c 65  20 61 74 74 72 69 62 75  |the file attribu|
00002b60  74 65 73 2e 20 50 43 20  66 6f 72 6d 61 74 20 66  |tes. PC format f|
00002b70  69 6c 65 73 20 61 72 65  20 6e 6f 77 20 73 75 70  |iles are now sup|
00002b80  70 6f 72 74 65 64 2e 20  53 75 70 70 6c 69 65 64  |ported. Supplied|
00002b90  20 77 69 74 68 20 20 20  20 20 20 20 20 6e 65 77  | with        new|
00002ba0  20 41 72 63 46 53 20 46  69 6c 65 72 20 77 69 74  | ArcFS Filer wit|
00002bb0  68 20 69 63 6f 6e 20 61  6e 64 20 6d 65 6e 75 2e  |h icon and menu.|
00002bc0  0a 76 30 2e 32 33 20 43  6f 72 72 65 63 74 65 64  |.v0.23 Corrected|
00002bd0  20 32 20 62 75 67 73 20  2d 20 41 72 63 46 53 20  | 2 bugs - ArcFS |
00002be0  64 69 64 20 6e 6f 74 20  72 65 6c 65 61 73 65 20  |did not release |
00002bf0  31 36 6b 20 6f 66 20 63  6c 61 69 6d 65 64 20 6d  |16k of claimed m|
00002c00  65 6d 6f 72 79 20 77 68  65 6e 20 61 6e 20 20 20  |emory when an   |
00002c10  20 20 20 20 65 72 72 6f  72 20 6f 63 63 75 72 65  |    error occure|
00002c20  64 20 64 75 72 69 6e 67  20 74 68 65 20 6c 6f 61  |d during the loa|
00002c30  64 20 63 72 75 6e 63 68  20 72 6f 75 74 69 6e 65  |d crunch routine|
00002c40  2e 20 49 66 20 79 6f 75  20 63 61 6e 63 65 6c 6c  |. If you cancell|
00002c50  65 64 20 61 20 20 20 20  20 20 20 20 20 20 20 20  |ed a            |
00002c60  20 72 65 71 75 65 73 74  20 66 72 6f 6d 20 74 68  | request from th|
00002c70  65 20 6c 6f 61 64 20 70  61 63 6b 20 72 6f 75 74  |e load pack rout|
00002c80  69 6e 65 20 74 6f 20 69  6e 73 65 72 74 20 61 20  |ine to insert a |
00002c90  64 69 73 6b 20 74 68 65  20 72 65 71 75 65 73 74  |disk the request|
00002ca0  20 77 61 73 20 20 20 20  20 20 20 20 20 20 72 65  | was          re|
00002cb0  70 65 61 74 65 64 20 61  20 73 65 63 6f 6e 64 20  |peated a second |
00002cc0  74 69 6d 65 2e 0a 76 30  2e 33 30 20 4e 6f 77 20  |time..v0.30 Now |
00002cd0  61 64 64 65 64 20 73 75  70 70 6f 72 74 20 66 6f  |added support fo|
00002ce0  72 20 73 71 75 61 73 68  65 64 20 61 6e 64 20 63  |r squashed and c|
00002cf0  6f 6d 70 72 65 73 73 65  64 20 66 6f 72 6d 61 74  |ompressed format|
00002d00  73 2e 20 41 6c 73 6f 20  61 64 64 65 64 20 20 20  |s. Also added   |
00002d10  20 20 20 20 20 20 20 20  20 73 75 70 70 6f 72 74  |         support|
00002d20  20 66 6f 72 20 47 61 72  62 6c 65 64 20 66 69 6c  | for Garbled fil|
00002d30  65 73 2c 20 2a 47 61 72  62 6c 65 20 61 6e 64 20  |es, *Garble and |
00002d40  2a 4e 6f 45 6e 63 72 79  70 74 69 6f 6e 20 63 6f  |*NoEncryption co|
00002d50  6d 6d 61 6e 64 73 20 70  72 6f 76 69 64 65 64 2e  |mmands provided.|
00002d60  20 20 20 20 20 20 43 6f  6d 70 72 65 68 65 6e 73  |      Comprehens|
00002d70  69 76 65 20 65 72 72 6f  72 20 63 68 65 63 6b 69  |ive error checki|
00002d80  6e 67 20 63 68 65 63 6b  73 20 66 6f 72 20 63 6f  |ng checks for co|
00002d90  72 72 75 70 74 65 64 20  64 61 74 61 20 61 6e 64  |rrupted data and|
00002da0  2f 6f 72 20 70 61 73 73  77 6f 72 64 73 20 20 20  |/or passwords   |
00002db0  20 20 20 61 6e 64 20 66  69 6c 65 20 65 6e 63 72  |   and file encr|
00002dc0  79 70 74 69 6f 6e 20 6d  65 74 68 6f 64 73 20 69  |yption methods i|
00002dd0  6e 63 6f 6e 73 69 73 74  65 6e 74 20 77 69 74 68  |nconsistent with|
00002de0  20 74 68 6f 73 65 20 74  68 61 74 20 68 61 76 65  | those that have|
00002df0  20 62 65 65 6e 20 73 65  74 2e 0a 0a a9 20 31 39  | been set.... 19|
00002e00  39 31 20 4d 2e 20 53 6d  69 74 68                 |91 M. Smith|
00002e0b