Logging Information

Some things are routinely logged, regardless of whether we plan to generate any code for them.

The following things are logged when entering a method (that is, the capture method is called as a preamble).

• Method name

• Class and oid of the receiver

• Name of the class in which the method is defined (it could be a superclass of the receiver)

• Any parameters of the method, including their type and value

The following things are logged when leaving a method (that is, the capture method is called as a postamble).

• Method name

• Name of the class in which the method is defined (it could be a superclass of the receiver)

• Return value (type and value)

In addition, extra information is logged, based on the type of the receiver; for example:

• For all controls, show the parent, index, and persistentObject

• For tables, show the row, column, inputType, and so on

• For folders, show the top sheet

• For buttons, show the caption

• Show bubble help, if it is not null

Nested method calls are shown with indentation.

This diagnostic information can help when trying to determine if something else needs replay code generated for it. It can also help identify what happened and when, including in situations when you cannot remember what you did while recording. The rrmsg.log is therefore invaluable when resolving problems.