suzanne.soy/racket
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Improve introductory prose of ports to avoid confusing use of the term 'stream'.

Browse Source 
Addresses PR 13718.
This commit is contained in:
Danny Yoo 2013-04-29 14:46:32 -06:00
parent 16d3ad7fe5
commit 08dc0e10d9
1 changed files with 11 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
collects/scribblings/guide/io.scrbl
View File

@ -16,11 +16,17 @@
@title[#:tag "i/o" #:style 'toc]{Input and Output}
A Racket @deftech{port} represents an input or output stream, such as
a file, a terminal, a TCP connection, or an in-memory string. More
specifically, an @defterm{input port} represents a stream from which a
program can read data, and an @defterm{output port} represents a
stream for writing data.
@margin-note{A Racket port corresponds to the Unix notion of a stream
(not to be confused with @racketmodname[racket/stream]'s streams).}
A Racket @deftech{port} represents a source or sink of data, such as a
file, a terminal, a TCP connection, or an in-memory string. Ports
provide sequential access in which data can be read or written a piece
of a time, without requiring the data to be consumed or produced all
at once. More specifically, an @defterm{input port} represents a
source from which a program can read data, and an @defterm{output
port} represents a sink to which a program can write data.
@local-table-of-contents[]