1.163.3 Send methods

terminal_block ->initialise: terminal=terminal_image

Create a block on a terminal. Blocks are made by the terminal as the marks arrive; there is normally no reason to make one.

terminal_block ->select: what=[{command,output,all}]

Make the block the selection of its terminal. command is the line the user entered, output (the default) what it printed, and all both with the prompt in front.

terminal_block ->copy: what=[{command,output,all}], which=[{primary,clipboard}]

Put the text of the block on the clipboard. It goes by terminal_block<-content rather than by the region of the screen the block covers, so a copy of the command is what was typed: without the return that entered it, and without the continuation prompts the client drew down the left of a command it collected over several lines. all keeps them, being what the window shows. Lines are separated by a single newline, as terminal_block<-content separates them, and not by the \r\n of terminal_image<-selected: what is copied here is a command to be read back, not a region of the screen. Does not disturb the selection; terminal_block->select is for that.

terminal_block ->scroll_to:

Scroll the prompt of the block into view, opening a fold that hides it.

terminal_block ->remove:

Take the command out of the buffer altogether: the lines it covers go and the text under them moves up into the gap. The block is dropped from terminal_block<-blocks with its terminal_block<-terminal set to @nil. There is no undo.

The buffer gets shorter at the end the client is writing to, so the older history is left where it is. Everything that names a line by its place in the scrollback is moved with the text: the caret, the window and the marks of every other command. The selection and a running incremental search are ended rather than followed, since what they were on may be what is going.

Fails for a command still running, for one whose output has not been marked as ended, and while an application holds the alternate screen.

terminal_block ->fold:

terminal_block ->unfold:

terminal_block ->toggle_fold:

Hide the output of the command, show it again, or the one or the other. Wrappers over terminal_block->folded.