Home » Archimedes archive » Archimedes World » AW-1991-04.adf » !ArcFS/!Help
!ArcFS/!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-04.adf |
Filename: | !ArcFS/!Help |
Read OK: | ✔ |
File size: | 16F8 bytes |
Load address: | FFFFFF42 |
Exec address: | EE3CEAE9 |
File contents
!Help file for ArcFS version 0.21 by M.Smith This filing system was written as a replacement for SparkPlug which is sometimes very difficult and inconvenient to use. I would, however like to thank David Pilling, the author of Spark and SparkPlug for two very useful applications without which this filing system would not be possible. 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). If used with wildcards the current version only gives info on the first matching object. FSEntry_Func 15 to respond to requests from the Filer for the necessary information to display a directory window 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 then 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 and new format stored objects but not squashed or 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 P.C. format objects or old format stored objects cannot be opened. Just over 16K free memory is required to load or open Crunched files. Simultaneously open archives This version of ArcFS supports only one open archive at a time. Future versions may support many 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. (*Ex and *Info also give the compression format of the data) User Root Directories (U.R.D.'s) This is not supported at present but will probably be supported in the near future. Attempts to use it will give 'Not found' errors 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.). 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 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 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
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 32 |rcFS version 0.2| 00000020 31 20 0a 62 79 20 4d 2e 53 6d 69 74 68 0a 0a 54 |1 .by M.Smith..T| 00000030 68 69 73 20 66 69 6c 69 6e 67 20 73 79 73 74 65 |his filing syste| 00000040 6d 20 77 61 73 20 77 72 69 74 74 65 6e 20 61 73 |m was written as| 00000050 20 61 20 72 65 70 6c 61 63 65 6d 65 6e 74 20 66 | a replacement f| 00000060 6f 72 20 53 70 61 72 6b 50 6c 75 67 20 77 68 69 |or SparkPlug whi| 00000070 63 68 20 69 73 20 0a 73 6f 6d 65 74 69 6d 65 73 |ch is .sometimes| 00000080 20 76 65 72 79 20 64 69 66 66 69 63 75 6c 74 20 | very difficult | 00000090 61 6e 64 20 69 6e 63 6f 6e 76 65 6e 69 65 6e 74 |and inconvenient| 000000a0 20 74 6f 20 75 73 65 2e 20 49 20 77 6f 75 6c 64 | to use. I would| 000000b0 2c 20 68 6f 77 65 76 65 72 20 6c 69 6b 65 20 0a |, however like .| 000000c0 74 6f 20 74 68 61 6e 6b 20 44 61 76 69 64 20 50 |to thank David P| 000000d0 69 6c 6c 69 6e 67 2c 20 74 68 65 20 61 75 74 68 |illing, the auth| 000000e0 6f 72 20 6f 66 20 53 70 61 72 6b 20 61 6e 64 20 |or of Spark and | 000000f0 53 70 61 72 6b 50 6c 75 67 20 66 6f 72 20 74 77 |SparkPlug for tw| 00000100 6f 20 76 65 72 79 20 0a 75 73 65 66 75 6c 20 61 |o very .useful a| 00000110 70 70 6c 69 63 61 74 69 6f 6e 73 20 77 69 74 68 |pplications with| 00000120 6f 75 74 20 77 68 69 63 68 20 74 68 69 73 20 66 |out which this f| 00000130 69 6c 69 6e 67 20 73 79 73 74 65 6d 20 77 6f 75 |iling system wou| 00000140 6c 64 20 6e 6f 74 20 62 65 20 0a 70 6f 73 73 69 |ld not be .possi| 00000150 62 6c 65 2e 0a 0a 41 72 63 46 53 20 68 61 73 20 |ble...ArcFS has | 00000160 66 69 6c 69 6e 67 20 73 79 73 74 65 6d 20 6e 75 |filing system nu| 00000170 6d 62 65 72 20 35 36 2e 20 4d 79 20 74 68 61 6e |mber 56. My than| 00000180 6b 73 20 74 6f 20 41 63 6f 72 6e 20 66 6f 72 20 |ks to Acorn for | 00000190 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6f |the allocation o| 000001a0 66 0a 74 68 69 73 20 66 69 6c 69 6e 67 20 73 79 |f.this filing sy| 000001b0 73 74 65 6d 20 6e 75 6d 62 65 72 2e 0a 0a 41 72 |stem number...Ar| 000001c0 63 46 53 20 69 73 20 61 20 72 65 61 64 2d 6f 6e |cFS is a read-on| 000001d0 6c 79 20 66 69 6c 69 6e 67 20 73 79 73 74 65 6d |ly filing system| 000001e0 2e 20 55 73 65 20 53 70 61 72 6b 20 74 6f 20 63 |. Use Spark to c| 000001f0 72 65 61 74 65 20 61 72 63 68 69 76 65 73 2e 0a |reate archives..| 00000200 0a 41 72 63 46 53 20 61 6c 6c 6f 77 73 20 74 68 |.ArcFS allows th| 00000210 65 20 6c 6f 61 64 69 6e 67 20 61 6e 64 20 6f 70 |e loading and op| 00000220 65 6e 69 6e 67 20 6f 66 20 28 63 6f 6d 70 72 65 |ening of (compre| 00000230 73 73 65 64 29 20 66 69 6c 65 73 20 69 6e 20 61 |ssed) files in a| 00000240 72 63 68 69 76 65 73 20 0a 61 6c 6d 6f 73 74 20 |rchives .almost | 00000250 61 73 20 65 61 73 69 6c 79 20 61 73 20 66 69 6c |as easily as fil| 00000260 65 73 20 6f 6e 20 41 44 46 53 20 6f 72 20 52 61 |es on ADFS or Ra| 00000270 6d 46 53 2e 20 49 74 20 68 61 73 20 69 74 73 20 |mFS. It has its | 00000280 6f 77 6e 20 41 72 63 46 53 20 66 69 6c 65 72 20 |own ArcFS filer | 00000290 0a 77 68 69 63 68 20 64 69 73 70 6c 61 79 73 20 |.which displays | 000002a0 74 68 65 20 72 6f 6f 74 20 64 69 72 65 63 74 6f |the root directo| 000002b0 72 79 20 69 6e 20 61 20 66 69 6c 65 72 20 77 69 |ry in a filer wi| 000002c0 6e 64 6f 77 20 6f 66 20 61 6e 79 20 61 72 63 68 |ndow of any arch| 000002d0 69 76 65 20 0a 77 68 69 63 68 20 69 73 20 64 6f |ive .which is do| 000002e0 75 62 6c 65 20 63 6c 69 63 6b 65 64 2e 20 46 72 |uble clicked. Fr| 000002f0 6f 6d 20 74 68 65 6e 20 6f 6e 20 66 69 6c 65 73 |om then on files| 00000300 20 61 6e 64 20 61 70 70 6c 69 63 61 74 69 6f 6e | and application| 00000310 73 20 6d 61 79 20 62 65 20 0a 6c 6f 61 64 65 64 |s may be .loaded| 00000320 20 61 73 20 6e 6f 72 6d 61 6c 20 62 79 20 64 6f | as normal by do| 00000330 75 62 6c 65 20 63 6c 69 63 6b 69 6e 67 20 74 68 |uble clicking th| 00000340 65 6d 2e 20 44 69 72 65 63 74 6f 72 69 65 73 20 |em. Directories | 00000350 6d 61 79 20 62 65 20 64 69 73 70 6c 61 79 65 64 |may be displayed| 00000360 20 0a 61 6c 73 6f 20 62 79 20 64 6f 75 62 6c 65 | .also by double| 00000370 20 63 6c 69 63 6b 69 6e 67 20 74 68 65 6d 2e 20 | clicking them. | 00000380 41 72 63 46 53 20 63 61 6e 2c 20 6f 66 20 63 6f |ArcFS can, of co| 00000390 75 72 73 65 2c 20 61 6c 73 6f 20 62 65 20 75 73 |urse, also be us| 000003a0 65 64 20 66 72 6f 6d 20 0a 74 68 65 20 63 6f 6d |ed from .the com| 000003b0 6d 61 6e 64 20 6c 69 6e 65 2e 0a 0a 59 6f 75 20 |mand line...You | 000003c0 6d 61 79 20 6e 6f 74 69 63 65 20 61 20 73 6d 61 |may notice a sma| 000003d0 6c 6c 20 69 6e 63 72 65 61 73 65 20 69 6e 20 74 |ll increase in t| 000003e0 68 65 20 74 69 6d 65 20 74 61 6b 65 6e 20 74 6f |he time taken to| 000003f0 20 6c 6f 61 64 20 66 69 6c 65 73 20 0a 63 6f 6d | load files .com| 00000400 70 61 72 65 64 20 74 6f 20 6c 6f 61 64 69 6e 67 |pared to loading| 00000410 20 66 69 6c 65 73 20 66 72 6f 6d 20 41 44 46 53 | files from ADFS| 00000420 20 61 6e 64 20 61 6c 73 6f 20 74 68 61 74 20 41 | and also that A| 00000430 72 63 46 53 20 74 61 6b 65 73 20 61 20 73 68 6f |rcFS takes a sho| 00000440 72 74 20 0a 74 69 6d 65 20 74 6f 20 4f 70 65 6e |rt .time to Open| 00000450 20 41 72 63 68 69 76 65 73 20 77 68 65 6e 20 74 | Archives when t| 00000460 68 65 79 20 61 72 65 20 64 6f 75 62 6c 65 20 63 |hey are double c| 00000470 6c 69 63 6b 65 64 2e 20 0a 0a 0a 41 72 63 46 53 |licked. ...ArcFS| 00000480 20 73 75 70 70 6f 72 74 73 20 74 68 65 20 66 6f | supports the fo| 00000490 6c 6c 6f 77 69 6e 67 20 65 6e 74 72 79 20 70 6f |llowing entry po| 000004a0 69 6e 74 73 3a 0a 0a 20 20 20 20 46 53 45 6e 74 |ints:.. FSEnt| 000004b0 72 79 5f 46 75 6e 63 20 30 20 74 6f 20 73 65 74 |ry_Func 0 to set| 000004c0 20 63 75 72 72 65 6e 74 20 64 69 72 65 63 74 6f | current directo| 000004d0 72 79 20 28 2a 44 69 72 29 0a 0a 20 20 20 20 46 |ry (*Dir).. F| 000004e0 53 45 6e 74 72 79 5f 46 75 6e 63 20 31 20 74 6f |SEntry_Func 1 to| 000004f0 20 73 65 74 20 6c 69 62 72 61 72 79 20 64 69 72 | set library dir| 00000500 65 63 74 6f 72 79 20 28 2a 4c 69 62 29 0a 0a 20 |ectory (*Lib).. | 00000510 20 20 20 46 53 45 6e 74 72 79 5f 46 75 6e 63 20 | FSEntry_Func | 00000520 32 20 74 6f 20 63 61 74 61 6c 6f 67 75 65 20 64 |2 to catalogue d| 00000530 69 72 65 63 74 6f 72 79 20 28 2a 43 61 74 29 0a |irectory (*Cat).| 00000540 0a 20 20 20 20 46 53 45 6e 74 72 79 5f 46 75 6e |. FSEntry_Fun| 00000550 63 20 33 20 74 6f 20 65 78 61 6d 69 6e 65 20 64 |c 3 to examine d| 00000560 69 72 65 63 74 6f 72 79 20 28 2a 45 58 29 0a 0a |irectory (*EX)..| 00000570 20 20 20 20 46 53 45 6e 74 72 79 5f 46 75 6e 63 | FSEntry_Func| 00000580 20 34 20 74 6f 20 63 61 74 61 6c 6f 67 75 65 20 | 4 to catalogue | 00000590 6c 69 62 72 61 72 79 20 64 69 72 65 63 74 6f 72 |library director| 000005a0 79 20 28 2a 4c 43 61 74 29 0a 0a 20 20 20 20 46 |y (*LCat).. F| 000005b0 53 45 6e 74 72 79 5f 46 75 6e 63 20 35 20 74 6f |SEntry_Func 5 to| 000005c0 20 65 78 61 6d 69 6e 65 20 6c 69 62 72 61 72 79 | examine library| 000005d0 20 64 69 72 65 63 74 6f 72 79 20 28 2a 4c 45 58 | directory (*LEX| 000005e0 29 0a 0a 20 20 20 20 46 53 45 6e 74 72 79 5f 46 |).. FSEntry_F| 000005f0 75 6e 63 20 36 20 74 6f 20 65 78 61 6d 69 6e 65 |unc 6 to examine| 00000600 20 6f 62 6a 65 63 74 73 20 28 2a 49 6e 66 6f 29 | objects (*Info)| 00000610 2e 20 49 66 20 75 73 65 64 20 77 69 74 68 20 77 |. If used with w| 00000620 69 6c 64 63 61 72 64 73 20 74 68 65 0a 20 20 20 |ildcards the. | 00000630 20 63 75 72 72 65 6e 74 20 76 65 72 73 69 6f 6e | current version| 00000640 20 6f 6e 6c 79 20 67 69 76 65 73 20 69 6e 66 6f | only gives info| 00000650 20 6f 6e 20 74 68 65 20 66 69 72 73 74 20 6d 61 | on the first ma| 00000660 74 63 68 69 6e 67 20 6f 62 6a 65 63 74 2e 0a 0a |tching object...| 00000670 20 20 20 20 46 53 45 6e 74 72 79 5f 46 75 6e 63 | FSEntry_Func| 00000680 20 31 35 20 74 6f 20 72 65 73 70 6f 6e 64 20 74 | 15 to respond t| 00000690 6f 20 72 65 71 75 65 73 74 73 20 66 72 6f 6d 20 |o requests from | 000006a0 74 68 65 20 46 69 6c 65 72 20 66 6f 72 20 0a 20 |the Filer for . | 000006b0 20 20 20 74 68 65 20 6e 65 63 65 73 73 61 72 79 | the necessary| 000006c0 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 6f 20 | information to | 000006d0 64 69 73 70 6c 61 79 20 61 20 64 69 72 65 63 74 |display a direct| 000006e0 6f 72 79 20 77 69 6e 64 6f 77 0a 0a 20 20 20 20 |ory window.. | 000006f0 46 53 45 6e 74 72 79 5f 46 69 6c 65 20 35 20 74 |FSEntry_File 5 t| 00000700 6f 20 72 65 61 64 20 63 61 74 61 6c 6f 67 75 65 |o read catalogue| 00000710 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 | information on | 00000720 61 20 66 69 6c 65 0a 0a 20 20 20 20 46 53 45 6e |a file.. FSEn| 00000730 74 72 79 5f 46 69 6c 65 20 32 35 35 20 74 6f 20 |try_File 255 to | 00000740 6c 6f 61 64 20 66 69 6c 65 73 0a 0a 20 20 20 20 |load files.. | 00000750 46 53 45 6e 74 72 79 5f 4f 70 65 6e 20 74 6f 20 |FSEntry_Open to | 00000760 70 72 6f 76 69 64 65 20 66 61 63 69 6c 69 74 69 |provide faciliti| 00000770 65 73 20 66 6f 72 20 6f 70 65 6e 69 6e 67 20 66 |es for opening f| 00000780 69 6c 65 73 20 66 6f 72 20 0a 20 20 20 20 72 61 |iles for . ra| 00000790 6e 64 6f 6d 20 61 63 63 65 73 73 20 69 6e 70 75 |ndom access inpu| 000007a0 74 2e 20 41 72 63 46 53 20 63 6c 61 69 6d 73 20 |t. ArcFS claims | 000007b0 6d 65 6d 6f 72 79 20 66 72 6f 6d 20 74 68 65 20 |memory from the | 000007c0 52 2e 4d 2e 41 2e 20 0a 20 20 20 20 74 68 65 20 |R.M.A. . the | 000007d0 73 69 7a 65 20 6f 66 20 74 68 65 20 75 6e 63 6f |size of the unco| 000007e0 6d 70 72 65 73 73 65 64 20 66 69 6c 65 20 61 6e |mpressed file an| 000007f0 64 20 74 68 65 6e 20 6c 6f 61 64 73 20 74 68 65 |d then loads the| 00000800 20 66 69 6c 65 20 0a 20 20 20 20 69 6e 74 6f 20 | file . into | 00000810 74 68 69 73 20 63 6c 61 69 6d 65 64 20 6d 65 6d |this claimed mem| 00000820 6f 72 79 2e 20 46 6f 72 20 74 68 69 73 20 72 65 |ory. For this re| 00000830 61 73 6f 6e 20 69 74 20 69 73 20 70 6f 73 73 69 |ason it is possi| 00000840 62 6c 65 20 74 6f 20 0a 20 20 20 20 67 65 74 20 |ble to . get | 00000850 27 4e 6f 20 52 6f 6f 6d 20 69 6e 20 52 4d 41 20 |'No Room in RMA | 00000860 65 72 72 6f 72 73 27 20 77 68 65 6e 20 6f 70 65 |errors' when ope| 00000870 6e 69 6e 67 20 6c 61 72 67 65 20 66 69 6c 65 73 |ning large files| 00000880 2e 0a 0a 20 20 20 20 46 53 45 6e 74 72 79 5f 47 |... FSEntry_G| 00000890 65 74 42 79 74 65 73 20 72 65 61 64 73 20 72 65 |etBytes reads re| 000008a0 71 75 69 72 65 64 20 62 79 74 65 73 20 66 72 6f |quired bytes fro| 000008b0 6d 20 6d 65 6d 6f 72 79 20 63 6c 61 69 6d 65 64 |m memory claimed| 000008c0 20 0a 20 20 20 20 62 79 20 46 53 45 6e 74 72 79 | . by FSEntry| 000008d0 5f 4f 70 65 6e 0a 0a 20 20 20 20 46 53 45 6e 74 |_Open.. FSEnt| 000008e0 72 79 5f 43 6c 6f 73 65 20 72 65 6c 65 61 73 65 |ry_Close release| 000008f0 73 20 6d 65 6d 6f 72 79 20 63 6c 61 69 6d 65 64 |s memory claimed| 00000900 20 62 79 20 46 53 45 6e 74 72 79 5f 4f 70 65 6e | by FSEntry_Open| 00000910 0a 0a 0a 43 61 74 61 6c 6f 67 75 65 20 53 74 6f |...Catalogue Sto| 00000920 72 61 67 65 20 69 6e 20 6d 65 6d 6f 72 79 0a 0a |rage in memory..| 00000930 57 68 65 6e 20 61 6e 20 61 72 63 68 69 76 65 20 |When an archive | 00000940 69 73 20 6f 70 65 6e 65 64 20 74 68 65 20 6e 75 |is opened the nu| 00000950 6d 62 65 72 20 6f 66 20 6f 62 6a 65 63 74 73 20 |mber of objects | 00000960 69 6e 20 74 68 65 20 61 72 63 68 69 76 65 20 69 |in the archive i| 00000970 73 20 0a 63 6f 75 6e 74 65 64 20 61 6e 64 20 61 |s .counted and a| 00000980 20 62 6c 6f 63 6b 20 6f 66 20 52 2e 4d 2e 41 2e | block of R.M.A.| 00000990 2c 20 33 32 20 62 79 74 65 73 20 66 6f 72 20 65 |, 32 bytes for e| 000009a0 61 63 68 20 6f 62 6a 65 63 74 20 69 73 20 63 6c |ach object is cl| 000009b0 61 69 6d 65 64 20 61 6e 64 20 0a 74 68 65 20 63 |aimed and .the c| 000009c0 61 74 61 6c 6f 67 75 65 20 69 6e 66 6f 72 6d 61 |atalogue informa| 000009d0 74 69 6f 6e 20 69 73 20 72 65 61 64 20 69 6e 74 |tion is read int| 000009e0 6f 20 74 68 69 73 20 62 6c 6f 63 6b 0a 0a 43 6f |o this block..Co| 000009f0 6d 70 72 65 73 73 69 6f 6e 20 66 6f 72 6d 61 74 |mpression format| 00000a00 73 0a 0a 54 68 69 73 20 76 65 72 73 69 6f 6e 20 |s..This version | 00000a10 6f 66 20 41 72 63 46 53 20 73 75 70 70 6f 72 74 |of ArcFS support| 00000a20 73 20 63 72 75 6e 63 68 65 64 2c 20 70 61 63 6b |s crunched, pack| 00000a30 65 64 20 61 6e 64 20 6e 65 77 20 66 6f 72 6d 61 |ed and new forma| 00000a40 74 20 73 74 6f 72 65 64 20 0a 6f 62 6a 65 63 74 |t stored .object| 00000a50 73 20 62 75 74 20 6e 6f 74 20 73 71 75 61 73 68 |s but not squash| 00000a60 65 64 20 6f 72 20 63 6f 6d 70 72 65 73 73 65 64 |ed or compressed| 00000a70 20 6f 62 6a 65 63 74 73 2e 20 4f 62 6a 65 63 74 | objects. Object| 00000a80 73 20 69 6e 20 61 20 66 6f 72 6d 61 74 20 0a 74 |s in a format .t| 00000a90 68 61 74 20 41 72 63 46 53 20 63 61 6e 6e 6f 74 |hat ArcFS cannot| 00000aa0 20 68 61 6e 64 6c 65 20 77 69 6c 6c 20 67 69 76 | handle will giv| 00000ab0 65 20 27 43 61 6e 27 74 20 68 61 6e 64 6c 65 20 |e 'Can't handle | 00000ac0 61 72 63 68 69 76 65 27 20 65 72 72 6f 72 73 20 |archive' errors | 00000ad0 77 68 65 6e 20 0a 79 6f 75 20 61 74 74 65 6d 70 |when .you attemp| 00000ae0 74 20 74 6f 20 6c 6f 61 64 20 74 68 65 6d 2e 20 |t to load them. | 00000af0 41 72 63 68 69 76 65 73 20 63 6f 6e 74 61 69 6e |Archives contain| 00000b00 69 6e 67 20 50 2e 43 2e 20 66 6f 72 6d 61 74 20 |ing P.C. format | 00000b10 6f 62 6a 65 63 74 73 20 6f 72 20 0a 6f 6c 64 20 |objects or .old | 00000b20 66 6f 72 6d 61 74 20 73 74 6f 72 65 64 20 6f 62 |format stored ob| 00000b30 6a 65 63 74 73 20 63 61 6e 6e 6f 74 20 62 65 20 |jects cannot be | 00000b40 6f 70 65 6e 65 64 2e 20 4a 75 73 74 20 6f 76 65 |opened. Just ove| 00000b50 72 20 31 36 4b 20 66 72 65 65 20 6d 65 6d 6f 72 |r 16K free memor| 00000b60 79 20 0a 69 73 20 72 65 71 75 69 72 65 64 20 74 |y .is required t| 00000b70 6f 20 6c 6f 61 64 20 6f 72 20 6f 70 65 6e 20 43 |o load or open C| 00000b80 72 75 6e 63 68 65 64 20 66 69 6c 65 73 2e 0a 0a |runched files...| 00000b90 53 69 6d 75 6c 74 61 6e 65 6f 75 73 6c 79 20 6f |Simultaneously o| 00000ba0 70 65 6e 20 61 72 63 68 69 76 65 73 0a 0a 54 68 |pen archives..Th| 00000bb0 69 73 20 76 65 72 73 69 6f 6e 20 6f 66 20 41 72 |is version of Ar| 00000bc0 63 46 53 20 73 75 70 70 6f 72 74 73 20 6f 6e 6c |cFS supports onl| 00000bd0 79 20 6f 6e 65 20 6f 70 65 6e 20 61 72 63 68 69 |y one open archi| 00000be0 76 65 20 61 74 20 61 20 74 69 6d 65 2e 20 46 75 |ve at a time. Fu| 00000bf0 74 75 72 65 20 0a 76 65 72 73 69 6f 6e 73 20 6d |ture .versions m| 00000c00 61 79 20 73 75 70 70 6f 72 74 20 6d 61 6e 79 20 |ay support many | 00000c10 64 69 66 66 65 72 65 6e 74 20 6e 61 6d 65 64 20 |different named | 00000c20 61 72 63 68 69 76 65 73 20 73 65 6c 65 63 74 65 |archives selecte| 00000c30 64 20 62 79 20 74 68 65 20 0a 69 6e 63 6c 75 73 |d by the .inclus| 00000c40 69 6f 6e 20 6f 66 20 74 68 65 20 6e 61 6d 65 20 |ion of the name | 00000c50 69 6e 20 61 20 73 70 65 63 69 61 6c 20 66 69 65 |in a special fie| 00000c60 6c 64 2e 20 54 68 69 73 20 76 65 72 73 69 6f 6e |ld. This version| 00000c70 20 73 75 70 70 6f 72 74 73 20 62 75 74 20 0a 69 | supports but .i| 00000c80 67 6e 6f 72 65 73 20 73 70 65 63 69 61 6c 20 66 |gnores special f| 00000c90 69 65 6c 64 73 20 61 6c 6c 6f 77 69 6e 67 20 74 |ields allowing t| 00000ca0 68 65 20 41 72 63 46 53 20 66 69 6c 65 72 20 74 |he ArcFS filer t| 00000cb0 6f 20 69 6e 63 6c 75 64 65 20 74 68 65 20 6c 65 |o include the le| 00000cc0 61 66 6e 61 6d 65 20 0a 6f 66 20 74 68 65 20 61 |afname .of the a| 00000cd0 72 63 68 69 76 65 20 61 73 20 74 68 65 20 73 70 |rchive as the sp| 00000ce0 65 63 69 61 6c 20 66 69 65 6c 64 20 73 6f 20 74 |ecial field so t| 00000cf0 68 61 74 20 74 68 65 20 75 73 65 72 20 63 61 6e |hat the user can| 00000d00 20 73 65 65 20 61 74 20 61 20 0a 67 6c 61 6e 63 | see at a .glanc| 00000d10 65 20 77 68 69 63 68 20 61 72 63 68 69 76 65 20 |e which archive | 00000d20 69 73 20 6f 70 65 6e 2e 0a 0a 53 63 72 65 65 6e |is open...Screen| 00000d30 20 4f 75 74 70 75 74 20 66 6f 72 6d 61 74 0a 0a | Output format..| 00000d40 53 63 72 65 65 6e 20 4f 75 74 70 75 74 20 66 6f |Screen Output fo| 00000d50 6c 6c 6f 77 73 20 74 68 61 74 20 6f 66 20 46 69 |llows that of Fi| 00000d60 6c 65 63 6f 72 65 20 61 73 20 63 6c 6f 73 65 6c |lecore as closel| 00000d70 79 20 61 73 20 70 6f 73 73 69 62 6c 65 2e 20 28 |y as possible. (| 00000d80 2a 45 78 20 61 6e 64 0a 2a 49 6e 66 6f 20 61 6c |*Ex and.*Info al| 00000d90 73 6f 20 67 69 76 65 20 74 68 65 20 63 6f 6d 70 |so give the comp| 00000da0 72 65 73 73 69 6f 6e 20 66 6f 72 6d 61 74 20 6f |ression format o| 00000db0 66 20 74 68 65 20 64 61 74 61 29 0a 0a 55 73 65 |f the data)..Use| 00000dc0 72 20 52 6f 6f 74 20 44 69 72 65 63 74 6f 72 69 |r Root Directori| 00000dd0 65 73 20 28 55 2e 52 2e 44 2e 27 73 29 0a 0a 54 |es (U.R.D.'s)..T| 00000de0 68 69 73 20 69 73 20 6e 6f 74 20 73 75 70 70 6f |his is not suppo| 00000df0 72 74 65 64 20 61 74 20 70 72 65 73 65 6e 74 20 |rted at present | 00000e00 62 75 74 20 77 69 6c 6c 20 70 72 6f 62 61 62 6c |but will probabl| 00000e10 79 20 20 62 65 20 73 75 70 70 6f 72 74 65 64 20 |y be supported | 00000e20 69 6e 20 0a 74 68 65 20 6e 65 61 72 20 66 75 74 |in .the near fut| 00000e30 75 72 65 2e 20 41 74 74 65 6d 70 74 73 20 74 6f |ure. Attempts to| 00000e40 20 75 73 65 20 69 74 20 77 69 6c 6c 20 67 69 76 | use it will giv| 00000e50 65 20 27 4e 6f 74 20 66 6f 75 6e 64 27 20 65 72 |e 'Not found' er| 00000e60 72 6f 72 73 0a 0a 41 75 74 6f 6d 61 74 69 63 20 |rors..Automatic | 00000e70 6c 69 62 72 61 72 79 20 73 65 6c 65 63 74 69 6f |library selectio| 00000e80 6e 0a 0a 49 66 20 41 72 63 46 53 20 66 69 6e 64 |n..If ArcFS find| 00000e90 73 20 61 20 64 69 72 65 63 74 6f 72 79 20 73 74 |s a directory st| 00000ea0 61 72 74 69 6e 67 20 77 69 74 68 20 74 68 65 20 |arting with the | 00000eb0 6c 65 74 74 65 72 73 20 27 4c 69 62 27 20 69 6e |letters 'Lib' in| 00000ec0 20 74 68 65 20 72 6f 6f 74 0a 64 69 72 65 63 74 | the root.direct| 00000ed0 6f 72 79 20 6f 66 20 61 6e 20 61 72 63 68 69 76 |ory of an archiv| 00000ee0 65 20 77 68 65 6e 20 69 74 20 69 73 20 6f 70 65 |e when it is ope| 00000ef0 6e 20 69 74 20 73 65 6c 65 63 74 73 20 74 68 69 |n it selects thi| 00000f00 73 20 61 73 20 74 68 65 20 6c 69 62 72 61 72 79 |s as the library| 00000f10 0a 64 69 72 65 63 74 6f 72 79 2c 20 6f 74 68 65 |.directory, othe| 00000f20 72 77 69 73 65 20 74 68 65 20 72 6f 6f 74 20 64 |rwise the root d| 00000f30 69 72 65 63 74 6f 72 79 20 28 24 29 20 69 73 20 |irectory ($) is | 00000f40 73 65 6c 65 63 74 65 64 2e 0a 0a 55 6e 73 65 74 |selected...Unset| 00000f50 20 44 69 72 65 63 74 6f 72 79 20 63 6f 6e 74 65 | Directory conte| 00000f60 78 74 73 0a 0a 54 68 69 73 20 69 73 20 6e 6f 74 |xts..This is not| 00000f70 20 73 75 70 70 6f 72 74 65 64 2e 20 41 6c 6c 20 | supported. All | 00000f80 64 69 72 65 63 74 6f 72 79 20 63 6f 6e 74 65 78 |directory contex| 00000f90 74 73 20 61 72 65 20 73 65 74 20 74 6f 20 27 24 |ts are set to '$| 00000fa0 27 20 77 68 65 6e 20 61 6e 0a 61 72 63 68 69 76 |' when an.archiv| 00000fb0 65 20 69 73 20 6f 70 65 6e 65 64 20 28 75 6e 6c |e is opened (unl| 00000fc0 65 73 73 20 61 6e 20 61 75 74 6f 6d 61 74 69 63 |ess an automatic| 00000fd0 20 6c 69 62 72 61 72 79 20 73 65 6c 65 63 74 69 | library selecti| 00000fe0 6f 6e 20 69 73 20 6d 61 64 65 2c 20 73 65 65 0a |on is made, see.| 00000ff0 61 62 6f 76 65 29 2e 0a 0a 52 61 6e 64 6f 6d 20 |above)...Random | 00001000 61 63 63 65 73 73 20 66 69 6c 69 6e 67 0a 0a 46 |access filing..F| 00001010 69 6c 65 73 20 61 72 65 20 64 65 63 6f 6d 70 72 |iles are decompr| 00001020 65 73 73 65 64 20 61 6e 64 20 68 65 6c 64 20 69 |essed and held i| 00001030 6e 20 52 2e 4d 2e 41 2e 20 77 68 69 6c 73 74 20 |n R.M.A. whilst | 00001040 74 68 65 79 20 61 72 65 20 6f 70 65 6e 2e 20 59 |they are open. Y| 00001050 6f 75 20 0a 73 68 6f 75 6c 64 20 6e 6f 74 65 20 |ou .should note | 00001060 74 68 61 74 20 77 68 65 6e 20 73 70 72 69 74 65 |that when sprite| 00001070 20 66 69 6c 65 73 20 61 72 65 20 6c 6f 61 64 65 | files are loade| 00001080 64 20 74 68 65 79 20 61 72 65 20 6f 70 65 6e 65 |d they are opene| 00001090 64 20 66 6f 72 20 0a 72 61 6e 64 6f 6d 20 61 63 |d for .random ac| 000010a0 63 65 73 73 20 69 6e 70 75 74 20 61 6e 64 20 74 |cess input and t| 000010b0 68 65 72 65 66 6f 72 65 20 74 68 65 72 65 20 6e |herefore there n| 000010c0 65 65 64 73 20 74 6f 20 62 65 20 65 6e 6f 75 67 |eeds to be enoug| 000010d0 68 20 66 72 65 65 20 6d 65 6d 6f 72 79 20 0a 61 |h free memory .a| 000010e0 76 61 69 6c 61 62 6c 65 20 77 68 65 6e 20 74 68 |vailable when th| 000010f0 65 20 73 70 72 69 74 65 73 20 61 72 65 20 6c 6f |e sprites are lo| 00001100 61 64 65 64 2e 20 54 68 69 73 20 6d 61 79 20 63 |aded. This may c| 00001110 61 75 73 65 20 70 72 6f 62 6c 65 6d 73 20 77 68 |ause problems wh| 00001120 65 6e 20 0a 6c 61 72 67 65 20 73 70 72 69 74 65 |en .large sprite| 00001130 20 66 69 6c 65 73 20 61 72 65 20 6c 6f 61 64 65 | files are loade| 00001140 64 20 69 6e 74 6f 20 61 20 31 20 4d 62 79 74 65 |d into a 1 Mbyte| 00001150 20 6d 61 63 68 69 6e 65 20 28 61 6e 79 6f 6e 65 | machine (anyone| 00001160 20 77 69 74 68 20 61 6e 20 0a 75 6e 65 78 70 61 | with an .unexpa| 00001170 6e 64 65 64 20 41 33 30 35 20 2d 20 64 6f 6e 27 |nded A305 - don'| 00001180 74 20 62 6f 74 68 65 72 21 29 20 62 75 74 20 49 |t bother!) but I| 00001190 20 63 61 6e 6e 6f 74 20 72 65 61 6c 6c 79 20 73 | cannot really s| 000011a0 75 67 67 65 73 74 20 61 6e 79 74 68 69 6e 67 20 |uggest anything | 000011b0 0a 73 68 6f 72 74 20 6f 66 20 75 70 67 72 61 64 |.short of upgrad| 000011c0 69 6e 67 20 74 6f 20 32 20 4d 62 79 74 65 73 20 |ing to 2 Mbytes | 000011d0 28 6f 74 68 65 72 20 74 68 61 6e 20 6d 61 6b 69 |(other than maki| 000011e0 6e 67 20 73 75 72 65 20 74 68 61 74 20 61 6c 6c |ng sure that all| 000011f0 20 74 68 65 20 0a 70 6f 73 73 69 62 6c 65 20 66 | the .possible f| 00001200 72 65 65 20 6d 65 6d 6f 72 79 20 69 73 20 61 76 |ree memory is av| 00001210 61 69 6c 61 62 6c 65 20 74 6f 20 74 68 65 20 52 |ailable to the R| 00001220 2e 4d 2e 41 2e 29 2e 20 4f 74 68 65 72 20 66 69 |.M.A.). Other fi| 00001230 6c 65 73 20 73 75 63 68 20 61 73 20 0a 45 78 65 |les such as .Exe| 00001240 63 20 61 6e 64 20 4f 62 65 79 20 66 69 6c 65 73 |c and Obey files| 00001250 20 61 72 65 20 61 6c 73 6f 20 6f 70 65 6e 65 64 | are also opened| 00001260 20 66 6f 72 20 72 61 6e 64 6f 6d 20 61 63 63 65 | for random acce| 00001270 73 73 20 69 6e 70 75 74 20 62 75 74 20 74 68 65 |ss input but the| 00001280 73 65 20 0a 61 72 65 20 75 73 75 61 6c 6c 79 20 |se .are usually | 00001290 73 68 6f 72 74 2e 0a 0a 55 73 65 20 77 69 74 68 |short...Use with| 000012a0 20 36 35 48 6f 73 74 20 61 6e 64 20 36 35 54 75 | 65Host and 65Tu| 000012b0 62 65 0a 0a 41 72 63 46 53 20 63 61 6e 20 65 61 |be..ArcFS can ea| 000012c0 73 69 6c 79 20 62 65 20 75 73 65 64 20 77 69 74 |sily be used wit| 000012d0 68 20 36 35 48 6f 73 74 20 61 6e 64 20 36 35 54 |h 65Host and 65T| 000012e0 75 62 65 2e 20 36 35 48 6f 73 74 20 75 73 65 72 |ube. 65Host user| 000012f0 73 20 6d 75 73 74 20 6f 70 65 6e 20 74 68 65 0a |s must open the.| 00001300 72 65 71 75 69 72 65 64 20 61 72 63 68 69 76 65 |required archive| 00001310 20 62 65 66 6f 72 65 20 65 6e 74 65 72 69 6e 67 | before entering| 00001320 20 74 68 65 20 65 6d 75 6c 61 74 6f 72 20 75 6e | the emulator un| 00001330 64 65 72 20 77 68 69 63 68 20 41 72 63 46 53 20 |der which ArcFS | 00001340 69 73 20 73 65 6c 65 63 74 65 64 0a 62 79 3a 0a |is selected.by:.| 00001350 0a 20 20 20 20 2a 44 69 72 20 41 72 63 46 53 3a |. *Dir ArcFS:| 00001360 0a 0a 44 46 53 20 65 6d 75 6c 61 74 69 6f 6e 73 |..DFS emulations| 00001370 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 73 65 74 | may also be set| 00001380 20 75 70 20 69 6e 20 61 72 63 68 69 76 65 73 20 | up in archives | 00001390 28 61 73 20 6f 6e 20 41 44 46 53 29 20 61 6e 64 |(as on ADFS) and| 000013a0 20 75 73 65 64 0a 75 6e 64 65 72 20 36 35 48 6f | used.under 65Ho| 000013b0 73 74 0a 0a 44 69 72 65 63 74 6f 72 79 20 6c 65 |st..Directory le| 000013c0 76 65 6c 73 0a 0a 55 70 20 74 6f 20 36 34 20 64 |vels..Up to 64 d| 000013d0 69 72 65 63 74 6f 72 79 20 6c 65 76 65 6c 73 20 |irectory levels | 000013e0 61 72 65 20 73 75 70 70 6f 72 74 65 64 2e 20 49 |are supported. I| 000013f0 6e 20 74 68 65 20 75 6e 6c 69 6b 65 6c 79 20 65 |n the unlikely e| 00001400 76 65 6e 74 20 74 68 61 74 20 6d 6f 72 65 0a 65 |vent that more.e| 00001410 78 69 73 74 20 69 6e 20 61 6e 20 61 72 63 68 69 |xist in an archi| 00001420 76 65 20 66 75 72 74 68 65 72 20 73 75 62 64 69 |ve further subdi| 00001430 72 65 63 74 6f 72 69 65 73 20 61 72 65 20 73 68 |rectories are sh| 00001440 6f 77 6e 20 61 73 20 61 72 63 68 69 76 65 73 2e |own as archives.| 00001450 0a 0a 43 6f 6d 6d 61 6e 64 73 20 70 72 6f 76 69 |..Commands provi| 00001460 64 65 64 3a 0a 0a 20 20 20 20 2a 41 72 63 46 53 |ded:.. *ArcFS| 00001470 20 2d 20 73 65 6c 65 63 74 73 20 41 72 63 46 53 | - selects ArcFS| 00001480 20 61 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 | as the current | 00001490 66 69 6c 69 6e 67 20 73 79 73 74 65 6d 0a 20 20 |filing system. | 000014a0 20 20 2a 4f 70 65 6e 41 72 63 68 69 76 65 20 3c | *OpenArchive <| 000014b0 4f 62 6a 65 63 74 3e 20 2d 20 4f 70 65 6e 73 20 |Object> - Opens | 000014c0 61 6e 20 61 72 63 68 69 76 65 20 66 6f 72 20 66 |an archive for f| 000014d0 69 6c 65 20 6f 70 65 72 61 74 69 6f 6e 73 0a 20 |ile operations. | 000014e0 20 20 20 2a 43 6c 6f 73 65 41 72 63 68 69 76 65 | *CloseArchive| 000014f0 20 2d 20 43 6c 6f 73 65 73 20 61 6e 79 20 6f 70 | - Closes any op| 00001500 65 6e 20 61 72 63 68 69 76 65 0a 0a 0a 41 6c 6c |en archive...All| 00001510 20 63 6f 6d 6d 65 6e 74 73 20 61 6e 64 20 73 75 | comments and su| 00001520 67 67 65 73 74 69 6f 6e 73 20 66 6f 72 20 66 75 |ggestions for fu| 00001530 74 75 72 65 20 69 6d 70 72 6f 76 65 6d 65 6e 74 |ture improvement| 00001540 20 61 72 65 20 77 65 6c 63 6f 6d 65 20 62 75 74 | are welcome but| 00001550 20 70 6c 65 61 73 65 0a 6e 6f 74 65 20 74 68 61 | please.note tha| 00001560 74 20 49 20 63 61 6e 6e 6f 74 20 72 65 70 6c 79 |t I cannot reply| 00001570 20 74 6f 20 6c 65 74 74 65 72 73 20 77 69 74 68 | to letters with| 00001580 6f 75 74 20 72 65 74 75 72 6e 20 70 6f 73 74 61 |out return posta| 00001590 67 65 20 61 6e 64 20 61 6e 20 61 64 64 72 65 73 |ge and an addres| 000015a0 73 65 64 0a 65 6e 76 65 6c 6f 70 65 2e 0a 0a 54 |sed.envelope...T| 000015b0 68 65 20 61 64 64 72 65 73 73 20 69 73 3a 0a 0a |he address is:..| 000015c0 20 20 20 20 4d 72 2e 20 4d 2e 20 53 6d 69 74 68 | Mr. M. Smith| 000015d0 0a 20 20 20 20 50 65 6e 2d 79 2d 64 72 65 2c 0a |. Pen-y-dre,.| 000015e0 20 20 20 20 52 69 76 65 72 73 69 64 65 20 41 76 | Riverside Av| 000015f0 65 2e 2c 0a 20 20 20 20 42 72 6f 78 62 6f 75 72 |e.,. Broxbour| 00001600 6e 65 2c 0a 20 20 20 20 48 65 72 74 73 2e 2c 0a |ne,. Herts.,.| 00001610 20 20 20 20 45 4e 31 30 20 36 52 44 2e 0a 0a 49 | EN10 6RD...I| 00001620 20 77 6f 75 6c 64 20 61 6c 73 6f 2c 20 6f 66 20 | would also, of | 00001630 63 6f 75 72 73 65 2c 20 77 65 6c 63 6f 6d 65 20 |course, welcome | 00001640 64 65 74 61 69 6c 73 20 6f 66 20 61 6e 79 20 62 |details of any b| 00001650 75 67 73 20 64 69 73 63 6f 76 65 72 65 64 20 73 |ugs discovered s| 00001660 6f 20 74 68 61 74 20 49 0a 63 61 6e 20 63 6f 72 |o that I.can cor| 00001670 72 65 63 74 20 74 68 65 6d 2e 0a 0a 56 65 72 73 |rect them...Vers| 00001680 69 6f 6e 20 49 6d 70 72 6f 76 65 6d 65 6e 74 73 |ion Improvements| 00001690 0a 0a 76 30 2e 32 30 20 46 69 72 73 74 20 52 65 |..v0.20 First Re| 000016a0 6c 65 61 73 65 20 76 65 72 73 69 6f 6e 0a 76 30 |lease version.v0| 000016b0 2e 32 31 20 4d 61 78 20 6e 75 6d 62 65 72 20 6f |.21 Max number o| 000016c0 66 20 64 69 72 65 63 74 6f 72 79 20 6c 65 76 65 |f directory leve| 000016d0 6c 73 20 69 6e 63 72 65 61 73 65 64 20 66 72 6f |ls increased fro| 000016e0 6d 20 31 36 20 74 6f 20 36 34 2c 20 73 6f 6d 65 |m 16 to 64, some| 000016f0 20 74 69 64 79 69 6e 67 | tidying| 000016f8