prodos-drivers/util/README.md

# Utilities

* [DATE](date.s)
  * Prints the current ProDOS date/time, to verify the time is set and updating. Run from the BASIC prompt: `-DATE`
* [QUIT.SYSTEM](quit.system.s)
  * This invokes the ProDOS quit handler immediately. It can be used as the last in a chain of "driver" installers to invoke the program selector, e.g. if you want to also keep `BASIC.SYSTEM` in your root directory but not launch it.
* [PAUSE.SYSTEM](pause.system.s)
  * Waits for a fraction of a second before invoking the next driver file. Useful in case the log messages from the driver installers go by too quickly!
* [ME.FIRST.SYSTEM](me.first.system.s)
  * Moves the current volume to the end of DEVLST. Niche, but useful in some circumstances.
Add ROMX RTC driver, c/o Jeff Mazur. This is a modified version of the ROMX Real-Time Clock driver. The changes include: * Converting the source to ca65. * Integrating with the driver installer framework. * Adapting the driver to not modify page 2 beyond $220. The ROMX RTC firmware writes bytes to $2B0, and the the original driver placed temp code at $250. This can conflict with ProDOS applications that use page 2, so the driver was reworked to save/restore anything at at $2B0. Other changes: * Add a util/ source dir, and cricket/date, quit.system and pause.system there. * Pull the "print current date" logic out of clock drivers into driver preamble. 2021-10-06 02:58:31 +00:00			`# Utilities`

			`* [DATE](date.s)`
			* Prints the current ProDOS date/time, to verify the time is set and updating. Run from the BASIC prompt: `-DATE`
			`* [QUIT.SYSTEM](quit.system.s)`
			* This invokes the ProDOS quit handler immediately. It can be used as the last in a chain of "driver" installers to invoke the program selector, e.g. if you want to also keep `BASIC.SYSTEM` in your root directory but not launch it.
			`* [PAUSE.SYSTEM](pause.system.s)`
			`* Waits for a fraction of a second before invoking the next driver file. Useful in case the log messages from the driver installers go by too quickly!`
Add ME.FIRST.SYSTEM 2022-02-04 04:14:10 +00:00			`* [ME.FIRST.SYSTEM](me.first.system.s)`
			`* Moves the current volume to the end of DEVLST. Niche, but useful in some circumstances.`