Re: [vile] How to insert text in a macro

[Chris Green]

On Mon, Oct 12, 2015 at 06:51:06AM -0400, Thomas Dickey wrote:
> | 
> | It's sometimes rather difficult to tell from the documentation what
> | something will do.  open-line-above-and-insert-chars switches
> 
> It might be nice if open-line-above-... would accept a sort of here-document.
> (I seem to recall that being suggested a while back).  There's no clean way
> that I can see to have the text be on the same line.
> 
> | vile to insert mode whereas insert-string takes a string parameter to
> | insert.  Is there anywhere that would tell me this (apart from trying
> | them or finding examples which is how I found insert-string, there's
> | an example that uses it in the main help).
> | 
> 
> I usually start with :describe-bindings, and look for relevant words.
> 
Yes, but having found, say, open-line-above-and-insert-chars and
insert-string how do I tell that open-line-above-and-insert-chars
switches vile into insert mode and insert-string doesn't?

The description of insert-string is:-
    insert (CNT copies of) the given string at the cursor

... and of open-line-above-and-insert-chars is:-
    insert text in CNT fresh blank line(s), before current line

It's not immediately obvious the the first takes a string parameter
whereas the second puts you into insert mode.

-- 
Chris Green