improve readme

This commit is contained in:
Joshua Bell 2019-01-09 23:54:22 -08:00
parent 19bf11b42a
commit a814151c88
1 changed files with 8 additions and 3 deletions

View File

@ -1,4 +1,4 @@
# path - CMD executable path command for ProDOS's BASIC.SYSTEM
# CMD executable PATH for ProDOS's BASIC.SYSTEM
Build with [ca65](https://cc65.github.io/doc/ca65.html)
@ -8,14 +8,15 @@ Installation:
Usage:
```
PATH - view current search path(s)
PATH prefix - set search path(s) - colon delimited
PATH - view current search path(s)
cmdname - load and execute named CMD, if in PATH
```
Once set, binary files of type `CMD` in the specified directories can be invoked by name.
* CMD file is loaded at $4000 and invoked; should return (`rts`) on completion.
* The command line will be present at $200 (`GETLN` input buffer).
* Supports multi-segment paths (e.g. `/hd/cmds:/hd2/more.cmds`)
* Supports multi-segment, colon-separated paths, e.g. `/hd/cmds:/hd2/more.cmds`
Example:
```
@ -31,3 +32,7 @@ Notes:
* Allocates a permanent buffer to store the code and path (2 pages)
* Can be invoked as lower case (e.g. `path ...`)
* Applesoft BASIC commands are unaffected (but can't be CMD names)
* Search order when a command is typed:
* ProDOS BASIC.SYSTEM intrinsics (`CAT`, `PREFIX`, etc)
* AppleSoft keywords (`LIST`, `PRINT`, etc)
* CMD files in paths, in listed