History

Scott Duensing b638ca9b9a Fixes.		2026-08-25 16:42:49 -05:00
..
dvxshell.dep	Major project layout change. Source locations now more match where binaries end up.	2026-04-16 19:33:17 -05:00
dvxshell.dhs	Another deep dive on the code. Needs serious testing.	2026-06-24 20:21:45 -05:00
Makefile	License added to source files.	2026-04-17 23:23:44 -05:00
README.md	More cleanup. Major docs update.	2026-04-18 17:00:18 -05:00
shellApp.c	Fixes.	2026-08-25 16:42:49 -05:00
shellApp.h	Fixes.	2026-08-25 16:42:49 -05:00
shellInf.h	License added to source files.	2026-04-17 23:23:44 -05:00
shellInfo.c	License added to source files.	2026-04-17 23:23:44 -05:00
shellMain.c	Fixes.	2026-08-25 16:42:49 -05:00

README.md

dvxshell -- DVX Shell Library

The DVX shell drives the GUI after the loader hands off. It initializes the GUI subsystem, loads application modules on demand, runs the cooperative main loop, and provides crash recovery so one app's fault does not bring down the whole system.

Documentation

Full reference is in dvxshell.dhs (this directory), compiled into the DVX System Reference. Open via the Help Viewer app, or read docs/dvx_system_reference.html after make.

Topics covered: AppDescriptorT / DxeAppContextT contracts, how apps register (appMain, appDescriptor, appShutdown), callback-only vs main-loop apps, shell event callbacks, and force-kill behavior.

Source Files

shellApp.h -- application contract (AppDescriptorT, DxeAppContextT)
shellInf.h -- shell-internal interfaces exposed to apps
shellApp.c -- app registry, load, unload, lifecycle
shellInfo.c -- system info service
shellMain.c -- shell entry point, main loop, crash handler

Build

make -C src/libs/kpunch/dvxshell (invoked by the top-level make).