Re: [RFA/RFC Prec] Add process record skip 6/6 (doc)

Hui Zhu
2009-08-23T03:33:55Z

On Thu, Aug 20, 2009 at 02:41, Eli Zaretskii<eliz@gnu.org> wrote:
>> From: Hui Zhu <teawater@gmail.com>
>> Date: Wed, 19 Aug 2009 16:12:13 +0800
>>
>> 2008-08-19  Hui Zhu  <teawater@gmail.com>
>>
>>       * gdb.texinfo (Process Record and Replay): Document
>>       'record skip', 'record skip enable' and 'record skip disable'.
>
> Thanks.
>
>> +@kindex record skip
>> +@kindex rec skip
>> +@item record skip
>> +Show the status of record skip.
>> +
>> +@kindex record skip disable
>> +@kindex rec skip disable
>> +@item record skip disable @r{[}id@r{]}
>> +Disable the specified record skip entry (or all record skip entries).
>
> What is a ``record skip entry''?  Without explaining that, this text
> is not helpful.
>

Hi Eli,

I make a new patch that have some introduction about record skip entry.
What do you think about it?

Thanks,
Hui

---
doc/gdb.texinfo | 21 +++++++++++++++++++++
1 file changed, 21 insertions(+)

--- a/doc/gdb.texinfo
+++ b/doc/gdb.texinfo
@@ -5190,6 +5190,27 @@ When record target runs in replay mode (
subsequent execution log and begin to record a new execution log starting
from the current address. This means you will abandon the previously
recorded ``future'' and begin recording a new ``future''.
+
+@kindex record skip
+@kindex rec skip
+@item record skip
+The record skip entry is a special breakpoint. When the process
+record and replay target start, it will be inserted to the
+begin of a function. When this breakpoint break the inferior and
+@value{GDBN} is in record mode, @value{GDBN} will skip record all
+the execution log of this function's instructions and record the
+change of memory and registers of this function as one instruction.
+Show the status of record skip.
+
+@kindex record skip disable
+@kindex rec skip disable
+@item record skip disable @r{[}id@r{]}
+Disable the specified record skip entry (or all record skip entries).
+
+@kindex record skip enable
+@kindex rec skip enable
+@item record skip enable @r{[}id@r{]}
+Enable the specified record skip entry (or all record skip entries).
@end table