From fd649dbf1223f13ee4fc9ad36ee66e15d1ec096c Mon Sep 17 00:00:00 2001
From: Oliver <480930+rivo@users.noreply.github.com>
Date: Sun, 18 Aug 2024 13:03:01 +0200
Subject: [PATCH] Added a note about standard streams while an application is
 running. Resolves #1017

---
 application.go | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/application.go b/application.go
index bbd15d2..6e6666b 100644
--- a/application.go
+++ b/application.go
@@ -250,7 +250,13 @@ func (a *Application) EnablePaste(enable bool) *Application {
 }
 
 // Run starts the application and thus the event loop. This function returns
-// when Stop() was called.
+// when [Application.Stop] was called.
+//
+// Note that while an application is running, it fully claims stdin, stdout, and
+// stderr. If you use these standard streams, they may not work as expected.
+// Consider stopping the application first or suspending it (using
+// [Application.Suspend]) if you have to interact with the standard streams, for
+// example when needing to print a call stack during a panic.
 func (a *Application) Run() error {
 	var (
 		err, appErr error