prodos-drivers/selectors
Joshua Bell 7bbc96924b Add SETUP.SYSTEM and build .SETUP files
This is an alternate approach proposed by Sean Nolan in 1987 which
allows placing the driver files in a subdirectory of the root volume
to avoid clutter and file ordering issues. Only a SETUP.SYSTEM file is
needed at the top level, and the drivers go into a SETUPS/ directory.

All drivers here (except QUIT.SYSTEM and SETUP.SYSTEM itself) have
alternate forms built into the /DRIVERS/SETUPS/ directory as XYZ.SETUP
instead of XYZ.SYSTEM. If you choose to use SETUP.SYSTEM, place these
.SETUP files in your SETUPS/ directory. The naming doesn't matter -
any SYS or BIN file can be used - but this convention makes
distribution easier. These .SETUP files do **NOT** chain to the next
file - that's handled by SETUP.SYSTEM itself.

Resolves #16
2024-01-30 21:16:32 -08:00
..
Makefile Add SETUP.SYSTEM and build .SETUP files 2024-01-30 21:16:32 -08:00
README.md Rejiggered the selectors, added actual 40-column Bird's Better Bye. 2020-12-23 19:23:23 -08:00
bbb.system.s Rejiggered the selectors, added actual 40-column Bird's Better Bye. 2020-12-23 19:23:23 -08:00
buhbye.system.s BuhBye: Cycle through volumes after the boot volume more intuitively 2022-09-01 20:38:07 -07:00
bye.system.s Rejiggered the selectors, added actual 40-column Bird's Better Bye. 2020-12-23 19:23:23 -08:00
selector.system.s Rejiggered the selectors, added actual 40-column Bird's Better Bye. 2020-12-23 19:23:23 -08:00

README.md

ProDOS Program Selectors ("BYE" commands)

The ProDOS operating system for the Apple II personal computer line supported a quit routine (invoked from BASIC with the BYE command) allowing the user to launch a new system file once previous system file had exited.

This selector code evolved over time, and the memory location that the routine was stored at was documented, allowing users to install customized versions coded to fit within a mere 768 bytes.

ProDOS 1.0 through 1.8 - Selector

The earliest versions of ProDOS supported a simple 40-column-friendly selector prompting:

  • ENTER PREFIX (PRESS "RETURN" TO ACCEPT)"
  • ENTER PATHNAME OF NEXT APPLICATION

This was not particularly user friendly.

If you want to use this selector with any version of ProDOS, add the SELECTOR.SYSTEM file to your boot sequence. You can follow it with QUIT.SYSTEM in your driver sequence to show the selector on startup.

Bird's Better Bye

Alan Bird wrote a replacement called Bird's Better Bye that would patch itself into ProDOS. Directories and system files could be selected with arrows keys and the Return key, Escape would back up a directory level, Tab would change drives. This also functioned in 40 column mode.

If you want to use this selector with any version of ProDOS, add the BBB.SYSTEM file to your boot sequence. You can follow it with QUIT.SYSTEM in your driver sequence to show the selector on startup.

ProDOS 1.9 and 2.0.x - 80-column Selector

ProDOS 1.9 introduced a much improved menu-driven selector showing a list of files and allowing navigation of the file system with the keyboard. Directories and system files could be selected with arrows keys and the Return key, Escape would back up a directory level, Tab would change drives. This required 80 columns and a 65C02 processor, and took advantage of the MouseText characters to show folder glyphs for directories.

If these versions of ProDOS were started on systems without 40 column support, the previous version of the selector would be loaded instead (both were present in the PRODOS system file.)

If you want to use this selector with any version of ProDOS, add the BYE.SYSTEM file to your boot sequence. You can follow it with QUIT.SYSTEM in your driver sequence to show the selector on startup.

This was inspired by the work of Dave Cotter who created a similarly named file to patch the selector back in. It can be found at: http://www.lazilong.com/apple_ii/bye.sys/bye.html

ProDOS 2.4 - Bitsy Bye

The new (unofficial) releases of ProDOS 2.4 by John Brooks include a replacement quit routine called Bitsy Bye, a collaboration with Peter Ferrie. This new quit routine is far more powerful, allowing access to BASIC and binary files (and more), drive selection, type-down, more entries, and so on. It uses only 40 columns, and does not require a 65C02 processor.

If you want to use this selector, use a version of ProDOS 2.4 from https://prodos8.com/

Buh-Bye - Enhanced 80-column selector

Since I prefered the look of the ProDOS 80-column selector to Bitsy Bye, but missed the type-down ability, I modified the 80-column selector to tighten up the code added seeking if an alphabetical key is typed. Hit 'C' and the list will scroll to the next file starting with 'C'.

I erroneously thought that the ProDOS 80-column selector was Bird's Better Bye and named this "Bell's Better Bird's Better Bye" or "Buh-Bye".

If you want to use this selector with any version of ProDOS, add the BUHBYE.SYSTEM file to your boot sequence. You can follow it with QUIT.SYSTEM in your driver sequence to show the selector on startup.