PATH command for Apple II ProDOS
Go to file
Joshua Bell c2a7fd24de
Add Travis build status indicator
2019-09-30 21:04:44 -07:00
.gitignore wip 2019-01-07 19:36:25 -08:00
.travis.yml Build: Use cc65's make avail 2019-09-22 21:34:34 -07:00
Makefile Build: Use cc65's make avail 2019-09-22 21:34:34 -07:00
README.md Add Travis build status indicator 2019-09-30 21:04:44 -07:00
bell.cmd.s Don't require CLC, fix BELL, handle spaces in ECHO 2019-01-09 16:09:58 -08:00
echo.cmd.s Don't require CLC, fix BELL, handle spaces in ECHO 2019-01-09 16:09:58 -08:00
hello.cmd.s Don't require CLC, fix BELL, handle spaces in ECHO 2019-01-09 16:09:58 -08:00
path.s Build: Use cc65's make avail 2019-09-22 21:34:34 -07:00
prodos.inc Use BI's buffers. Add ECHO, that shows INBUF problem 2019-01-08 18:36:52 -08:00

README.md

CMD executable PATH for ProDOS's BASIC.SYSTEM

Build Status

Build with ca65

Installation:

  • Copy target to ProDOS disk
  • From BASIC.SYSTEM prompt, run: -PATH from STARTUP (or by hand)

Usage:

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, colon-separated paths, e.g. /hd/cmds:/hd2/more.cmds

Example:

] -/hd/path              - install it
] PATH /hd/cmds:/h2/bin  - 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 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 order