From a8e9077a4c709c0ec478c7846df28d7eb4f34f32 Mon Sep 17 00:00:00 2001
From: Harri Lainio <harri.lainio@iki.fi>
Date: Sun, 18 Feb 2024 19:20:20 +0200
Subject: [PATCH] multiple error handlers documentation to Handle/Catch

---
 err2.go | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/err2.go b/err2.go
index 9c7729a..8ba5a95 100644
--- a/err2.go
+++ b/err2.go
@@ -74,6 +74,13 @@ var (
 //		return err
 //	})
 //
+// You can have unlimited amount of error handlers. They are called if error
+// happens and they are called in the same order as they are given or until one
+// of them resets the error like Reset (notice other predefined error handlers)
+// in next sample:
+//
+//	defer err2.Handle(err2.Noop, err2.Reset, err2.Log) // err2.Log not called!
+//
 // If you need to stop general panics in handler, you can do that by giving a
 // panic handler function:
 //
@@ -131,7 +138,8 @@ func Handle(err *error, a ...any) {
 // error handling function, i.e., err2.Handler. By returning nil resets the
 // error, which allows e.g. prevent automatic error logs to happening.
 // Otherwise, the output results depends on the current Tracer and assert
-// settings. Default setting print call stacks for panics but not for errors:
+// settings. The default trace setting prints call stacks for panics but not for
+// errors:
 //
 //	defer err2.Catch(func(err error) error { return err} )
 //
@@ -139,8 +147,14 @@ func Handle(err *error, a ...any) {
 //
 //	defer err2.Catch(err2.Noop)
 //
-// The last one calls your error handler, and you have an explicit panic
-// handler too, where you can e.g. continue panicking to propagate it for above
+// You can have unlimited amount of error handlers. They are called if error
+// happens and they are called in the same order as they are given or until one
+// of them resets the error like Reset in next sample:
+//
+//	defer err2.Catch(err2.Noop, err2.Reset, err2.Log) // err2.Log not called!
+//
+// The last one calls your error handler, and you have an explicit panic handler
+// as well, where you can e.g. continue panicking to propagate it for above
 // callers or stop it like below:
 //
 //	defer err2.Catch(func(err error) error { return err }, func(p any) {})