seedterminal

A reckoner seed: the console builtins (machines/seeds/seedterminal.shoddy)

Summary

seedterminal bridges the console builtins into the reckoner, Shoddy’s stack calculator (terminal documents them). A seed is a short file that registers words with the reckoner, and this one registers PRINT, and only PRINT. The other three console builtins read: Input and InputLine wait for a typed line, and InKey wants raw keys. All of them belong to whatever shell owns the session’s input. A dictionary word that read the console would compete with that shell for it. Writing has no such conflict: every shell already prints what a turn answers, and PRINT prints a little sooner.

Why It's Useful

The dictionary’s loops (TIMES, MAP, FILTER, FOLD) run inside one line. The stack’s own display arrives only when that line finishes. PRINT writes the session’s output stream the moment it runs, so a looping program can report each pass as it happens. PRINT touches the world, and that is its whole point. What was printed cannot be UNDOne, exactly as a written file cannot.

Strings print bare: "loop pass 3" PRINT says loop pass 3, no quotes. That is because PRINT’s job is a report line, not a stack picture. Everything else prints as the stack would show it, at standard precision. The display format (FIX and friends) lives in the session state, and a touch word (one that changes the world outside the stack) is handed cells, not the state.

User's Guide

Let st0 = RckSeedTerminal(RckNew())
RckEval(st0, "42 PRINT")               ' prints 42, leaves the stack empty
RckEval(st0, "\"pass\" PRINT")         ' prints pass — bare, no quotes
RckEval(st0, "1 { DUP PRINT 2 * } 5 TIMES")   ' one line per doubling, as it runs

Word Reference

Word	Description
PRINT ( x -- )	Print x on the session's output, immediately: strings bare, everything else as the stack shows it, at standard precision.

Who Uses It

	User	How
	halifax	The calculator's report line: `PRINT`, live from inside a loop.
	sparky	Sparky folds it too, and `PRINT` is why a turn's answer keeps what was printed apart from what the line said.

A mill (a complete Shoddy program) claims this seed by folding RckSeedTerminal over its reckoner state. That is all halifax does.

The Machines It Uses

	Machine	Why
	cuttle	The `Cell` type `PRINT` reads, and `CutShow` for its rendering.
	reckoner	`RckReg` and `RckSeeding`, the registration the word arrives through.

The printing itself is the runtime’s Print builtin. terminal is its documentation, and no machine is included for it.