diff options
-rw-r--r-- | NEWS | 7 | ||||
-rw-r--r-- | doc/manual.xhtml | 13 |
2 files changed, 17 insertions, 3 deletions
@@ -9,6 +9,13 @@ Version 2.4.0 Section 15.2, "Persistent Class Template Instantiations" in the ODB manual. + * Besides odb::stderr_tracer there is now odb::stderr_full_tracer that + traces statement preparations and deallocations in addition to their + executions. This new implementation can be useful when you want to + see text of a statement that contains a syntax error and therefore + will not actually be executed. For more information, refer to Section + 3.13, "Tracing SQL Statement Execution" in the ODB manual. + * User-supplied prologues and epilogues are now generated outside the pre.hxx/post.hxx includes. This allows the use of precompiled headers with the generated files. diff --git a/doc/manual.xhtml b/doc/manual.xhtml index 6a12f57..13203f0 100644 --- a/doc/manual.xhtml +++ b/doc/manual.xhtml @@ -4139,9 +4139,16 @@ t.commit (); <p>The <code>odb::tracer</code> class defines a callback interface that can be used to create custom tracer implementations. The - <code>odb::stderr_tracer</code> is a built-in tracer implementation - provided by the ODB runtime. It prints each executed SQL statement - to the standard error stream.</p> + <code>odb::stderr_tracer</code> and <code>odb::stderr_full_tracer</code> + are built-in tracer implementations provided by the ODB runtime. + They both print SQL statements being executed to the standard error + stream. The full tracer, in addition to tracing statement executions, + also traces their preparations and deallocations. One situation where + the full tracer can be particularly useful is if a statement (for + example a custom query) contains a syntax error. In this case the + error will be detected during preparation and, as a result, the + statement will never be executed. The only way to see such a statement + is by using the full tracing.</p> <p>The <code>odb::tracer</code> class is defined in the <code><odb/tracer.hxx></code> header file which you will need to |