MANUAL FOR LONGFS (6502 ROM image) This file describes the ROM image LONGFS which adds support for full 10 letter filenames with just an ordinary 7 letter limited DFS. The image requires at least one 4k bank of sideways RAM or to be put onto a ROM to work. The manual and software are (C)1998 SPROW INSTRUCTIONS- At any command line prompt, eg. the BASIC command prompt '>' type ON A MASTER: *SRLOAD LONGFS 8000 *INSERT where may be 7, 6, 5, 4 ON A MACHINE WITH SWRAM: *LOAD LONGFS 8000 and press CTRL-BREAK to initialise. The image will then be installed into the chosen socket where it will watch for filing system calls with names longer than 7 letters. Before using a disc with LongFS it must first be prepared for use. This 'formatting' process infact just adds a second catalogue to the disc, so make sure the disc has already been formatted with your favourite DFS formatter. Syntax: *FORM 10 One page (256 bytes) of memory is claimed as private workspace above OSHWM when the computer is turned on. This contains pointers etc... that LongFS uses, and must not be tampered with. For technical reasons the 'hidden' workspace which is available on a Master series could not be used. Please note that LongFS is in addition to the normal DFS. It is not a 'filing system' on its own, ie. you can't select it with *LONGFS or similar command. So typing in BASIC SAVE":0.$.File" will save to the DFS (eg. Acorn DFS) SAVE":0.$.LongerName" will save via LongFS but leave DFS selected throughout SUPPORTED OS CALLS- The following calls all require a filenames (or pointer to filename) as one of their arguments and are fully supported. Filenames may be prefixed by drive and/or directory specifers (eg. ":0.R.") and are terminated by any control character, such as a carriage return or a space. OSFile OSGBPB OSFind OSFSCV Most DFS's also support the following 'star' commands, which are handled differently to the above. *WIPE does not understand long filenames *DESTROY does not understand long filenames *COMPACT works as before, but will not list long filenames *ACCESS does not understand long filenames *COPY does not understand long filenames *RENAME does not understand long filenames *CAT/*INFO works as before, but will not list long filenames *DELETE only understands long filenames on the Master series EXIT MESSAGES- "Out of range" - the entered number was outside the range expected "Bad drive" - only drives 0-3 can be formatted for use with LongFS "Cannot format disc" - the mapping file could not be created on this disc "Bad FS map" - the filename mappings have become inconsitent with the files actually on the disc. This means you'll probably have to wipe the disc "Not found" - the filename given could not be found "Bad name" - the name given contained invalid filing system characters "Bad filing system name" - the LongFS ROM only works with DFS selected KNOWN PROBLEMS/FUTURE ENHANCEMENTS- No known problems HISTORY- V0.32 Initial version, missing most of the *command substitution V0.42 Adds support for one letter directories V0.47 Reformatting a disc that has already been 'formatted' with LongFS now also removes all the files that had long file names. V0.48 Removed a debug section which resulted in the default drive always being assumed to be zero, rather than reading the default. Corrected spelling, removed unused value from service call table. V0.50 Spelling correction. Changed command matcher to allow command abbreviations for CLOSE and FORM. Changed OSGBPB interface to be Tube compatible. Trimmed out unused ROM library functions. V0.51 Sync star command matcher with other ROMs.