Documentation Unhelpful help

[djspits]

I do not understand the folowing help-tekst:

In the topic
_CMDLINE
the phrase
" ... it returns the contents of the command line with the %_cmdline name removed."

With what removed?


An example would help.

 

[rconn]

The %_cmdline variable is expanded to the contents of the current command line (not including "%_cmdline"), and %_cmdline is removed. So:

echo one two three %_cmdline

returns

one two three echo one two three

 

[djspits]

It would be helpful (to me at least) if I was shown an example that actualy communicated something about its intended use.

 

[rconn]

It's intended to be used for key aliases, when you want the alias behavior to be dependent on the current contents of the command line. (For example, if you were writing something like a tab filename completion routine.)

If you're not writing key aliases, it's unlikely that %_cmdline is going to be of any use to you.