From 32a2ca6eff20b77039e30aa2e87ce772a53c9c70 Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Sat, 16 May 2015 15:04:32 -0600 Subject: [PATCH] doc clarification on output functions and mutable arguments --- .../racket-doc/scribblings/reference/string-output.scrbl | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/pkgs/racket-doc/scribblings/reference/string-output.scrbl b/pkgs/racket-doc/scribblings/reference/string-output.scrbl index 170423241a..c795be654a 100644 --- a/pkgs/racket-doc/scribblings/reference/string-output.scrbl +++ b/pkgs/racket-doc/scribblings/reference/string-output.scrbl @@ -33,7 +33,14 @@ if @racket[start-pos] or @racket[end-pos] is out-of-range for @racket[str]. The result is the number of characters written to @racket[out], which -is always @racket[(- end-pos start-pos)].} +is always @racket[(- end-pos start-pos)]. + +If @racket[str] is mutable, mutations after @racket[write-string] +returns do not affect the characters written to @racket[out]. (This +independence from mutation is not a special property of +@racket[write-string], but instead generally true of output +functions.)} + @defproc[(write-bytes [bstr bytes?] [out output-port? (current-output-port)]