diff options
Diffstat (limited to 'src/emu/debug/debughlp.cpp')
-rw-r--r-- | src/emu/debug/debughlp.cpp | 36 |
1 files changed, 30 insertions, 6 deletions
diff --git a/src/emu/debug/debughlp.cpp b/src/emu/debug/debughlp.cpp index ded8cafb993..dd46472abb2 100644 --- a/src/emu/debug/debughlp.cpp +++ b/src/emu/debug/debughlp.cpp @@ -86,6 +86,7 @@ static const help_item static_help_list[] = " printf <format>[,<item>[,...]] -- prints one or more <item>s to the console using <format>\n" " logerror <format>[,<item>[,...]] -- outputs one or more <item>s to the error.log\n" " tracelog <format>[,<item>[,...]] -- outputs one or more <item>s to the trace file using <format>\n" + " tracesym <item>[,...]] -- outputs one or more <item>s to the trace file\n" " history [<cpu>,<length>] -- outputs a brief history of visited opcodes\n" " trackpc [<bool>,<cpu>,<bool>] -- visually track visited opcodes [boolean to turn on and off, for the given cpu, clear]\n" " trackmem [<bool>,<bool>] -- record which PC writes to each memory address [boolean to turn on and off, clear]\n" @@ -385,6 +386,22 @@ static const help_item static_help_list[] = " Outputs A=<aval>, B=<bval> on one line, and C=<a+bval> on a second line.\n" }, { + "tracesym", + "\n" + " tracesym <item>[,...]\n" + "\n" + "The tracesym command prints the specified symbols and routes the output to the currently open trace " + "file (see the 'trace' command for details). If no file is currently open, tracesym does nothing. " + "\n" + "Examples:\n" + "\n" + "tracelog pc\n" + " Outputs PC=<pcval> where <pcval> is displayed in the default format.\n" + "\n" + "printf a,b\n" + " Outputs A=<aval>, B=<bval> on one line.\n" + }, + { "trackpc", "\n" " trackpc [<bool>,<cpu>,<bool>]\n" @@ -818,14 +835,15 @@ static const help_item static_help_list[] = { "trace", "\n" - " trace {<filename>|OFF}[,<cpu>[,<detectloops>[,<action>]]]\n" + " trace {<filename>|OFF}[,<cpu>[,[noloop|logerror][,<action>]]]\n" "\n" "Starts or stops tracing of the execution of the specified <cpu>. If <cpu> is omitted, " "the currently active CPU is specified. When enabling tracing, specify the filename in the " "<filename> parameter. To disable tracing, substitute the keyword 'off' for <filename>. " - "<detectloops> should be either true or false. If <detectloops> is true or omitted, the trace " - "will have loops detected and condensed to a single line. If it is false, the trace will contain " - "every opcode as it is executed. If you " + "<detectloops> should be either true or false. If 'noloop' is omitted, the trace " + "will have loops detected and condensed to a single line. If 'noloop' is specified, the trace " + "will contain every opcode as it is executed. If 'logerror' is specified, logerror output " + "will augment the trace. If you " "wish to log additional information on each trace, you can append an <action> parameter which " "is a command that is executed before each trace is logged. Generally, this is used to include " "a 'tracelog' command. Note that you may need to embed the action within braces { } in order " @@ -840,16 +858,22 @@ static const help_item static_help_list[] = "trace dribling.tr,0\n" " Begin tracing the execution of CPU #0, logging output to dribling.tr.\n" "\n" - "trace starswep.tr,0,false\n" + "trace starswep.tr,0,noloop\n" " Begin tracing the execution of CPU #0, logging output to starswep.tr, with loop detection disabled.\n" "\n" + "trace starswep.tr,0,logerror\n" + " Begin tracing the execution of CPU #0, logging output (along with logerror output) to starswep.tr.\n" + "\n" + "trace starswep.tr,0,logerror|noloop\n" + " Begin tracing the execution of CPU #0, logging output (along with logerror output) to starswep.tr, with loop detection disabled.\n" + "\n" "trace >>pigskin.tr\n" " Begin tracing the currently active CPU, appending log output to pigskin.tr.\n" "\n" "trace off,0\n" " Turn off tracing on CPU #0.\n" "\n" - "trace asteroid.tr,0,true,{tracelog \"A=%02X \",a}\n" + "trace asteroid.tr,0,,{tracelog \"A=%02X \",a}\n" " Begin tracing the execution of CPU #0, logging output to asteroid.tr. Before each line, " "output A=<aval> to the tracelog.\n" }, |