Add an option to trap context errors in a debugger

1 files changed, 8 insertions, 0 deletions

diff --git a/alsoftrc.sample b/alsoftrc.sample
index 1f749f69..baf0930b 100644
--- a/alsoftrc.sample
+++ b/alsoftrc.sample
@@ -150,6 +150,14 @@
 #layout_61CHN  = fl=-30, fr=30, fc=0, sl=-90, sr=90, bc=180
 #layout_71CHN  = fl=-30, fr=30, fc=0, sl=-90, sr=90, bl=-150, br=150
 
+## trap-al-error:
+#  Generates a SIGTRAP signal when an AL context error is generated, on systems
+#  that support it. This helps when debugging, while trying to find the cause
+#  of a context error. On Windows, a breakpoint exception is generated.
+#  Optionally, the __ALSOFT_TRAP_AL_ERROR env var may be set before running the
+#  app instead.
+#trap-al-error = false
+
 ##
 ## Reverb effect stuff (includes EAX reverb)
 ##