Documentation
¶
Overview ¶
Command run runs something and shows what it said, in colour.
This is the shape of a program that drives other programs. Three things are worth looking at, and none of them is the running:
The output arrives coloured, and stays coloured. A command writes escape sequences to say what it means — a failing test in red, a path underlined — and a decoder reads them back into styled text, a chunk at a time, because output does not arrive on line boundaries and a sequence can be split down the middle.
What is finished belongs to the terminal. Every line the decoder completes is printed into the terminal's own scrollback, where it can be scrolled back to, selected, and found after this program exits. The live block at the bottom is the only part this program still owns.
The terminal can be given away. Ctrl+E opens $EDITOR and takes the terminal back when it exits; Ctrl+Z stops this process the way a shell does. Both put the terminal back exactly as it was found, and both take it back the same way.
go run ./run -- go version
Source Files