blob: 9d897d140c9c6c62179345c859058f8a62a451b1 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
|
.. _debugger-annotation-list:
Code Annotation Debugger Commands
=================================
You can also type **help <command>** for further details on each command in the MAME Debugger interface.
| :ref:`debugger-command-comadd` -- adds a comment to the disassembled code at given address
| :ref:`debugger-command-comdelete` -- removes a comment from the given address
| :ref:`debugger-command-comsave` -- save the current comments to a file
| :ref:`debugger-command-comlist` -- print currently available comments from file
| :ref:`debugger-command-commit` -- gives a bulk comadd then comsave command
.. _debugger-command-comadd:
comadd
------
| **comadd[//] <address>,<comment>**
|
| Adds a string <comment> to the disassembled code at <address>. The shortcut for this command is simply '//'
|
| Examples:
|
| comadd 0, hello world.
|
| Adds the comment 'hello world.' to the code at address 0x0
|
| // 10, undocumented opcode!
|
| Adds the comment 'undocumented opcode!' to the code at address 0x10
.. _debugger-command-comdelete:
comdelete
---------
| **comdelete**
|
| Deletes the comment at the specified memory offset. The comment which is deleted is in the currently active memory bank.
|
| Examples:
|
| comdelete 10
|
| Deletes the comment at code address 0x10 (using the current memory bank settings)
.. _debugger-command-comsave:
comsave
-------
| **comsave**
|
| Saves the working comments to the driver's XML comment file.
|
| Examples:
|
| comsave
|
| Saves the comments to the driver's comment file
.. _debugger-command-comlist:
comlist
-------
| **comlist**
|
| Prints the currently available comment file in human readable form in debugger output window.
|
| Examples:
|
| comlist
|
| Shows currently available comments.
.. _debugger-command-commit:
commit
------
| **commit[/*] <address>,<comment>**
|
| Adds a string <comment> to the disassembled code at <address> then saves to file. Basically same as comadd + comsave via a single line.
| The shortcut for this command is simply \'\/\*\'
|
| Examples:
|
| commit 0, hello world.
|
| Adds the comment 'hello world.' to the code at address 0x0
|
| /* 10, undocumented opcode!
|
| Adds the comment 'undocumented opcode!' to the code at address 0x10
|