runtime(doc): cross-link :| meaning :p and explain E749
Commit:
https://github.com/vim/vim/commit/187df69fd1563535773b8ddb2de1b0f5dd3dd2e9
Author: D. Ben Knoble <ben.knoble+git...@gmail.com>
Date: Mon Apr 21 10:19:51 2025 +0200
runtime(doc): cross-link :| meaning :p and explain E749
E749 is given when :print (with any range) is issued on an empty buffer,
like the one you get with :new or :enew. Furthermore, due to Vi
compatibility :| is a synonym.
As a result, mappings intended to include a <bar> separator (esp. in the
case of boolean or "||") between commands can generate E749 on startup
when placed in a vimrc if the bars are not properly encoded or escaped.
[1]. Document this failure mode and synonym near the generated error,
and cross link with :help :bar. Note that one must read or scroll quite
a bit to find the mention of :| behaving like :print!
[1]: https://vi.stackexchange.com/q/46625/10604
closes: #17173
Signed-off-by: D. Ben Knoble <ben.knoble+git...@gmail.com>
Signed-off-by: Christian Brabandt <c...@256bit.org>
diff --git a/runtime/doc/various.txt b/runtime/doc/various.txt
index 6fd4a5f7f..b68c336f3 100644
--- a/runtime/doc/various.txt
+++ b/runtime/doc/various.txt
@@ -1,4 +1,4 @@
-*various.txt* For Vim version 9.1. Last change: 2025 Feb 13
+*various.txt* For Vim version 9.1. Last change: 2025 Apr 21
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -98,7 +98,9 @@ g8 Print the hex values of the bytes used
in the
*:p* *:pr* *:print* *E749*
:[range]p[rint] [flags]
- Print [range] lines (default current line).
+ Print [range] lines (default current line). Can also
+ be spelled `:[range]|` due to Vi compatibility (see
+ |:bar|). Gives an error in an empty buffer.
Note: If you are looking for a way to print your text
on paper see |:hardcopy|. In the GUI you can use the
File.Print menu entry.
--
--
You received this message from the "vim_dev" maillist.
Do not top-post! Type your reply below the text you are replying to.
For more information, visit http://www.vim.org/maillist.php
---
You received this message because you are subscribed to the Google Groups
"vim_dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to vim_dev+unsubscr...@googlegroups.com.
To view this discussion visit
https://groups.google.com/d/msgid/vim_dev/E1u6mXT-00GB2e-LV%40256bit.org.
