[ANN] Understanding Vim's excalamation mark command quoting/escaping rules

[Daniel Shahaf]

Shlomi Fish wrote on Fri, Apr 01, 2016 at 15:38:42 +0300:
> Hi Daniel,
> 
> thanks for your reply,
> 

You're welcome.

> On Fri, Apr 1, 2016 at 9:03 AM, Daniel Shahaf <d.s-dgTty7X8ZFiCCAfzKLUKrUEMvNT87kid at public.gmane.org>
> wrote:
> 
> > Shlomi Fish wrote on Thu, Mar 31, 2016 at 22:56:28 +0300:
> > > I prepared a document where I investigated which characters need to be
> > > escaped in vim's ":!" commands of filtering the text through a shell
> > > command.
> >
> > The escape rules are documented:
> >
> >     :help cmdline-special
> >
> >
> I see - thanks. I was unable to find them in:
> 
> 1. vim's help.
> 

I found it by doing:

    :help c_%

to find the place where the s/%/current buffer's name/ transformation is
documented, and then scrolling up to the enclosing section's header.

That relied on knowing the tagname convention documented in :h help-context.

> 2. DuckDuckGo search.
> 
> 3. Google search.
> 
> 4. asking on freenode's #vim chatroom.
> 
> and the text there seems somewhat confusing.
> 

You might want to take the unclarity of the help text with vim upstream,
then.  (I.e., to file a docs bug)

Cheers,

Daniel