ludic/docs/language/process/process-free.md
Orkuncakilkaya 43d5eb5b88 feat(launcher): Process.*, Http.save_to/received/expected, App.window_hide/show
Process.spawn/poll/kill/free - non-blocking child processes with no shell: posix_spawn on
macOS (process.ll), CreateProcessW with MSVC-quoted arguments and no console window on
Windows (process_win.ll), linked only when a program uses Process.*.

Http.save_to streams a response body into a file (NSURLSession with a run-time delegate
class on macOS, the WinHTTP read loop on Windows); Http.received / Http.expected report
progress while it is pending. Freeing a pending request cancels it and parks the slot
until the worker has finished.

App.window_hide / App.window_show take the game's window off the screen and back without
closing it; the run goes on while hidden. Docs, examples, tests and a changeset.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 13:32:23 +03:00

768 B

id name category kind tokens sig tip order ns member
process-free Process.free process namespace-method Process.free Process.free(handle) -> void Let a process handle go. 3 Process free

Releases the handle so it can be reused. It does not stop a child that is still running — use Process.kill first for that; such a child keeps running and is reaped by the runtime when it ends, so it never lingers as a zombie. After free, polling the old handle answers 255.

program Demo {
  entry {
    let h = Process.spawn("/bin/sh", ["-c", "exit 0"])
    var code = Process.poll(h)
    while code == -1 { code = Process.poll(h) }
    Process.free(h)
  }
}