From a814151c88c1dfe487741f11b96b17e168ebe5b8 Mon Sep 17 00:00:00 2001 From: Joshua Bell Date: Wed, 9 Jan 2019 23:54:22 -0800 Subject: [PATCH] improve readme --- README.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 127c598..07560ab 100644 --- a/README.md +++ b/README.md @@ -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