From 0680be67c7d22d9b58fd8c309bb24f537cf717b5 Mon Sep 17 00:00:00 2001
From: mdw <mdw>
Date: Sat, 3 Feb 2001 16:28:45 +0000
Subject: [PATCH] Describe custom interface.

---
 man/trace.3 | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/man/trace.3 b/man/trace.3
index 68d87ad..1312b19 100644
--- a/man/trace.3
+++ b/man/trace.3
@@ -5,6 +5,7 @@ trace \- configurable tracing output
 .\" @trace
 .\" @trace_block
 .\" @trace_on
+.\" @trace_custom
 .\" @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 "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 "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... )
@@ -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.
+.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
-- 
2.11.0