[racket] Racket Doc / Places

[Ray Racine]

"If the output ports are file-stream ports, then the connected ports in the places share the underlying stream, otherwise a thread in the creating place pumps bytes to the current ports in the creating place."

Should that be "..., otherwise a thread in the created place pumps bytes to the current ports in the creating place." ??

[Kevin Tew]

On 11/05/2012 08:23 AM, Ray Racine wrote:

"If the output ports are file-stream ports, then the connected ports in the places share the underlying stream, otherwise a thread in the creating place pumps bytes to the current ports in the creating place."

Should that be "..., otherwise a thread in the created place pumps bytes to the current ports in the creating place." ??

____________________
  Racket Users list:
  http://lists.racket-lang.org/users

No I think its right.

I've added some extra text in CAPS to clarify things.
I'll make some improvements to the docs as well.

Kevin

"If the CREATING PLACE'S output ports are file-stream ports, then the connected ports in CREATED places share the underlying streams, otherwise a thread in the creating place pumps bytes FROM THE CREATED PLACE PORTS to the current ports in the creating place."

[Kevin Tew]

Here is the documentation patch I came up with.

diff --git a/collects/scribblings/reference/places.scrbl b/collects/scribblings/reference/places.scrbl
index 114fc8a..273fb4e 100644
--- a/collects/scribblings/reference/places.scrbl
+++ b/collects/scribblings/reference/places.scrbl
@@ -141,14 +141,15 @@ are simulated using @racket[thread].}
  @racket[start-proc] returns, then the place terminates with the
  @tech{completion value} @racket[0].
 
- In the created place, the @racket[current-input-port] parameter
- is set to an empty input port, while the values of the
+ In the created place, the @racket[current-input-port] parameter is
+ set to an empty input port, while the values of the
  @racket[current-output-port] and @racket[current-error-port]
- parameters are connected to the current ports in the creating
- place. If the output ports are @tech{file-stream ports}, then the
- connected ports in the places share the underlying stream, otherwise
- a @tech{thread} in the creating place pumps bytes to the current
- ports in the creating place.
+ parameters are connected to the current ports in the creating place.
+ If the output ports in the creating place are @tech{file-stream
+ ports}, then the connected ports in the created place share the
+ underlying streams, otherwise a @tech{thread} in the creating place
+ pumps bytes from the created place's ports to the current ports in the
+ creating place.
 
  The @racket[module-path] argument must not be a module path of the
  form @racket[(#,(racket quote) _sym)] unless the module is predefined (see