diff options
Diffstat (limited to 'src/emu/debug/debughlp.cpp')
-rw-r--r-- | src/emu/debug/debughlp.cpp | 203 |
1 files changed, 115 insertions, 88 deletions
diff --git a/src/emu/debug/debughlp.cpp b/src/emu/debug/debughlp.cpp index c62b7299ea7..87bf8f0f18f 100644 --- a/src/emu/debug/debughlp.cpp +++ b/src/emu/debug/debughlp.cpp @@ -246,8 +246,8 @@ const help_item f_static_help_list[] = "Cheat Commands\n" "Type help <command> for further details on each command\n" "\n" - " cheatinit [<sign><width>[<swap>],[<address>,<length>[,<CPU>]]] -- initialize the cheat search to the selected memory area\n" - " cheatrange <address>,<length> -- add to the cheat search the selected memory area\n" + " cheatinit [[<sign>[<width>[<swap>]]],[<address>,<length>[,<space>]]] -- initialize the cheat search to the selected memory area\n" + " cheatrange <address>,<length> -- add selected memory area to the cheat search\n" " cheatnext <condition>[,<comparisonvalue>] -- continue cheat search comparing with the previous value\n" " cheatnextf <condition>[,<comparisonvalue>] -- continue cheat search comparing with the first value\n" " cheatlist [<filename>] -- show the list of cheat search matches or save them to <filename>\n" @@ -1611,157 +1611,184 @@ const help_item f_static_help_list[] = { "cheatinit", "\n" - " cheatinit [<sign><width>[<swap>],[<address>,<length>[,<CPU>]]]\n" + " cheatinit [[<sign>[<width>[<swap>]]],[<address>,<length>[,<space>]]]\n" "\n" - "The cheatinit command initializes the cheat search to the selected memory area.\n" - "If no parameter is specified the cheat search is initialized to all changeable memory of the main CPU.\n" - "<sign> can be s(signed) or u(unsigned)\n" - "<width> can be b(8 bit), w(16 bit), d(32 bit) or q(64 bit)\n" - "<swap> append s for swapped search\n" + "The cheatinit command initializes the cheat search to writable RAM areas in the specified " + "address space. The device may be specified as a tag or a debugger CPU number; if no " + "device is specified, the CPU currently visible in the debugger is assumed. If an address " + "space is not specified, the first address space exposed by the device is used.\n" + "\n" + "The first argument specifies the data format to search for:\n" + " <sign>: 's' (signed), 'u' (unsigned)\n" + " <width>: 'b' (8-bit), 'w' (16-bit), 'd' (32-bit), 'q' (64-bit)\n" + " <swap>: 's' (reverse byte order)\n" + "If the first argument is omitted or empty, the format from the previous cheat search is " + "used, or unsigned 8-bit for the first cheat search.\n" + "\n" + "The <address> specifies the address to start searching from, and the <length> specifies " + "how much memory to search. If specified, writable RAM in the range <address> through " + "<address>+<length>-1, inclusive, will be searched; otherwise, all writable RAM in the " + "address space will be searched.\n" "\n" "Examples:\n" "\n" "cheatinit ub,0x1000,0x10\n" - " Initialize the cheat search from 0x1000 to 0x1010 of the first CPU.\n" + " Initialize the cheat search for unsigned 8-bit values in addresses 0x1000-0x100f in the " + "program space of the visible CPU.\n" "\n" "cheatinit sw,0x2000,0x1000,1\n" - " Initialize the cheat search with width of 2 byte in signed mode from 0x2000 to 0x3000 of the second CPU.\n" + " Initialize the cheat search for signed 16-bit values in addresses 0x2000-0x3000 in the " + "program space of CPU #1.\n" "\n" "cheatinit uds,0x0000,0x1000\n" - " Initialize the cheat search with width of 4 byte swapped from 0x0000 to 0x1000.\n" + " Initialize the cheat search for unsigned 32-bit values with reverse byte order in " + "addresses 0x0000-0x0fff of the program space of the visible CPU.\n" }, { "cheatrange", "\n" " cheatrange <address>,<length>\n" "\n" - "The cheatrange command adds the selected memory area to the cheat search.\n" - "Before using cheatrange it is necessary to initialize the cheat search with cheatinit.\n" + "The cheatrange command adds writable RAM areas in the range <address> through " + "through <address>+<length>-1, inclusive, to the cheat search. Before using cheatrange, " + "the cheatinit command must be used to initialize the cheat search.\n" "\n" "Examples:\n" "\n" "cheatrange 0x1000,0x10\n" - " Add the bytes from 0x1000 to 0x1010 to the cheat search.\n" + " Add addresses 0x1000-0x100f to the cheat search.\n" }, { "cheatnext", "\n" " cheatnext <condition>[,<comparisonvalue>]\n" "\n" - "The cheatnext command will make comparisons with the previous search matches.\n" + "The cheatnext command makes comparisons with the previous search matches.\n" "Possible <condition>:\n" " all\n" - " no <comparisonvalue> needed.\n" - " use to update the previous value without changing the current matches.\n" - " equal [eq]\n" - " without <comparisonvalue> search for all bytes that are equal to the previous search.\n" - " with <comparisonvalue> search for all bytes that are equal to the <comparisonvalue>.\n" - " notequal [ne]\n" - " without <comparisonvalue> search for all bytes that are not equal to the previous search.\n" - " with <comparisonvalue> search for all bytes that are not equal to the <comparisonvalue>.\n" - " decrease [de, +]\n" - " without <comparisonvalue> search for all bytes that have decreased since the previous search.\n" - " with <comparisonvalue> search for all bytes that have decreased by the <comparisonvalue> since the previous search.\n" - " increase [in, -]\n" - " without <comparisonvalue> search for all bytes that have increased since the previous search.\n" - " with <comparisonvalue> search for all bytes that have increased by the <comparisonvalue> since the previous search.\n" - " decreaseorequal [deeq]\n" - " no <comparisonvalue> needed.\n" - " search for all bytes that have decreased or have same value since the previous search.\n" - " increaseorequal [ineq]\n" - " no <comparisonvalue> needed.\n" - " search for all bytes that have decreased or have same value since the previous search.\n" - " smallerof [lt]\n" - " without <comparisonvalue> this condition is invalid\n" - " with <comparisonvalue> search for all bytes that are smaller than the <comparisonvalue>.\n" - " greaterof [gt]\n" - " without <comparisonvalue> this condition is invalid\n" - " with <comparisonvalue> search for all bytes that are larger than the <comparisonvalue>.\n" - " changedby [ch, ~]\n" - " without <comparisonvalue> this condition is invalid\n" - " with <comparisonvalue> search for all bytes that have changed by the <comparisonvalue> since the previous search.\n" + " Use to update the last value without changing the current matches.\n" + " The <comparisonvalue> is not used.\n" + " equal (eq)\n" + " Without <comparisonvalue>**, search for values that are equal to the previous " + "search.\n" + " With <comparisonvalue>, search for values that are equal to the <comparisonvalue>.\n" + " notequal (ne)\n" + " Without <comparisonvalue>, search for values that are not equal to the previous " + "search.\n" + " With <comparisonvalue>, search for values that are not equal to the <comparisonvalue>.\n" + " decrease (de, -)\n" + " Without <comparisonvalue>, search for values that have decreased since the previous " + "search.\n" + " With <comparisonvalue>, search for values that have decreased by the <comparisonvalue> " + "since the previous search.\n" + " increase (in, +)\n" + " Without <comparisonvalue>, search for values that have increased since the previous " + "search.\n" + " With <comparisonvalue>, search for values that have increased by the <comparisonvalue> " + "since the previous search.\n" + " decreaseorequal (deeq)\n" + " Search for values that have decreased or are unchanged since the previous search.\n" + " The <comparisonvalue> is not used.\n" + " increaseorequal (ineq)\n" + " Search for values that have increased or are unchanged since the previous search.\n" + " The <comparisonvalue> is not used.\n" + " smallerof (lt, <)\n" + " Search for values that are less than the <comparisonvalue>.\n" + " The <comparisonvalue> is required.\n" + " greaterof (gt, >)\n" + " Search for values that are greater than the <comparisonvalue>.\n" + " The <comparisonvalue> is required.\n" + " changedby (ch, ~)\n" + " Search for values that have changed by the <comparisonvalue> since the previous " + "search.\n" + " The <comparisonvalue> is required.\n" "\n" "Examples:\n" "\n" "cheatnext increase\n" - " search for all bytes that have increased since the previous search.\n" + " Search for all values that have increased since the previous search.\n" "\n" - "cheatnext decrease, 1\n" - " search for all bytes that have decreased by 1 since the previous search.\n" + "cheatnext decrease,1\n" + " Search for all values that have decreased by 1 since the previous search.\n" }, { "cheatnextf", "\n" " cheatnextf <condition>[,<comparisonvalue>]\n" "\n" - "The cheatnextf command will make comparisons with the initial search.\n" + "The cheatnextf command makes comparisons with the initial search matches.\n" "Possible <condition>:\n" " all\n" - " no <comparisonvalue> needed.\n" - " use to update the previous value without changing the current matches.\n" - " equal [eq]\n" - " without <comparisonvalue> search for all bytes that are equal to the initial search.\n" - " with <comparisonvalue> search for all bytes that are equal to the <comparisonvalue>.\n" - " notequal [ne]\n" - " without <comparisonvalue> search for all bytes that are not equal to the initial search.\n" - " with <comparisonvalue> search for all bytes that are not equal to the <comparisonvalue>.\n" - " decrease [de, +]\n" - " without <comparisonvalue> search for all bytes that have decreased since the initial search.\n" - " with <comparisonvalue> search for all bytes that have decreased by the <comparisonvalue> since the initial search.\n" - " increase [in, -]\n" - " without <comparisonvalue> search for all bytes that have increased since the initial search.\n" - " with <comparisonvalue> search for all bytes that have increased by the <comparisonvalue> since the initial search.\n" - " decreaseorequal [deeq]\n" - " no <comparisonvalue> needed.\n" - " search for all bytes that have decreased or have same value since the initial search.\n" - " increaseorequal [ineq]\n" - " no <comparisonvalue> needed.\n" - " search for all bytes that have decreased or have same value since the initial search.\n" - " smallerof [lt]\n" - " without <comparisonvalue> this condition is invalid.\n" - " with <comparisonvalue> search for all bytes that are smaller than the <comparisonvalue>.\n" - " greaterof [gt]\n" - " without <comparisonvalue> this condition is invalid.\n" - " with <comparisonvalue> search for all bytes that are larger than the <comparisonvalue>.\n" - " changedby [ch, ~]\n" - " without <comparisonvalue> this condition is invalid\n" - " with <comparisonvalue> search for all bytes that have changed by the <comparisonvalue> since the initial search.\n" + " Use to update the last value without changing the current matches.\n" + " The <comparisonvalue> is not used.\n" + " equal (eq)\n" + " Without <comparisonvalue>**, search for values that are equal to the initial search.\n" + " With <comparisonvalue>, search for values that are equal to the <comparisonvalue>.\n" + " notequal (ne)\n" + " Without <comparisonvalue>, search for values that are not equal to the initial search.\n" + " With <comparisonvalue>, search for values that are not equal to the <comparisonvalue>.\n" + " decrease (de, -)\n" + " Without <comparisonvalue>, search for values that have decreased since the initial " + "search.\n" + " With <comparisonvalue>, search for values that have decreased by the <comparisonvalue> " + "since the initial search.\n" + " increase (in, +)\n" + " Without <comparisonvalue>, search for values that have increased since the initial " + "search.\n" + " With <comparisonvalue>, search for values that have increased by the <comparisonvalue> " + "since the initial search.\n" + " decreaseorequal (deeq)\n" + " Search for values that have decreased or are unchanged since the initial search.\n" + " The <comparisonvalue> is not used.\n" + " increaseorequal (ineq)\n" + " Search for values that have increased or are unchanged since the initial search.\n" + " The <comparisonvalue> is not used.\n" + " smallerof (lt, <)\n" + " Search for values that are less than the <comparisonvalue>.\n" + " The <comparisonvalue> is required.\n" + " greaterof (gt, >)\n" + " Search for values that are greater than the <comparisonvalue>.\n" + " The <comparisonvalue> is required.\n" + " changedby (ch, ~)\n" + " Search for values that have changed by the <comparisonvalue> since the initial search.\n" + " The <comparisonvalue> is required.\n" "\n" "Examples:\n" "\n" "cheatnextf increase\n" - " search for all bytes that have increased since the initial search.\n" + " Search for all values that have increased since the initial search.\n" "\n" - "cheatnextf decrease, 1\n" - " search for all bytes that have decreased by 1 since the initial search.\n" + "cheatnextf decrease,1\n" + " Search for all values that have decreased by 1 since the initial search.\n" }, { "cheatlist", "\n" " cheatlist [<filename>]\n" "\n" - "Without <filename> show the list of matches in the debug console.\n" - "With <filename> save the list of matches in basic xml format to <filename>.\n" + "Without <filename>, show the current cheat matches in the debugger console; with " + "<filename>, save the current cheat matches in basic XML format to the specified file.\n" "\n" "Examples:\n" "\n" "cheatlist\n" - " Show the current matches in the debug console.\n" - "cheatlist cheat.txt\n" - " Save the current matches to cheat.txt.\n" + " Show the current matches in the console.\n" + "cheatlist cheat.xml\n" + " Save the current matches to cheat.xml in XML format.\n" }, { "cheatundo", "\n" " cheatundo\n" "\n" - "Undo the results of the last search.\n" - "The undo command has no effect on the last value.\n" + "Undo filtering of cheat candidates by the most recent cheatnext or cheatnextf command.\n" + "Note that the previous values ARE NOT rolled back.\n" "\n" "Examples:\n" "\n" "cheatundo\n" - " Undo the last search (state only).\n" + " Restore cheat candidates filtered out by the most recent cheatnext or cheatnextf " + "command.\n" }, { "images", |