# $EPIC: bind_send_line.txt,v 1.4 2006/10/01 23:54:18 jnelson Exp $
======Synopsis:======
[[bind]] <key> send_line

======Description:======
This operation submits the contents of the input line for processing.
This is the ordinary operation of the <enter> key.

Usually the input buffer contains either a line of text, which is sent to
to the current window's current target, or a command, which is executed in
the context of the current window.

However, if there is a modal prompt (usually caused by the [[input]] command),
then the contents of the input buffer are sent to that prompt's callback.

======Other side effects:======
  - The input line is cleared
  - If the window's hold mode is ON, and you're not holding, then the current output is considered "acknowledged"
  - If there is a modal prompt, that modal prompt's callback is run
  - Otherwise, [[on input]] is hooked
  - If [[on input]] is not grabbed, the input line is parsed as with the [[sendline]] command.
  - If the window's hold mode is ON, and you are holding, then the screen is unheld.
  - If the window's hold mode is ON, and you are holding, and you are also scrolling back, then a [[bind scroll_forwards]] is done.  This allows you to hit <enter> to catch up.

======History:======
This keybinding first appeared in ircII.