Augmenting help file

This commit is contained in:
Nathan Woods 2017-01-16 20:24:27 -05:00
parent b8453021df
commit e5d662adf7

View File

@ -818,14 +818,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 +841,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"
},