Expand the documentation of the low-level tracing/profiling interface.

This reflects what is currently in CVS, which may change before 2.2 is final.