]> git.ipfire.org Git - thirdparty/vim.git/commit
runtime(doc): cross-link :| meaning :p and explain E749
authorD. Ben Knoble <ben.knoble+github@gmail.com>
Mon, 21 Apr 2025 08:19:51 +0000 (10:19 +0200)
committerChristian Brabandt <cb@256bit.org>
Mon, 21 Apr 2025 08:20:36 +0000 (10:20 +0200)
commit187df69fd1563535773b8ddb2de1b0f5dd3dd2e9
treed4ae9349f25cf5e244ba6b77ebc1df030d0f22f4
parentf39de60608c5bf2106ad6ce08b8dbe03b271e3ff
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+github@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
runtime/doc/various.txt