From: Christian Brabandt <cb@256bit.org>
Date: Tue, 23 Dec 2025 21:58:57 +0000 (+0000)
Subject: runtime(doc): Improve :catch documentation
X-Git-Tag: v9.1.2018~3
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=6d211bc4f0f4bd9b7ab3b1444f2786b723d04ac0;p=thirdparty%2Fvim.git

runtime(doc): Improve :catch documentation

fixes: #18984

Signed-off-by: Christian Brabandt <cb@256bit.org>
---

diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt
index 7c853795ee..8a252b63db 100644
--- a/runtime/doc/eval.txt
+++ b/runtime/doc/eval.txt
@@ -1,4 +1,4 @@
-*eval.txt*	For Vim version 9.1.  Last change: 2025 Dec 21
+*eval.txt*	For Vim version 9.1.  Last change: 2025 Dec 23
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -3718,12 +3718,15 @@ text...
 			matching {pattern} is being thrown and has not yet
 			been caught by a previous `:catch`.  Otherwise, these
 			commands are skipped.
-			When {pattern} is omitted all errors are caught.
-			Examples: >
+			Pattern can start with "Vim({cmd})" to indicate an
+			exception that occurred when executing the Ex command
+			{cmd}.  When {pattern} is omitted all errors are
+			caught. Examples: >
 		:catch /^Vim:Interrupt$/	 " catch interrupts (CTRL-C)
 		:catch /^Vim\%((\a\+)\)\=:E/	 " catch all Vim errors
 		:catch /^Vim\%((\a\+)\)\=:/	 " catch errors and interrupts
 		:catch /^Vim(write):/		 " catch all errors in :write
+		:catch /^Vim(!):/		 " catch all errors in :!
 		:catch /^Vim\%((\a\+)\)\=:E123:/ " catch error E123
 		:catch /my-exception/		 " catch user exception
 		:catch /.*/			 " catch everything