prodos-path/README.md
2019-01-09 09:18:40 -08:00

36 lines
1.1 KiB
Markdown

# path - CMD executable path command for ProDOS's BASIC.SYSTEM
Build with [ca65](https://cc65.github.io/doc/ca65.html)
Installation:
* Copy target to ProDOS disk
* From BASIC.SYSTEM prompt, run: `-PATH` from STARTUP (or by hand)
Usage:
```
PATH - view current search path
PATH prefix - set search path
```
Once set, binary files of type `CMD` in the specified directory can be invoked by name.
* CMD file is loaded at $4000 and invoked; should return (`rts`) on with carry clear completion
* The command line will be present at $200 (`GETLN` input buffer).
Example:
```
] -/hd/path - install it
] PATH /hd/cmds - set PATH
] PATH - verify path
/hd/cmds
] BELL - will invoke /hd/cmds/BELL if present
] HELLO - will invoke /hd/cmds/HELLO if present
```
Notes:
* Allocates a buffer to store the code and path
* Can be invoked as lower case (e.g. `path ...`)
* Applesoft BASIC commands are unaffected (but can't be CMD names)
Future:
* Support multi-segment paths (e.g. `/hd/cmds:/hd2/more.cmds`)