Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 5 additions & 4 deletions doc/ref/chap-builtin-cmd.md
Original file line number Diff line number Diff line change
Expand Up @@ -444,19 +444,20 @@ recommended:

---

This flag replaces shell's `IFS= read -r` idiom, reading one byte a time in an
unbuffered fashion:
This flag still reads one byte a time in an unbuffered fashion, like shell's
`IFS= read -r` idiom, but does not error upon input- or file-ending (EOF):

read --raw-line # unbuffered read of line, omitting trailing \n
read --raw-line (&x) # fills $x

read --raw-line --with-eol # include the trailing \n
read --raw-line --with-eol # include trailing \n if present

A loop over [io.stdin][] allows buffered reading of lines, which is faster.

[io.stdin]: chap-type-method.html#stdin

You may want to use `fromJson8()` or `fromJson()` after reading a line.
You may want to use `fromJson8()` or `fromJson()` after reading a line, or a
command splice `@(...)` to read and assign an entire list of Json-lines.

---

Expand Down