command-block limitations about vim

[benknoble]

What should return do? It wouldn’t be valid in a normal command block.

It would probably be nice to support heredocs though.

[chrisbra]

yeah, return is strange. commands are basically nice and simple ways to execute functions. Thus I would argue the desired logic belongs into a function.

[balki]

return does not have to return anything to called. But useful as a control flow to stop the command execution to avoid nesting. Creating a wrapper function is not bad but it is unnecessary boiler plate if the function is called in only once which is in the command definition. I think the behavior should at-least be documented.

[chrisbra]

:return does not make sense in an interactive session (which is basically the same what :com does). I also think there is nothing to document at least not for the :return case.

And btw: you can always negate the condition.

[dkearns]

:help :command-repl states that inline functions cannot be used and :help return is documented as "return from function". The error is "E133: :return not inside a function".

I think it's documented well enough.

I can't see why heredoc assignment shouldn't work though.

[chrisbra]

Yes, let's leave this ticket for the missing heredoc functionality.