Describe custom interface.

diff --git a/man/trace.3 b/man/trace.3
index 68d87ad399d8b8c4c1c7f71872fa4e996101161e..1312b19c89a0c6ed72270adc635d70dabd87cd1e 100644 (file)
--- a/man/trace.3
+++ b/man/trace.3
@@ -5,6 +5,7 @@ trace \- configurable tracing output
 .\" @trace
 .\" @trace_block
 .\" @trace_on
 .\" @trace
 .\" @trace_block
 .\" @trace_on

+.\" @trace_custom

 .\" @trace_level
 .\" @tracing
 .\" @traceopt
 .\" @trace_level
 .\" @tracing
 .\" @traceopt


@@ -20,10 +21,13 @@ trace \- configurable tracing output
 .BI "                 const void *" b ", size_t " sz );
 
 .BI "void trace_on(FILE *" fp ", unsigned " l );
 .BI "                 const void *" b ", size_t " sz );
 
 .BI "void trace_on(FILE *" fp ", unsigned " l );

+.BI "void trace_custom(void (*" func ")(const char *" buf ,
+.BI "                               size_t " sz ", void *" v ),
+.BI "                  void *" v );

 .BI "void trace_level(unsigned " l );
 .BI "unsigned tracing(void);"
 
 .BI "void trace_level(unsigned " l );
 .BI "unsigned tracing(void);"
 

-.BI "unsigned traceopt(trace_opt *" t ", const char *" p ,
+.BI "unsigned traceopt(const trace_opt *" t ", const char *" p ,

 .BI "                  unsigned " f ", unsigned " bad );
 
 .BI T( statements\fR... )
 .BI "                  unsigned " f ", unsigned " bad );
 
 .BI T( statements\fR... )


@@ -72,6 +76,11 @@ which takes the new level as its single argument.  The function
 .B tracing
 returns the current trace level, or zero if there is no trace
 destination set.
 .B tracing
 returns the current trace level, or zero if there is no trace
 destination set.

+.PP
+For more advanced programs, a custom output function may be provided by
+.B trace_custom
+and passing a function which will write a buffer of data somewhere
+sensible.

 .SS "Parsing user trace options"
 The function
 .B traceopt
 .SS "Parsing user trace options"
 The function
 .B traceopt