runtime(openPlugin): Add URLOpen to not expand special chars

closes: #17424

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

diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt
index 170d2d0377f1b3752bd80acd88fab64b40ed8f57..492a4444af9961bfa783573f570fc30d10f070fc 100644 (file)
--- a/runtime/doc/eval.txt
+++ b/runtime/doc/eval.txt
@@ -1,4 +1,4 @@
-*eval.txt*     For Vim version 9.1.  Last change: 2025 Apr 02
+*eval.txt*     For Vim version 9.1.  Last change: 2025 Jun 04
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -5149,6 +5149,10 @@ executable.  It takes the following arguments:
        filetype        string
        executable      string
 
+                                                       *package-open*
+The |:Open| and |:Launch| command are provided by the included plugin
+$VIMRUNTIME/plugin/openPlugin.vim
+
                                        *dist#vim9#Open()* *:Open* *:URLOpen*
                                                      *g:Openprg* *gx*
 dist#vim9#Open(file: string) ~
@@ -5159,6 +5163,9 @@ string specified in the variable is used instead.
 
 The |:Open| user command uses file completion for its argument.
 
+The |:URLOpen| user command works the same but does not perform file
+completion and therefore does not expand special characters |cmdline-special|.
+
 This function is by default called using the gx mapping.  In visual mode
 tries to open the visually selected text.
 
@@ -5176,11 +5183,8 @@ NOTE: Escaping of the path is automatically applied.
 Usage: >vim
        :call dist#vim9#Open(<path>)
        :Open <path>
+       :URLOpen <path>
 <
-                                                       *package-open*
-The |:Open| and |:Launch| command are provided by the included plugin
-$VIMRUNTIME/plugin/openPlugin.vim
-
                                                *dist#vim9#Launch()* *:Launch*
 dist#vim9#Launch(file: string) ~
 

diff --git a/runtime/plugin/openPlugin.vim b/runtime/plugin/openPlugin.vim
index 09f5ad2c43fc99e05baa7131af569c6875db6d50..8e0ae4b9927ea7c32855df8e8828edc53ff367b0 100644 (file)
--- a/runtime/plugin/openPlugin.vim
+++ b/runtime/plugin/openPlugin.vim
@@ -17,6 +17,9 @@ command -complete=shellcmd -nargs=1 Launch vim9.Launch(trim(<q-args>))
 # technically, -nargs=1 is correct, but this throws E480: No match 
 # when the argument contains a wildchar on Windows
 command -complete=file -nargs=* Open vim9.Open(trim(<q-args>))
+# Use URLOpen when you don't want completion to happen
+# (or because you want to avoid cmdline-special)
+command -nargs=1 URLOpen vim9.Open(trim(<q-args>))
 
 const no_gx = get(g:, "nogx", get(g:, "netrw_nogx", false))
 if !no_gx