Index: bgerror.n
===================================================================
RCS file: /cvsroot/tcl/tcl/doc/bgerror.n,v
retrieving revision 1.4
diff -u -r1.4 bgerror.n
--- bgerror.n	7 Sep 2000 14:27:45 -0000	1.4
+++ bgerror.n	21 Apr 2004 17:37:18 -0000
@@ -71,6 +71,23 @@
 command when it is evaluated.  If either of these options is set to
 the empty string, then the additional button will not be displayed in
 the dialog.
+.PP
+If you are writing code that will be used by others, consider avoiding
+\fBbgerror\fR.  The reason for this is that the end user may also want
+to define a \fBbgerror\fR, or use other code that does and thus will
+have trouble integrating your code.
+
+.SH "EXAMPLE"
+
+This bgerror procedure appends errors to a file, with a timestamp.
+
+.CS
+proc bgerror { message } {
+    set fl [open mylog.txt a]
+    puts $fl "[clock format [clock seconds]] bgerror in $::argv '$message'"
+    close $fl
+}
+.CE
 
 .SH "SEE ALSO"
 after(n), tclvars(n)
