mirror of
https://github.com/JetSetIlly/Gopher2600.git
synced 2025-04-02 11:02:17 -04:00
095efecd32
- moved cartridge code into new package
- moved bus definitions into new package
o recorder
- changed file-format
43 lines
1.7 KiB
Go
43 lines
1.7 KiB
Go
// Package debugger implements a reaonably comprehensive debugging tool.
|
|
// Features include:
|
|
//
|
|
// - cartridge disassembly
|
|
// - memory peek and poke
|
|
// - cpu and video cycle stepping
|
|
// - basic scripting
|
|
// - breakpoints
|
|
// - traps
|
|
// - watches
|
|
//
|
|
// Some of these features come courtesy of other packages, described elsewhere,
|
|
// and some are inherent in the gopher2600's emulation strategy, but all are
|
|
// nicely exposed via the debugger package.
|
|
//
|
|
// Initialisation of the debugger is done with the NewDebugger() function
|
|
//
|
|
// dbg, _ := debugger.NewDebugger(television, gui, term)
|
|
//
|
|
// The tv, gui and term arguments must be instances of types that satisfy the
|
|
// repsective interfaces. This gives the debugger great flexibility and should
|
|
// allow easy porting to new platforms
|
|
//
|
|
// Interaction with the debugger is primarily through a terminal. The Terminal
|
|
// interface is defined in the terminal package. The colorterm and plainterm
|
|
// sub-packages provide good reference implementations.
|
|
//
|
|
// The GUI helps visualise the television and coordinates events (keyboard,
|
|
// mouse) which the debugger can then poll. A good reference implementation of
|
|
// a debugging GUI can be in found the gui.sdldebug package.
|
|
//
|
|
// The television argument should be an instance of TV. For all practical
|
|
// purposes this will be instance createed with television.NewTelevision(), but
|
|
// other implementations are possible if not yet available.
|
|
//
|
|
// Once initialised, the debugger can be started with the Start() function.
|
|
//
|
|
// dbg.Start(initScript, cartloader)
|
|
//
|
|
// The initscript is a script previously created either by the script.Scribe
|
|
// package or by hand. The cartloader argument must be an instance of
|
|
// cartloader.
|
|
package debugger
|