Debug facilities in Emulator guide

The emulator is designed to be the primary development and debugging tool for Symbian OS, alongside any language specific tools provided by development environments.

In debug builds, the GUI provides special key combinations for:

resource checking, to trap memory leaks early in the development cycle.
redraw testing, to check drawing code functions correctly.

There are also some special key combinations for logging window server events and actions, and few other miscellaneous keys.

All debug keys are accessed using a ctrl+alt+shift prefix.

Resource allocation keys

`A`	show number of heap cells allocated on user heap by the current program
`B`	show number of file server resources in use by the current program
`C`	show number of window server resources in use by the current program
`P`	show dialog for the heap failure tool: see below for details
`Q`	turn off heap failure mode

The heap failure tool artificially generates resource allocation failures. It is used by developers to test the efficiency of the application during such failures. The dialog options are as follows:

App heap failure Type: This generates failures for resource allocation requests from applications. Random means that requests fail at a random rate. Deterministic means that requests fail at the rate specified in the Rate box.
Wserv heap failure Type: This generates failures for resource allocation requests from the Symbian OS window server. The options are similar to App heap failure.
File failure tool: Selecting this option generates failures for file access attempts.

Drawing keys

`R`	redraw whole screen, to test whether applications handle complete redraw properly
`F`	enable window server auto-flush for all programs using the current control environment
`G`	disable window server auto-flush for all programs using the current control environment

Window server logging keys

`E`	start (Enable) window server logging.
`D`	stop (Disable) window server logging.
`W`	dump the full window tree.
`H`	dump the contents of the window server's heap.

Miscellaneous keys

`K`	kill the application with current keyboard focus.
`T`	brings up a task list by which running applications can be switched to or closed down. Note that this is a debugging aid only.
`V`	turn on or off verbose information messages.
`Z`	send keys A through J in fast sequence to the application, to test its ability to handle fast repeated keys.